AppEvent()

Aus Wiki des Deutschsprachige Xbaseentwickler e. V.
Version vom 7. Juni 2013, 07:34 Uhr von Georg (Diskussion | Beiträge) (Die Seite wurde neu angelegt: „== Allgemeines == Die Funktion AppEvent() entnimmt der Event-Warteschlange des aktiven Threads das nächste Ereignis (Event), zusammen mit weiteren Parametern…“)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Zur Navigation springen Zur Suche springen

Allgemeines

Die Funktion AppEvent() entnimmt der Event-Warteschlange des aktiven Threads das nächste Ereignis (Event), zusammen mit weiteren Parametern, die zur Abarbeitung des Events erforderlich sind.

AppEvent() ist das Herzstück eines event-orientierten Programms.


Syntax

AppEvent(@mp1, @mp2, @oXbp, nTimeOut) --> nEvent


Parameter

<mp1>: Message Parameter 1, muss by reference übergeben werden. Der Inhalt beim Aufruf ist irrelevant, da der Parameter als Platzhalter für den ersten Message Parameter des Events dient. Sein Inhalt und Feldtyp ist abhängig vom jeweiligen Event.

<mp2>: Message Parameter 2, muss by reference übergeben werden. Der Inhalt beim Aufruf ist irrelevant, da der Parameter als Platzhalter für den ersten Message Parameter des Events dient. Sein Inhalt und Feldtyp ist abhängig vom jeweiligen Event.

<oXbp>: Xbase-Part, muss by reference übergeben werden. Der Inhalt beim Aufruf ist irrelevant, da der Parameter als Platzhalter für das Xbase-Part, auf das sich das Event bezieht, dient.

<nTimeOut>: gibt in Millisekunden an, nach welcher Zeit ohne Event das Warten beendet werden soll. Greift dieser Parameter, wird xbe_None als Ergebnis von AppEvent() zurückgegeben.


Querverweise

AppKeyState() LastAppEvent() NextAppEvent() PostAppEvent() SetAppEvent()


benötigte DLLs bzw. Include-Dateien

AppEvent.ch

Die Funktion AppEvent() gehört zu den grundsätzlich verfügbaren Funktionen und benötigt keine explizit benannte DLL. Enthalten ist die Funktion in XbpRT1.DLL.


Anwendungsbeispiel

Siehe hierzu: Event-Loop