Dynapro Technologies Dynapro ET TCS, Application Developer'S Manual

Page: 233 / 337

6-43
)LOOD7RXFKNH\:LWKD&KDUDFWHU&RPPDQG^))7.&`5HPRWH
The Fill a Touchkey With a Character command allows the host to easily fill a touchkey with a
character. The character specified in this command will be repeatedly displayed in each character
position throughout the visual extent of the touchkey that the host specifies. This command
allows a touchkey to be filled with any one of the 256 characters from the Standard and Extended
Character Sets.
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 Fill a Touchkey With a Character 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 Fill a Touchkey With a Character 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 filled within that touch cell rather than the entire touchkey.
23(5$72586$*(
None. (This is a remote command only.)
+26786$*(
<ESC>[3;<Pk>;<Pv>;<Pch>x
<Pk> is a numeric parameter that specifies which touchkey is to be filled.
If <Pk> is 0 or omitted, the entire screen is filled using the visual extent specified.
<Pv> is a selective parameter that specifies the visual extent of the touchkey to be filled.
If <Pv> is 0 or omitted, all of the touchkey is filled.
If <Pv> is 1, the only inner portion of the touchkey is filled.
If <Pv> is 2, the only border of the touchkey is filled.
If <Pv> is 3, all the touchkey is filled.