PT-BR/unbindKey
Remove uma vinculação de tecla existente de um específico jogador.
Nota: unbindKey funcionará somente em binds que foram definidas pelo mesmo resource | |
Nota: unbindKey no servidor pode retornar true em casos de falhas | |
Sintaxe
bool unbindKey ( player thePlayer, string key, string keyState, string command )
bool unbindKey ( player thePlayer, string key [, string keyState, function handler ] )
Argumentos Necessários
- thePlayer: O jogador que você quer desvincular a tecla.
- key: A tecla que você quer desvincular. Veja a 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.
bool unbindKey ( string key, string keyState, string command )
bool unbindKey ( string key [, string keyState, function handler ] )
Argumentos Necessários
- key: A tecla que você quer desvincular. Veja a 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.
Exemplo
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.
-- 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
Veja também
- addCommandHandler
- bindKey
- executeCommandHandler
- getCommandHandlers
- getFunctionsBoundToKey
- getKeyBoundToFunction
- isControlEnabled
- removeCommandHandler
- toggleAllControls
- toggleControl
- unbindKey