Beschreibung#
Wird ausgelöst, wenn Lua-UI ein screen/control-Ereignis sendet, etwa mit AddUITriggeredEvent.
Ereignisdaten#
| Feld | Typ / Bedeutung | Bedeutung |
|---|---|---|
event.param |
MD-Zeichenkette | Bildschirmkennung. |
event.param2 |
MD-Zeichenkette | Kontrollkennung. |
event.param3 |
unknown | Daten von Sendern; Ihr Lua Sender definiert das Lese-Zuladungsformat. |
MD-Bezeichnungen beschreiben MD-Werte und semantische Objektrollen, keine Lua-Typen. unknown bedeutet, dass die Quelle die genaue Darstellung nicht festlegt; es verspricht kein nil. Nicht aufgeführte Ereignisfelder werden nicht vorausgesetzt.
Abonnement-Beispiel#
Füge dieses unabhängige Fragment in den passenden cues-Knoten deines MD-Skripts ein. Benenne WikiWatch um, wenn du mehrere Beispiele verwendest.
<cue name="WikiWatch" instantiate="true" namespace="this">
<conditions>
<event_ui_triggered screen="'WikiExample'" control="'read'" />
</conditions>
<actions>
<set_value name="$Screen" exact="event.param" />
<set_value name="$Control" exact="event.param2" />
<set_value name="$Payload" exact="event.param3" />
<debug_text text="'Wiki: event_ui_triggered received'" />
</actions>
</cue>Was geschieht#
Jedes passende Ereignis erstellt eine Handler-Instanz und kopiert die dokumentierten Felder in ihre lokalen Variablen. Bei aktivierter Skriptdiagnose wird folgende Meldung erwartet:
Wiki: event_ui_triggered receivedDies ist die erwartete Ausgabe eines unabhängigen Lernbeispiels und kein abgeschlossener Spieltest. Abonnements beobachten Ereignisse, ohne die eigentliche Spielaktion auszulösen. Vermeide bei häufigen Ereignissen eine Protokollmeldung pro Ereignis.
XML-Abonnementfilter#
Diese Attribute filtern Ereignisse; sie sind nicht die oben genannten Ereignisdatenfelder. Schematypen.
libraries/common.xsd
| Attribut | Schematyp | Erforderlich | Standard / festgelegt |
|---|---|---|---|
chance |
expression |
Nein | nicht deklariert |
comment |
comment |
Nein | nicht deklariert |
screen |
expression |
Nein | nicht deklariert |
control |
expression |
Nein | nicht deklariert |
Rückgabewert#
Dies ist eine MD-Ereignisbedingung, kein Funktionsaufruf mit einem Lua-Tupel als Rückgabe. Lies event.object/event.param im zugehörigen MD-Aktionskontext.
Vertragsgrundlage#
Die Feldzuordnung wurde mit den Anmerkungen in common.xsd / md.xsd der installierten X4 9.00 (611726) abgeglichen. Veröffentlicht werden eigene Erklärungen und unabhängige Beispiele. Gültiges XML allein beweist keinen Effekt im Spiel.