Pular para o conteúdo principal
Recupera o estado dos botões do sistema, como os botões Guia e Compartilhar, de uma leitura de entrada.

Sintaxe

Parâmetros

buttons   _Out_
Tipo: GameInputSystemButtons*
Recebe o conjunto de botões do sistema pressionados nesta leitura.

Valor retornado

Tipo: bool Retorna true se a leitura contiver o estado dos botões do sistema. Retorna false se não contiver; nesse caso, buttons é definido como GameInputSystemButtonNone.

Comentários

No GameInput v4, os botões do sistema são um tipo de entrada comum, GameInputKindSystemButton. Todas as leituras de um dispositivo que tem botões do sistema incluem GameInputKindSystemButton em IGameInputReading::GetInputKind, e GetSystemButtonState retorna o estado atual desses botões da mesma forma que IGameInputReading::GetGamepadState retorna o estado dos botões do gamepad. Para descobrir quais botões do sistema um dispositivo tem, chame IGameInputDevice::GetSupportedSystemButtons. A leitura relata quais botões estão pressionados, não eventos de pressionamento ou liberação. Para detectar um pressionamento ou uma liberação, compare o estado com o estado da leitura anterior. Este método substitui o método IGameInput::RegisterSystemButtonCallback das versões anteriores do GameInput. Use IGameInput::RegisterReadingCallback com GameInputKindSystemButton, ou faça uma sondagem com IGameInput::GetCurrentReading, para receber a entrada dos botões do sistema. A entrada dos botões do sistema é entregue somente enquanto o aplicativo está em foco, a menos que a entrada em segundo plano esteja habilitada com IGameInput::EnableBackgroundInput. O exemplo a seguir mostra como detectar um novo pressionamento do botão Guia.

Requisitos

Cabeçalho: GameInput.h Biblioteca: gameinput.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

Confira também

Visão geral do GameInput
IGameInputReading
GameInputSystemButtons
GameInputKind
IGameInput::EnableBackgroundInput
IGameInputDevice::GetSupportedSystemButtons

Histórico de versões

Última modificação em 6 de novembro de 2026