FunkcjeWłasny serwerDla twórcówTrilogy Hub vs MTAFAQDocs Lua Pobierz launcher
  1. Dokumentacja
  2. Funkcje wspólne
  3. addEventHandler

Funkcja

addEventHandler

Serwer i klientZdarzeniaJak w MTA:SA

Podpina funkcję pod zdarzenie. Tak reagujesz na wejście gracza, śmierć, klawisz, każdą klatkę i własne zdarzenia.

Składnia

bool addEventHandler(string nazwa, element podpietyDo, function fn [, bool propaguj = true, string priorytet = "normal"])

Argumenty

nazwastring
Nazwa zdarzenia, np. onPlayerJoin albo własnego z addEvent.
podpietyDoelement
Element, którego zdarzenia łapiesz. root łapie wszystkie, resourceRoot tylko elementy tego zasobu.
fnfunction
Funkcja obsługi. W środku dostępne są source i eventName.
propagujbool, opcjonalny = true
Czy łapać też zdarzenia elementów niżej w drzewie.
priorytetstring, opcjonalny = normal
high, normal albo low. Decyduje o kolejności, gdy kilka funkcji obsługuje to samo zdarzenie.

Zwraca

true, gdy funkcja została podpięta, albo false, gdy ta sama funkcja jest już podpięta pod to zdarzenie i element.

Przykład

local function powitanie()
    outputChatBox("Cześć, " .. getPlayerName(source) .. "!", source)
end
addEventHandler("onPlayerJoin", root, powitanie)

-- ta sama funkcja drugi raz: zwraca false
addEventHandler("onPlayerJoin", root, powitanie)

Uwagi

Tak jak w MTA. Funkcję odepniesz przez removeEventHandler z tymi samymi argumentami. Zdarzenie możesz zatrzymać przez cancelEvent(), jeśli opis zdarzenia na to pozwala.

Zobacz też