Dynapro Technologies Dynapro ET TCS, Application Developer'S Manual

Page: 237 / 337

6-47
(UDVHD7RXFKNH\&RPPDQG^)(7.`5HPRWH
The Erase a Touchkey command is sent by the host to erase the target associated with a specified
touchkey on the display.
Each character that is erased is replaced by a blank (a Space character). The attribute of each
character position in the erased touchkey reverts to off, unless the NOCHANGE Attribute Mode
is set.
The area of the display affected by this command is restricted to lie within the scrolling region
when Origin Mode is set.
Within a touchkey, the host can restrict the effect of this command to one of the areas previously
defined in this chapter under Touchkey Visual Extent.
For the Erase a Touchkey command to produce correct and predictable results, the touchkey’s
line type must be determined. Line type is determined according to the following rules:
•
If the touchkey contains any double-size lines, the entire touchkey is assumed to be
composed of double-size lines.
•
If the touchkey contains any double-width lines, the entire touchkey is assumed to be
composed of double-width lines.
•
If the touchkey does not contain any double-width or double-size lines, the touchkey is
assumed to be composed of all normal lines.
NOTE
Undesirable results may be produced if the Erase a Touchkey command is executed on a touchkey that
contains mixed line types.
If the touchkey specified in this command designates a touch cell within a touchkey (but not the
master cell), then the characters are erased within that touch cell rather than the entire touchkey.
23(5$72586$*(
None. (This is a remote command only.)
+26786$*(
<ESC>[8;<Pk>;<Pv>u
<Pk> is a numeric parameter that specifies which touchkey is to be erased.
If <Pk> is 0 or omitted, the entire screen is erased.
<Pv> is a selective parameter that specifies the visual extent of the touchkey to be erased.
If <Pv> is 0 or omitted, all characters in the touchkey are erased.
If <Pv> is 1, the only inner characters are erased.
If <Pv> is 2, the only border characters are erased.
If <Pv> is 3, all characters in the touchkey are erased.