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

Click to collapse [-]

Lado servidor

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.

Click to collapse [-]

Lado cliente

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

Click to collapse [-]

Lado servidor

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