2 Visual Components Manuals

Introduction to Visual Components 2.3
Important:
Text groups must be on the target if they are to be read. The pcTextlength variable has to transfer a string
length. If the read length is smaller than the value input, then the actual length of the string is displayed.
3.3.8.15.2 Example for Automation Basic
(* cyclic program *)
if ready = 0 then
VC_HANDLE = VA_Setup(1,"visu")
if VC_HANDLE 0 then
ready = 1
endif
else
Access_Status = VA_Saccess (1,VC_HANDLE)
if Access_Status = 0 then
pcTextlength = 70
if (ReadingText = 1) then
ReadingText = 0
status = VA_GetTextByTextGroup(1,VC_HANDLE,TG_id,TGT_id,
UDINT(ADR(pcText)),UDINT(ADR(pcTextlength)))
endif
endif
endif
VA_Srelease (1,VC_HANDLE)
3.3.8.15.3 Example for C Programming
#include
#include
#include
unsigned long VC_HANDLE;
_GLOBAL USINT ready;
_GLOBAL USINT TG_id;
_GLOBAL USINT TGT_id;
_GLOBAL STRING pcText[80];
_GLOBAL UDINT pcTextlength;
_GLOBAL UINT status;
_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))
{
status = VA_GetTextByTextGroup(1,VC_HANDLE,TG_id,TGT_id,(UDINT)pcText,(UDINT)&pcTextlength);
VA_Srelease(1,VC_HANDLE);
}
}
}
3.3.8.16 User−Defined Touch Operation − VA_GetTouchAction
The VA_GetTouchAction function can be used to retrieve the location of the current touch position, as well as
the touch status (pressed/released).
3.3.8.16.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 type UDINT Retrieval type.
0 ... Processed
1 ... REALTIME
3.3.8.15 Graphics and Text Output − VA_GetTextByTextGroup 151