removeEventHandler

Desfaz um addEventHandler.

Sintaxe

bool removeEventHandler ( string nomeDoEvento, element anexadoA, function manipulador )

Retorno

true se o manipulador foi encontrado e removido, false caso contrário.

Os três argumentos precisam ser exatamente os mesmos usados no registro, inclusive a referência da função. Isso significa que uma função anônima passada direto para addEventHandler não pode ser removida depois — guarde-a numa variável se pretende removê-la.

Só podem ser removidos os manipuladores que o seu próprio resource registrou: um outro resource que escute o mesmo evento no mesmo elemento nunca é afetado, e os manipuladores dele seguem funcionando. Uma chamada que não encontra nada seu apenas devolve false.

Exemplo

local function aoEntrar()
    outputDebugString(getPlayerName(source) .. " entrou")
end

addEventHandler("onPlayerJoin", root, aoEntrar)
removeEventHandler("onPlayerJoin", root, aoEntrar)

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