View source for PT-BR/onClientKey

{{PT-BR/Client event}}
__NOTOC__ 
Este evento é acionado sempre que o client pressiona um botão no teclado ou mouse.
Este evento também pode ser usado para ver se o client está usando a roda do mouse.

==Parâmetros==
<syntaxhighlight lang="lua">string button, bool pressOrRelease
</syntaxhighlight>
* '''button''':  Isto se refere ao botão pressionado ou solto. Veja a [[PT-BR/Key_names|lista de nome de teclas]] para melhor base de desenvolvimento.
* '''pressOrRelease''': Isso diz se o client estava pressionando ou soltando a tecla, ''true'' quando pressionando, ''false'' quando soltando.

==Source==
O [[PT-BR/Sistema_de_eventos|source]] deste evento é o [[root element]] do client.

==Efeito de cancelamento==
{{PT-BR/New items|5620|1.4|
Se este evento é [[PT-BR/Sistema_de_eventos#Canceling|cancelado]], então todas as ''binds'' do MTA e GTA, que foram vinculadas nas teclas canceladas, não serão acionadas.

'''Nota 1:''' A tecla '''Escape''' só pode ser cancelada uma vez. Se um usuário pressionar a tecla Escape duas vezes seguidas, o menu principal ainda será aberto.

'''Nota 2:''' O evento só é cancelável quando a tecla está sendo pressionada, não quando está sendo solta.
}}

==Exemplo== 
Este exemplo vai enviar mensagens no chatbox toda vez que o client pressionar alguma tecla.
<syntaxhighlight lang="lua">
function playerPressedKey(button, press)
    if (press) then -- Only output when they press it down
        outputChatBox("You pressed the "..button.." key!")
    end
end
addEventHandler("onClientKey", root, playerPressedKey)
</syntaxhighlight>

Este exemplo exibe no Debug Script uma mensagem toda vez que o client gira a roda do mouse
<syntaxhighlight lang="lua">
addEventHandler( "onClientKey", root, function(button,press) 
    -- Since mouse_wheel_up and mouse_wheel_down cant return a release, we dont have to check the press.
    if button == "mouse_wheel_up" or button == "mouse_wheel_down" then
        outputDebugString( button .. " moved." )
        return true
    end
    return false
end )
</syntaxhighlight>

[[pl:onClientKey]]

==Veja também==
{{GUI_events}}
===Funções de eventos client===
{{Client_event_functions}}