Dynapro Technologies Dynapro ET TCS, Application Developer'S Manual

Page: 197 / 337

6-7
%XLOG7RXFKNH\&RPPDQG^)%7.`5HPRWH
The Build Touchkey command groups touch cells together into a single rectangular touchkey.
Building touchkeys provides an easy way to handle larger portions of the touch panel as single
touch-sensitive areas, and eliminates the programming overhead associated with translating and
handling individual touch cells.
The built touchkey takes on the attributes and reporting identification of the touch cell in its
upper left corner (the master cell). If any touch cell is touched within the touchkey, the entire
touchkey responds with the attributes programmed for the master cell (ignoring the individual
attributes of the touch cell pressed), including generating a touch report with the master cell’s
number.
Once a touchkey is built, the host refers to it solely by its master cell number. The touchkey acts
as a single unit until a Clear Touchkey command is issued. Any modification of the attributes of
touch cells (other than the master cell) within the touchkey has no effect on operation of the
touchkey. Only the master cell attributes affect operation of the touchkey.
After a Clear Touchkey command is issued, the touch cells that made it up revert to operating in
a manner consistent with their individual attributes as last programmed by the host. This
programming of individual touch cells could even have occurred while the touch cells were part
of the larger touchkey.
Any commands that can be applied to individual touch cells can also be applied to touchkeys. As
far as the host is concerned, there is no operational distinction made between touch cells and
touchkeys except for their potential size differences.
23(5$72586$*(
None. (This is a remote command only.)
+26786$*(
<ESC>[5;<Pk>;<Ph>;<Pw>u
<Pk> is a numeric parameter that specifies the master cell within the touchkey to be built
(the upper left touch cell).
If <Pk> is omitted or 0, clears all touchkeys.
<Ph> is a numeric parameter that specifies the height of the touchkey in touch cell units.
If <Ph> is 0 or omitted, height is l.
If <Ph> is greater than 12, height is 12.
<Pw> is a numeric parameter that specifies the width of the touchkey in touch cell units.
If <Pw> is 0 or omitted, width is l.
If <Pw> is greater than 10, width is 10.
CAUTION
Issuing a Build Touchkey command with all parameters set to zero or with all parameters missing constitutes a Clear
Touchkey command, and will CLEAR ALL TOUCHKEYS. Refer to the Clear Touchkey command for details.