Scan of mouse-clicks and dynamic texts

The library SysLibTargetVisu.lib, which gets included automatically as soon as target setting 'Target-Visualization' is activated, offers the following functions for scanning user resp. entries of the dynamic textlist currently used for language dependent text display in the visualization.

Function GetText : BOOL

This function provides a language depending on text from the currently used dynamic textlist.

Parameters:

stResult: STRING(256);	Serves as an IN_OUT parameter and gets assigned the text found by prefix string „stPrefix“ and ID „dwID“.
nResultLength:INT;	Define here the maximum length of the string „stResult“, if this is <256 characters.
stPrefix: STRING;	Prefix of the text entry in the currently used dynamic textlist.
dwID: DWORD;	ID of the text entry in the currently used dynamic textlist.

Return value:
FALSE – No text matching „stPrefix“ and „dwID“ was found.
TRUE - A text matching „stPrefix“ and „dwID“ was found.

Function GetTextByStringId: BOOL

This function - like function GetText - can provide a language depending on text from the currently used dynamic textlist. The difference to GetTest is: The ID of the text entry is given as a string in parameter „stID“ instead of a numeric value. Thus it is also possible to use IDs which are defined as strings in the xml-file for the dynamic texts (e.g. „Text123“).

Parameters:

stResult: STRING(256);	Serves as an IN_OUT parameter and gets assigned the text found by prefix string „stPrefix“ and ID „dwID“.
nResultLength:INT;	Define here the maximum length of the string „stResult“, if this is <256 characters.
stPrefix: STRING;	Prefix of the text entry in the currently used dynamic textlist.
stID: STRING;	ID of the text entry in the currently used dynamic textlist.

Return value:
FALSE – No text matching „stPrefix“ and „stID“ was found.
TRUE - A text matching „stPrefix“ and „stID“ was found.

Additionally it is possible to scann user mouse events. For this do you have to insert the library TcMouseEvents.lib with the following functionallity:

Function GetLastLeftMouseDownEvent : BOOL resp. Funktion GetLastRightMouseDownEvent : BOOL

This function provides information on the last performed "Left" resp. "Right" MouseDown Event. It contains a pointer (pMouseEvent : POINTER TO MOUSEEVENT;) on structure MouseEvent consisting of the following parameters:

dwCounter : DWORD;	Number of MouseDown-Events since system start. With these parameters it can be evaluated whether no, one or multiple events have been prompted since the last request.
nXPos : INT;	Last mouse position in X/Y-coordinates.
nYPos : INT;	Last mouse position in X/Y-coordinates.

Return value:
No return value.

Function GetLastMouseMoveEvent : BOOL

This function provides information on the last performed MouseMove-Event. It contains a pointer (pMouseEvent : POINTER TO MOUSEEVENT;) on structure MouseEvent, see above:function GetLastMouseDownEvent.

Return value:
No return value.

Function GetLastLeftMouseUpEvent : BOOL resp. Function GetLastRightMouseUpEvent : BOOL

This function provides information on the last performed "Left" resp. "Right" MouseUp-Event. It contains a pointer (pMouseEvent : POINTER TO MOUSEEVENT;) on structure MouseEvent, see above: function GetLastLeftMouseDownEvent resp. GetLastRightMouseDownEvent

Return value:
No return value.