Dynapro Technologies Dynapro ET TCS, Application Developer'S Manual

Page: 228 / 337

6-38
5HYHUVH&KDUDFWHU$WWULEXWHVLQD7RXFKNH\&RPPDQG^)5&$,7.`5HPRWH
The Reverse Character Attributes in a Touchkey command allows the host to quickly change the
character attributes within a touchkey.
The attributes to be changed with this command are specified within the command. One or more
attributes can be changed at a time. All the attributes specified in this command are reversed
from their current setting for each of the characters within the touchkey. The characters
appearing within the touchkey are not changed; only their displayed attributes are updated. The
character attributes in use as last set by the Set Character Attributes Command are never changed
by this command.
This command relieves the host of having to keep track of the current attributes within a
touchkey. For example, if the host detects a touchkey being pressed and wants to highlight the
characters within the touchkey, this command can be used. Every time the host detects the
touchkey being pressed, it can send this command to reverse the touchkey’s attributes. In this
case, the host does not have to remember whether the touchkey had a particular attribute on or
off; it just knows that it wants to reverse the attribute from its previous state.
Because the Reverse Character Attributes in a Touchkey command directly causes attributes to
be modified, the NOCHANGE Attribute Mode has no effect on this command.
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 Reverse Character Attributes in 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 Reverse Character Attributes in 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 attributes are reversed within that touch cell rather than the entire touchkey.
23(5$72586$*(
None. (This is a remote command only.)