triggerEvent

Serwer i klientZdarzeniaIdentyczna z MTA:SA

Wywołuje zdarzenie na elemencie po tej samej stronie (serwer → serwer, klient → klient). Obsługi wywołują się od razu, zanim funkcja zwróci wynik. Zdarzenie musi być zarejestrowane przez addEvent albo być wbudowane.

Składnia

bool triggerEvent(string eventName, element baseElement [, any ...])

Argumenty

eventNamestring: Nazwa zdarzenia.
baseElementelement: Element, który będzie source.
...any, opcjonalny: Argumenty przekazane do obsług.

Zwraca

false, gdy któraś obsługa wywołała cancelEvent; inaczej true.

Przykład

addEvent("onJobFinished")
addEventHandler("onJobFinished", root, function(pay)
    givePlayerMoney(source, pay)
end)

addCommandHandler("koniec", function(player)
    triggerEvent("onJobFinished", player, 500)
end)

Zobacz też

addEventRejestruje własne zdarzenie o podanej nazwie, żeby można było je wywoływać (triggerEvent, triggerClientEvent, triggerServerEvent) i obsługiwać (addEventHandler). Z allowRemoteTrigger = true zdarzenie może przyjść z drugiej strony sieci: na serwerze - od klienta przez triggerServerEvent, na kliencie - od serwera przez triggerClientEvent. Bez tego zdarzenia przychodzące z sieci są odrzucane, co chroni serwer przed podrabianiem zdarzeń przez klientów.
cancelEventAnuluje bieżące zdarzenie z wnętrza jego obsługi. Dla zdarzeń, które na to pozwalają, blokuje domyślne działanie, np. onPlayerChat (wiadomość nie pojawi się na czacie), onPickupHit (pickup nie zostanie zebrany), onVehicleStartEnter (gracz nie wsiądzie). Pozostałe obsługi nadal się wywołują i mogą sprawdzić stan przez wasEventCancelled. Na serwerze można podać powód, który odczyta getCancelReason.
triggerClientEventWysyła zdarzenie z serwera do jednego gracza, kilku graczy albo wszystkich naraz.