Schnittstelle zur Abfrage von Benutzeraktionen und dynamischen Texten

Die beim Aktivieren der Zielsystem-Einstellung ‚Target-Visualisierung’ automatisch eingebundene Bibliothek SysLibTargetVisu.lib bietet die folgenden Funktionen zur Abfrage von Benutzereingaben durch Einträge in dynamischen Textlisten:

Funktion GetText : BOOL

Diese Funktion liefert einen sprachabhängigen Text aus der aktuellen dynamischen Textliste.

Übergabe-Parameter:

stResult: STRING(256);	Dient als IN_OUT Parameter und erhält den Text zugewiesen, der mittels des Prefix strings „stPrefix“ und der ID „dwID“ gefunden wurde.
nResultLength:INT;	Hier sollte die maximale Länge des strings „stResult“ übergeben werden, falls diese kleiner als 256 Zeichen ist.
stPrefix: STRING;	Präfix des Texteintrags in der aktuellen dynamischen Textliste.
dwID: DWORD;	ID des Texteintrags in der aktuellen dynamischen Textliste.

Rückgabewert:
FALSE - Es wurde kein passender Text zu „stPrefix“ und „dwID“ gefunden.
TRUE - Es wurde ein passender Text zu „stPrefix“ und „dwID“ gefunden.

Funktion GetTextByStringId: BOOL

Diese Funktion kann wie die Funktion GetText einen sprachabhängigen Text der dynamischen Textlisten zurückliefern. Der Unterschied besteht im Parameter „stID“ über den die ID des Texteintrags als Text-String anstatt als numerischer Wert übergeben werden kann. Dadurch ist es möglich, auch IDs, die in der xml-Textdatei als Strings definiert sind, wie z.B. „Text123“, verwenden zu können.

Übergabe-Parameter:

stResult: STRING(256);	Dient als IN_OUT Parameter und erhält den Text zugewiesen, der mittels des Prefix strings „stPrefix“ und der ID „dwID“ gefunden wurde.
nResultLength:INT;	Hier sollte die maximale Länge des strings „stResult“ übergeben werden, falls diese kleiner als 256 Zeichen ist.
stPrefix: STRING;	Präfix des Texteintrags in der aktuellen dynamischen Textliste.
stID: STRING;	ID des Texteintrags in der aktuellen dynamischen Textliste.

Rückgabewert:
FALSE - Es wurde kein passender Text zu „stPrefix“ und „stID“ gefunden.
TRUE - Es wurde ein passender Text zu „stPrefix“ und „stID“ gefunden.

Des Weiteren können Benutzereingaben via Mausklicks analysiert werden. Dazu ist die Bibliothek TcMouseEvents.lib mit folgenden Funktionen manuell einzubinden:

Funktion GetLastLeftMouseDownEvent : BOOL bzw. Funktion GetLastRightMouseDownEvent : BOOL

Diese Funktion bietet Information zum zuletzt ausgelösten "Left" bzw. "Right" MouseDown Event. Sie enthält einen Zeiger (pMouseEvent : POINTER TO MOUSEEVENT;) auf die Struktur MouseEvent, die folgende Parameter umfaßt:

dwCounter : DWORD;	Anzahl der MouseDownEvents seit Systemstart. Mit diesem Parameter kann ausgewertet werden ob kein, ein oder mehrere Events seit der letzten Anfrage ausgelöst wurden.
nXPos : INT;	Letzte Maus-Position in X/Y-Koordinaten
nYPos : INT;	Letzte Maus-Position in X/Y-Koordinaten

Rückgabewert:
Es wird kein Wert zurückgeliefert.

Funktion GetLastMouseMoveEvent : BOOL

Diese Funktion bietet Information zum zuletzt ausgelösten MouseMove Event. Sie enthält einen Zeiger (pMouseEvent : POINTER TO MOUSEEVENT;) auf die Struktur MouseEvent. Siehe oben, Funktion GetLastMouseDownEvent.

Rückgabewert:
Es wird kein Wert zurückgeliefert.

Funktion GetLastLeftMouseUpEvent : BOOL bzw. Funktion GetLastRightMouseUpEvent : BOOL

Diese Funktion bietet Information zum zuletzt ausgelösten "Left" bzw. "Right" MouseUp Event. Sie enthält einen Zeiger (pMouseEvent : POINTER TO MOUSEEVENT;) auf die Struktur MouseEvent.

Siehe oben, Funktion GetLastLeftMouseDownEvent bzw. Funktion GetLastRightMouseDownEvent .

Rückgabewert:
Es wird kein Wert zurückgeliefert.