onClientKey

Disparado quando uma tecla é pressionada ou solta.

Origem

A raiz (root).

Parâmetros

Posição	Nome	Tipo	Descrição
1	tecla	string	Nome da tecla, como "f2" ou "lshift".
2	pressionada	bool	true na pressão, false ao soltar.

Cancelável

Sim.

Cancelar impede que a tecla chegue a qualquer bind de bindKey (e um Ctrl + V cancelado não dispara onClientPaste). A tecla já chegou ao jogo quando o evento sai, então cancelar não a bloqueia lá.

Este evento pega todas as teclas, sem precisar de registro prévio. Os botões do mouse também passam por aqui, com os nomes mouse1 a mouse5; a roda chega como mouse_wheel_up e mouse_wheel_down, sempre com um par pressiona-solta imediato.

addEventHandler("onClientKey", root, function(tecla, pressionada)
    if tecla == "f2" and pressionada then
        outputDebugString("F2 apertado")
    end
end)

Atenção ao segundo parâmetro

Aqui o segundo parâmetro é um booleano. O callback do bindKey é uma chamada de função comum (as globais de evento, como eventName, não são preenchidas), e entrega o estado como o texto "down" ou "up":

bindKey("f2", "down", function(tecla, estado)
    -- estado aqui é "down", não true
    outputDebugString(tecla .. " " .. estado)
end)

Se você quer só uma tecla específica, bindKey é mais barato: o onClientKey roda para cada tecla que o jogador encostar.

Veja também

• onClientCharacter — Disparado quando o jogador digita um caractere.
• onClientClick — Disparado quando um botão do mouse é pressionado ou solto com o cursor visível.
• onClientDoubleClick — Disparado quando um clique acontece logo depois de outro, no mesmo lugar.
• onClientCursorMove — Disparado quando o cursor do mouse se move.
• onClientPaste — Disparado quando o jogador aperta Ctrl + V.