addEventHandler
Compartido
Hace que una función se llame cada vez que el evento ocurre en el elemento indicado o, con propagate, en cualquiera de sus descendientes.
bool addEventHandler(string eventName, element attachedTo, function handler [, bool propagate = true, string priority = "normal"])
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
| eventName | string | Nombre de un evento registrado (integrado o creado con addEvent). |
| attachedTo | element | Elemento que escucha el handler. Usa root para oír el evento en cualquier elemento. |
| handler | function | Función que se llama con los argumentos del evento. |
| propagate | bool | Llamarse también cuando el evento ocurre en un descendiente de attachedTo. Con false, solo cuando la fuente es el propio attachedTo.por defecto true |
| priority | string | "high", "normal" o "low". Los handlers de mayor prioridad se ejecutan antes; entre iguales, en el orden en que se añadieron.por defecto "normal" |
Retorno
true si lo añadió, false si el evento no existe o esa función ya está en ese evento de ese elemento.
Dentro del handler, las globales source (donde ocurrió el evento), this (el elemento al que está unido el handler), eventName, client (en el servidor, el jugador que disparó un evento remoto) y sourceResource dicen de dónde vino el evento. Los handlers de un recurso se eliminan cuando se detiene.
Ejemplo
addEventHandler("onPlayerJoin", root, function()
outputDebugString(getPlayerName(source) .. " joined")
end, true, "high")Si vienes de MTASolo cuentan los nombres
high, normal y low. Un ajuste como "high+5" vale lo mismo que "normal".