2 Visual Components Manuals

Introduction to Visual Components 2.3
UINT _GLOBAL iFunction;
USINT _GLOBAL cSeperator;
USINT _GLOBAL cDateTimeFormat;
unsigned long VC_HANDLE;
_CYCLIC void Cyclic(void)
{
if (!ready)
{
VC_HANDLE = VA_Setup(1 "vga"); ,
if (VC_HANDLE)
ready = 1;
}
if (ready)
{
if (!VA_Saccess(1,VC_HANDLE))
{
lLen = 80;
cSeperator = ' ';
cDateTimeFormat = 0;
iFunction = 1;
}
}
}
1,VC_HANDLE, VA_GetExAlarmList(
(DINT) pcAlarmline, (DINT) &lLen, iFunction, cSeperator, cDateTimeFormat);
VA_Srelease(1,VC_HANDLE);
3.3.8.13 Reading the Key Matrix − VA_GetKeyMatrix
The VA_GetKeyMatrix function returns information about whether and which keys on a target system are
currently being pressed.
3.3.8.13.1 Parameter
I/O Parameter Type Meaning
IN enable BOOL This function is only executed if enable is TRUE.
IN VCHandle UDINT The handle returned by VA_Setup.
IN KeyMatrix UDINT Start address of the key address array
IN KeysToRead UDINT Number of keys to be read
IN KeysRead UDINT Number of keys read
OUT Return Value UINT Not equal to 0 if error occurs
3.3.8.13.2 Example for C Programming
See also Reading the Matrix
3.3.8.14 Querying the Palette Color − VA_GetPaletteColor
Using VA_GetPaletteColor, it is possible to dynamically query each individual color value. Naturally, this is only
possible on an IPC (color or black/white display).
3.3.8.14.1 Parameter
I/O Parameter Type Meaning
IN enable BOOL This function is only executed if enable is TRUE.
IN VCHandle UDINT The handle returned by VA_Setup.
IN index UINT Index of the color which should be retrieved (0−255).
OUT Return Value UDINT
Color. The color value is arranged as follows:
Bits 0 .. 8 Red value (0−255)
Bits 8 .. 16 Green value (0−255)
Bits 16 .. 24 Blue value (0−255)
Bits 24 .. 32 0
3.3.8.13 Reading the Key Matrix − VA_GetKeyMatrix 149