Lettify: Created page with "NOTOC {{BR/Funcao_compartilhada}} Remove uma vinculação de tecla existente de um específico jogador. {{BR/Nota|unbindKey funcionará somente em binds que foram definida..."

2020-12-30T05:49:58Z

Created page with "__NOTOC__ {{BR/Funcao_compartilhada}} Remove uma vinculação de tecla existente de um específico jogador. {{BR/Nota|unbindKey funcionará somente em binds que foram definida..."

New page

__NOTOC__
{{BR/Funcao_compartilhada}}
Remove uma vinculação de tecla existente de um específico jogador.
{{BR/Nota|unbindKey funcionará somente em binds que foram definidas pelo mesmo resource}}
{{BR/Nota|unbindKey no servidor pode retornar ''true'' em casos de falhas}}
==Sintaxe==
<section name="Lado servidor" class="server" show="true">
<syntaxhighlight lang="lua">
bool unbindKey ( player thePlayer, string key, string keyState, string command )
</syntaxhighlight>
<syntaxhighlight lang="lua">
bool unbindKey ( player thePlayer, string key [, string keyState, function handler ] )
</syntaxhighlight>

===Argumentos Necessários===
*'''thePlayer:''' O jogador que você quer desvincular a tecla.
*'''key:''' A tecla que você quer desvincular. Veja a [[PT-BR/Key_names|lista de teclas]] para ter uma base de desenvolvimento.
*'''keyState:''' Pode ser qualquer um dos valores abaixo:
**'''"up":''' Se a tecla vinculada acionou uma função quando a tecla foi liberada
**'''"down":''' Se a tecla vinculada acionou uma função quando a tecla foi pressionada
**'''"both":''' Se a tecla vinculada acionou uma função quando a tecla foi pressionada e liberada
*'''command :''' (1° Sintaxe) O comando que queira desvincular a tecla.

===Argumentos Opcionais===
*'''keyState:''' Estado de pressionamento da tecla que foi vinculada para desvinculá-la. Opcional na 2° sintaxe.
*'''handler:''' (2° sintaxe) Função que você quer desvincular a tecla.
Nota: Se você não especificar a função ''handler'', qualquer instância da tecla ''key'' que está vinculada, será desvinculada, seja lá qual for a função que a tecla está vinculada.

===Retorno===
Retorna '''true'' se a tecla foi desvinculada, ''false'' se a tecla não foi previamente vinculada ou argumentos inválidos foram especificados na função.
</section>
<section name="Lado cliente" class="client" show="true">
<syntaxhighlight lang="lua">
bool unbindKey ( string key, string keyState, string command )
</syntaxhighlight>
<syntaxhighlight lang="lua">
bool unbindKey ( string key [, string keyState, function handler ] )
</syntaxhighlight>

===Argumentos Necessários===
*'''key:''' A tecla que você quer desvincular. Veja a [[PT-BR/Key_names|lista de teclas]] para ter uma base de desenvolvimento.
*'''keyState:''' Pode ser qualquer um dos valores abaixo:
**'''"up":''' Se a tecla vinculada acionou uma função quando a tecla foi liberada
**'''"down":''' Se a tecla vinculada acionou uma função quando a tecla foi pressionada
**'''"both":''' Se a tecla vinculada acionou uma função quando a tecla foi pressionada e liberada
*'''command :''' (1° Sintaxe) O comando que queira desvincular a tecla.

===Argumentos Opcionais===
*'''keyState:''' Estado de pressionamento da tecla que foi vinculada para desvinculá-la. Opcional na 2° sintaxe.
*'''handler:''' (2° sintaxe) Função que você quer desvincular a tecla.
Nota: Se você não especificar a função ''handler'', qualquer instância da tecla ''key'' que está vinculada, será desvinculada, seja lá qual for a função que a tecla está vinculada.

===Retorno===
Retorna '''true'' se a tecla foi desvinculada, ''false'' se a tecla não foi previamente vinculada ou argumentos inválidos foram especificados na função.
</section>

==Exemplo==
<section name="Lado servidor" class="server" show="true">
Esta função vincula a tecla ''F1'' do jogador à função ''goMoo'' que exibe uma mensagem no chat quando pressionada. A tecla é então desvinculada para que possa s
er usada efetivamente uma vez por vida.
<syntaxhighlight lang="lua">
-- define the function that will be called when F1 is pressed
function goMoo( player )
outputChatBox ( getPlayerName ( player ) .. " says Mooooooo!" )
unbindKey ( player, "F1", "down", goMoo ) -- this function will no longer be triggered by the player, after removing the bind.
end

function playerSpawn ( )
bindKey ( source, "F1", "down", goMoo ) -- bind the player's F1 key to the 'goMoo' function defined above
end
addEventHandler ( "onPlayerSpawn", root, playerSpawn ) -- make the playerSpawn function be called when a player spawns
</syntaxhighlight>
</section>

==Veja também==
{{Input functions}}

PT-BR/unbindKey - Revision history

Lettify: Created page with "__NOTOC__ {{BR/Funcao_compartilhada}} Remove uma vinculação de tecla existente de um específico jogador. {{BR/Nota|unbindKey funcionará somente em binds que foram definida..."

Lettify: Created page with "NOTOC {{BR/Funcao_compartilhada}} Remove uma vinculação de tecla existente de um específico jogador. {{BR/Nota|unbindKey funcionará somente em binds que foram definida..."