PT-BR/unbindKey

From Multi Theft Auto: Wiki
Jump to navigation Jump to search

Remove uma vinculação de tecla existente de um específico jogador.

Post-it.png Nota: unbindKey funcionará somente em binds que foram definidas pelo mesmo resource
Post-it.png 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