User guide

P/N: 021-00154, Rev. A.6 - updated for V4.7 Tools Page | 114
The variables you use when displaying a screen are named:
GD.screen
GD.v1, .... GD.v24
GD.portrait A value of 1 = landscape, 2 = landscape rotated 180 degrees,
3 = portrait, 4 = portrait rotated 180 degrees. Zero the default = landscape.
GD.alarm This variable must be set first to true and then to false for each alarm
beep and be about 250ms apart. Here is example alarm code:
dim alarmtimer as timer
if (alarmtimer = 0) then
alarmtimer = 250ms
if (gd.alarm = false) then
gd.alarm = true
else
gd.alarm = false
end if
end if
Step 4: Interacting with Objects being touched on the Display
The variables you use to sense and interpret the objects being touched on the display are:
GD.key
GD.value
GD.setting
When an object is touched that objects key field value (> 0 and < 100) is sent to your application and an audible
beep is sounded. The receipt of the key message by the DVC controller’s BIOS results in the GD.key variable
being set to true (> 0) and the GD.value variable being set to the object’s key value. The GD.setting variable is
set for those objects having multiple possible settings such as the Slider and the List Box objects. For these two
objects, GD.value identifies the slider or list box touched while the GD.setting is set to the slider value or the list
box line number selected. After you have processed receipt of the key value you should set the GD.key
variable to false (0). The DVC BIOS prevents another object touch from being received if the GD.key variable
has not been set to false. This mechanism insures that object touches are processed in the order they occur.
Example code is as follows:
If (GD.key) then
Value = GD.value ‘ GD.value is saved to value in case a new value is received before this one is
‘ completely processed.
Setting = GD.setting ‘ Slider object returns its position as well as its key value
‘ List Box object returns the entry line number selected as well as the object key
GD.key = false
‘ add code to process the value received
............
End if