# cancelEvent (Compartido)

> Marca el evento en curso como cancelado. Lo que impide la cancelación depende del evento.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Función Lua
- **Lado**: Compartido
- **Categoría**: Eventos
- **URL**: https://wiki.mymp.gg/es/cancelEvent

## Sintaxis

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

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `cancel` | `bool` | `true` cancela, `false` deshace una cancelación hecha por un handler anterior. *(por defecto: `true`)* |
| `reason` | `string` | Motivo, que se lee después con `getCancelReason`. *(por defecto: `""`)* |

## Retorno

`true` si lo marcó, `false` si no se llamó dentro de un handler.

Quien disparó el evento ve el resultado: `triggerEvent` devuelve `false` para un evento cancelado.

## Ejemplo

```lua
local banned = { ["c3f1a2"] = true }

addEventHandler("onPlayerQueue", root, function(accountId)
    if banned[accountId] then
        cancelEvent(true, "banned")
    end
end)
```

### Atención

Los handlers siguientes del mismo evento se siguen llamando.

## Ver también

- [wasEventCancelled (Compartido)](https://wiki.mymp.gg/es/wasEventCancelled.md): Indica si el último evento que terminó de ejecutarse en este lado fue cancelado.
- [getCancelReason (Compartido)](https://wiki.mymp.gg/es/getCancelReason.md): Da el motivo pasado a cancelEvent en el último evento que terminó de ejecutarse en este lado.
- [triggerEvent (Compartido)](https://wiki.mymp.gg/es/triggerEvent.md): Dispara un evento en este lado, en source. Los handlers del propio elemento y los de sus ancestros que propagan se llaman en el acto, antes de que la función vuelva.