wasEventCancelled

Diz se um evento foi cancelado — o que está rodando, no servidor; o último que terminou, no cliente.

Sintaxe

bool wasEventCancelled ( )

Retorno

Os dois lados respondem perguntas diferentes:

• Servidor — dentro de um manipulador, true se algum manipulador já chamou cancelEvent para o evento em execução. Fora de qualquer manipulador, é false.
• Cliente — true se o último evento que terminou de rodar foi cancelado. Ele foi feito para ser chamado logo depois de triggerEvent; dentro de um manipulador ele não enxerga cancelamentos feitos por manipuladores anteriores do mesmo evento, só o resultado do último evento que terminou.

Exemplo

-- servidor: ignora uma mensagem que outro manipulador já bloqueou
addEventHandler("onPlayerChat", root, function()
    if wasEventCancelled() then return end
    -- ninguém bloqueou a mensagem
end, true, "low")

-- cliente: confere o resultado de um evento que você disparou
addEvent("onClientLojaAbrir")
triggerEvent("onClientLojaAbrir", localPlayer)
if wasEventCancelled() then
    outputDebugString("outro script manteve a loja fechada")
end

Veja também

• addEvent — Cria um evento novo, para que ele possa ser disparado com triggerEvent.
• addEventHandler — Registra uma função para rodar quando um evento dispara.
• removeEventHandler — Desfaz um addEventHandler.
• getEventHandlers — Lista os manipuladores que o seu resource anexou a um elemento.
• triggerEvent — Dispara um evento no lado que o chama.
• cancelEvent — Cancela o evento em execução.
• getCancelReason — Devolve o motivo passado ao cancelEvent.