Trilogy Hub
PLEN
- serwerów - graczy
Pobierz
SerweryWłasny serwerDla twórcówForumFAQDokumentacjaBezpieczeństwo
PLEN
Pobierz launcher
  1. Dokumentacja
  2. Funkcje wspólne
  3. cancelEvent

Funkcja

cancelEvent

Serwer i klientZdarzeniaZmodyfikowana względem MTA:SA

Anuluje 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.

Składnia

bool cancelEvent([bool cancel = true, string reason = ""])

Argumenty

cancelbool, opcjonalny = true
Tylko serwer: false = nic nie rób.Nie ma go w MTA:SA
reasonstring, opcjonalny = ""
Tylko serwer: powód anulowania.Nie ma go w MTA:SA

Różnice względem MTA:SA

  • Argumenty zaznaczone innym kolorem różnią się od MTA:SA.

W MTA:SA

cancelEvent()

Zwraca

true, gdy wywołano w trakcie zdarzenia.

Przykład

addEventHandler("onPlayerChat", root, function(message)
    if message:find("http") then
        cancelEvent()
        outputChatBox("Linki sa zablokowane", source, 255, 0, 0)
    end
end)

Zobacz też