# onClientKey (Cliente)

> Disparado quando uma tecla ou botão do mouse é apertado ou solto. Cancelar o evento impede os binds dessa tecla e, no aperto, esconde a tecla do jogo enquanto ela fica apertada.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Evento Lua
- **Lado**: Cliente
- **Categoria**: Teclado
- **Cancelável**: `cancelEvent`
- **URL**: https://wiki.mymp.gg/pt/onClientKey

## Sintaxe

```lua
addEventHandler("onClientKey", root, function(string button, bool pressOrRelease) ... end)
```

## Parâmetros do handler

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `button` | `string` | O nome da tecla, como `bindKey` usa. |
| `pressOrRelease` | `bool` | `true` ao apertar, `false` ao soltar. |

## Source

O elemento raiz (`root`).

Cancelado, o servidor também não fica sabendo da tecla, então os binds do servidor não disparam. A rodinha do mouse chega como `mouse_wheel_up` ou `mouse_wheel_down`, apertada e solta em seguida.

## Exemplo

```lua
addEventHandler("onClientKey", root, function(button, pressed)
    if button == "f" and pressed and isCursorShowing() then
        cancelEvent()
    end
end)
```

## Veja também

- [bindKey (Compartilhado)](https://wiki.mymp.gg/pt/bindKey.md): Liga uma tecla a uma função ou a um comando. A função roda quando a tecla é apertada, solta ou os dois.
- [getKeyState (Cliente)](https://wiki.mymp.gg/pt/getKeyState.md): Diz se uma tecla está apertada agora.
- [cancelEvent (Compartilhado)](https://wiki.mymp.gg/pt/cancelEvent.md): Marca o evento que está rodando como cancelado. O que o cancelamento impede depende do evento.