# getControlState (Cliente)

> Diz se um controle de um ped está pressionado, como `forwards`, `fire` ou `accelerate`.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Função Lua
- **Lado**: Cliente
- **Categoria**: Controles
- **URL**: https://wiki.mymp.gg/pt/getControlState-client
- **Contraparte**: Também existe no servidor, com outra implementação: [getControlState (Servidor)](https://wiki.mymp.gg/pt/getControlState-server.md)

## Sintaxe

```lua
bool getControlState(string control [, ped thePed = localPlayer])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `thePed` | `ped` | O ped ou jogador. Pode ser omitido; aí vale o jogador local. *(padrão: `localPlayer`)* |
| `control` | `string` | O nome do controle, sem diferenciar maiúsculas. |

## Retorno

`true` se o controle está pressionado. `false` se não está, se o nome do controle não existe ou se o ped não pode ser lido.

No jogador local, lê o que o jogo recebe neste quadro, incluindo o que um script ligou com `setControlState`. Controles de veículo só contam dentro de um veículo e os de a pé só fora dele; com o motor desligado, `accelerate` não conta. Num jogador remoto, lê os controles que chegaram pela rede. Num ped, lê o que um script ligou nele.

## Exemplo

```lua
addEventHandler("onClientRender", root, function()
    if getControlState("sprint") then
        dxDrawText("Correndo", 20, 300)
    end
end)
```

### Vindo do MTA

Além dos controles do MTA, o MYMP tem `block` (bloquear no corpo a corpo) e `reload` (recarregar).

## Veja também

- [setControlState (Cliente)](https://wiki.mymp.gg/pt/setControlState-client.md): Pressiona ou solta um controle de um ped como se fosse uma tecla, por exemplo para fazê-lo andar, pular ou atirar.
- [getPedAnalogControlState (Cliente)](https://wiki.mymp.gg/pt/getPedAnalogControlState.md): Diz o quanto um controle de um ped está pressionado, de 0 a 1. Serve para os controles analógicos, como andar, virar e acelerar.
- [isControlEnabled (Cliente)](https://wiki.mymp.gg/pt/isControlEnabled-client.md): Diz se um controle do jogador local está ligado.
- [getControlState (Servidor)](https://wiki.mymp.gg/pt/getControlState-server.md): Diz se um jogador está pressionando um controle, segundo as teclas que o cliente dele mandou por último.
