Dynapro Technologies Dynapro ET TCS, Application Developer'S Manual

Page: 202 / 337

6-12
7RXFKNH\9LVXDO([WHQW&RPPDQG^)7.9(-`5HPRWH
The Touchkey Visual Extent command specifies the portion of a touchkey that automatically
responds visually when activated by the user. Each visual extent can take on one of the following
values:
•
Border: The border is the portion of the touchkey composed only of the character cells on
the perimeter of the physical boundaries of the touchkey. This area appears as an unfilled
rectangle, except in the case of a single-height touchkey. A single-height touchkey is only
two characters high, so the entire touchkey contents are the border.
•
Inner: The inner part of a touchkey is the entire area within the physical boundaries of the
touchkey except for the border. This area appears as a solid rectangle. Since a single-height
touchkey is only two characters high, the entire touchkey is the inner portion.
•
All: The entire area within the physical boundaries of the touchkey, including both the
border and inner areas.
•
None: None of the character cells within the physical boundaries of the touchkey responds
visually when activated.
The automatic visual response interacts with the touchkey types as follows:
•
Dead: There is no automatic visual response, regardless of the visual extent value.
•
Press: The area of the touchkey specified by the visual extent reverses its video and stays
reversed until the touchkey is released.
•
Auto-repeat: The area of the touchkey specified by the visual extent reverses its video and
stays reversed until the touchkey is released.
•
Toggle: The area of the touchkey specified by the visual extent reverses its video when the
touchkey is pressed and a touch report is sent to the host. The touchkey stays reversed until
the touchkey is pressed again and another touch report is sent to the host. Each time the
touchkey is pressed and a touch report is sent to the host, the touchkey alternates its visual
state. When the touchkey is in the off state, the area of the touchkey specified by the visual
extent appears as set by the host. When the touchkey is in the on state, the area of the
touchkey specified by the visual extent appears in reverse video from that set by the host.
The automatic visual response is intimately tied to the touch report sent to the host. If the TCS
output buffer is so full that a touch report cannot be sent to the host, automatic visual response
does not occur. An automatic visual response occurs only when a touch report fits in the output
buffer and will eventually be sent to the host. This guarantees the user is given immediate
feedback only when the host is guaranteed to be notified of the change in the state of the
touchkey.
'()$8/7
The visual extents of all touchkeys are set to none.