triggerEvent

Dispara um evento no lado que o chama.

Sintaxe

bool triggerEvent ( string nomeDoEvento, element origem [, ... ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
nomeDoEvento	string	—	Evento a disparar.
origem	element	—	Elemento de origem, que vira source nos manipuladores.
...	any	—	Argumentos repassados a cada manipulador.

Retorno

false se algum manipulador chamou cancelEvent, true caso contrário. Um evento sem nenhum manipulador também devolve true.

Uma chamada errada se comporta diferente em cada lado. No servidor, um nome que não é string ou a falta de origem registra um aviso e devolve false, e um nome que ninguém registrou simplesmente não encontra manipuladores e devolve true. No cliente, nomeDoEvento também pode ser um número (ele vira texto), um nome ou uma origem inválidos registram um aviso e devolvem nil, e um nome que não é nem evento nativo do cliente nem registrado com addEvent devolve nil sem aviso.

No cliente, um evento disparado com triggerEvent também chega aos manipuladores presos a descendentes de origem, e não só ao próprio elemento e aos ancestrais dele.

Os manipuladores rodam na hora, um após o outro: quando triggerEvent retorna, todos já executaram.

Exemplo

addEvent("onDinheiroAlterado", false)

addEventHandler("onDinheiroAlterado", root, function(anterior, atual)
    outputDebugString("saldo: " .. anterior .. " -> " .. atual)
end)

triggerEvent("onDinheiroAlterado", jogador, 100, 250)

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.
• cancelEvent — Cancela o evento em execução.
• wasEventCancelled — Diz se um evento foi cancelado — o que está rodando, no servidor; o último que terminou, no cliente.
• getCancelReason — Devolve o motivo passado ao cancelEvent.