showCursor

Mostra ou esconde o cursor do mouse para um jogador.

Sintaxe

-- servidor
bool showCursor ( element oJogador, bool mostrar [, bool travarControles = true ] )

-- cliente
bool showCursor ( bool mostrar [, bool travarControles = true ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
oJogador	element	—	Só no servidor. Jogador (ou elemento acima dele na árvore).
mostrar	bool	—	true mostra o cursor, false esconde.
travarControles	bool	true	Trava os controles do jogo enquanto o cursor estiver visível.

Retorno

true em caso de sucesso. No servidor, false quando o primeiro argumento não é um elemento válido.

No cliente o pedido é contado por resource: o cursor continua na tela enquanto algum resource ainda quiser vê-lo, e só some quando todos desistem. Uma chamada do servidor conta como pedido do mesmo resource naquele cliente — então um showCursor(jogador, false) no servidor cancela um showCursor(true) feito pelo mesmo resource no cliente, e é ignorado para um jogador que não esteja rodando aquele resource.

Exemplo

-- servidor
showCursor(jogador, true)          -- cursor visível, jogador travado
showCursor(jogador, true, false)   -- cursor visível, jogador continua andando

-- cliente
showCursor(true)
showCursor(true, false)

Veja também

• getPlayerPing — Devolve o tempo de ida e volta da conexão do jogador.
• getPlayerNametagText — Devolve o texto mostrado acima do jogador.
• setPlayerNametagText — Troca o texto mostrado acima do jogador.
• getPlayerNametagColor — Devolve a cor do nametag do jogador.
• setPlayerNametagColor — Fixa a cor do nametag, ou remove a cor fixada.
• isPlayerNametagShowing — Verifica se o nametag do jogador está visível.
• setPlayerNametagShowing — Mostra ou esconde o nametag do jogador para todo mundo.
• setPlayerHudComponentVisible — Mostra ou esconde uma parte do HUD para um jogador.