GameInputGamepadButtons

Enumera os botões do gamepad, incluindo o direcional digital (D-pad) e as conversões de eixo em botão.

Sintaxe

enum GameInputGamepadButtons
{
    GameInputGamepadNone                 = 0x00000000,
    GameInputGamepadMenu                 = 0x00000001,
    GameInputGamepadView                 = 0x00000002,
    GameInputGamepadA                    = 0x00000004,
    GameInputGamepadB                    = 0x00000008,
    GameInputGamepadC                    = 0x00004000,
    GameInputGamepadX                    = 0x00000010,
    GameInputGamepadY                    = 0x00000020,
    GameInputGamepadZ                    = 0x00008000,
    GameInputGamepadDPadUp               = 0x00000040,
    GameInputGamepadDPadDown             = 0x00000080,
    GameInputGamepadDPadLeft             = 0x00000100,
    GameInputGamepadDPadRight            = 0x00000200,
    GameInputGamepadLeftShoulder         = 0x00000400,
    GameInputGamepadRightShoulder        = 0x00000800,
    GameInputGamepadLeftTriggerButton    = 0x00010000,
    GameInputGamepadRightTriggerButton   = 0x00020000,
    GameInputGamepadLeftThumbstick       = 0x00001000,
    GameInputGamepadLeftThumbstickUp     = 0x00040000,
    GameInputGamepadLeftThumbstickDown   = 0x00080000,
    GameInputGamepadLeftThumbstickLeft   = 0x00100000,
    GameInputGamepadLeftThumbstickRight  = 0x00200000,
    GameInputGamepadRightThumbstick      = 0x00002000,
    GameInputGamepadRightThumbstickUp    = 0x00400000,
    GameInputGamepadRightThumbstickDown  = 0x00800000,
    GameInputGamepadRightThumbstickLeft  = 0x01000000,
    GameInputGamepadRightThumbstickRight = 0x02000000,
    GameInputGamepadPaddleLeft1          = 0x04000000,
    GameInputGamepadPaddleLeft2          = 0x08000000,
    GameInputGamepadPaddleRight1         = 0x10000000,
    GameInputGamepadPaddleRight2         = 0x20000000,
};

// Gamepad modules (Groupings of gamepad elements commonly found together)
const GameInputGamepadButtons GameInputGamepadModuleSystemDuo =
    GameInputGamepadMenu |
    GameInputGamepadView;

const GameInputGamepadButtons GameInputGamepadModuleDpad =
    GameInputGamepadDPadUp |
    GameInputGamepadDPadDown |
    GameInputGamepadDPadLeft |
    GameInputGamepadDPadRight;

const GameInputGamepadButtons GameInputGamepadModuleShoulders =
    GameInputGamepadLeftShoulder |
    GameInputGamepadRightShoulder;

const GameInputGamepadButtons GameInputGamepadModuleTriggers =
    GameInputGamepadLeftTriggerButton |
    GameInputGamepadRightTriggerButton;

const GameInputGamepadButtons GameInputGamepadModuleThumbsticks =
    GameInputGamepadLeftThumbstickUp |
    GameInputGamepadLeftThumbstickDown |
    GameInputGamepadLeftThumbstickLeft |
    GameInputGamepadLeftThumbstickRight |
    GameInputGamepadRightThumbstickUp |
    GameInputGamepadRightThumbstickDown |
    GameInputGamepadRightThumbstickLeft |
    GameInputGamepadRightThumbstickRight;

const GameInputGamepadButtons GameInputGamepadModulePaddles2 =
    GameInputGamepadPaddleLeft1 |
    GameInputGamepadPaddleRight1;

const GameInputGamepadButtons GameInputGamepadModulePaddles4 =
    GameInputGamepadPaddleLeft1 |
    GameInputGamepadPaddleLeft2 |
    GameInputGamepadPaddleRight1 |
    GameInputGamepadPaddleRight2;

// Commonly found gamepad layouts. Custom layouts are possible and encouraged.
const GameInputGamepadButtons GameInputGamepadLayoutBasic =
    GameInputGamepadModuleSystemDuo |
    GameInputGamepadModuleDpad |
    GameInputGamepadA |
    GameInputGamepadB;

const GameInputGamepadButtons GameInputGamepadLayoutButtons =
    GameInputGamepadLayoutBasic |
    GameInputGamepadX |
    GameInputGamepadY |
    GameInputGamepadModuleShoulders;

const GameInputGamepadButtons GameInputGamepadLayoutStandard =
    GameInputGamepadLayoutButtons |
    GameInputGamepadModuleTriggers |
    GameInputGamepadModuleThumbsticks |
    GameInputGamepadLeftThumbstick |
    GameInputGamepadRightThumbstick;

const GameInputGamepadButtons GameInputGamepadLayoutElite =
    GameInputGamepadLayoutStandard |
    GameInputGamepadModulePaddles4;

Constantes

Constante	Descrição
GameInputGamepadNone	Indica que nenhum botão está pressionado.
GameInputGamepadMenu	Indica que o botão Menu está pressionado.
GameInputGamepadView	Indica que o botão Exibir está pressionado.
GameInputGamepadA	Indica que o botão A está pressionado.
GameInputGamepadB	Indica que o botão B está pressionado.
GameInputGamepadC	Indica que o botão C está pressionado.
GameInputGamepadX	Indica que o botão X está pressionado.
GameInputGamepadY	Indica que o botão Y está pressionado.
GameInputGamepadZ	Indica que o botão Z está pressionado.
GameInputGamepadDPadUp	Indica que a parte superior do D-pad está pressionada.
GameInputGamepadDPadDown	Indica que a parte inferior do D-pad está pressionada.
GameInputGamepadDPadLeft	Indica que a parte esquerda do D-pad está pressionada.
GameInputGamepadDPadRight	Indica que a parte direita do D-pad está pressionada.
GameInputGamepadLeftShoulder	Indica que o botão superior esquerdo está pressionado.
GameInputGamepadRightShoulder	Indica que o botão superior direito está pressionado.
GameInputGamepadLeftTriggerButton	Indica que o botão do gatilho esquerdo está pressionado.
GameInputGamepadRightTriggerButton	Indica que o botão do gatilho direito está pressionado.
GameInputGamepadLeftThumbstick	Indica que o direcional analógico esquerdo está pressionado.
GameInputGamepadLeftThumbstickUp	Indica que o direcional analógico esquerdo está apontando para cima.
GameInputGamepadLeftThumbstickDown	Indica que o direcional analógico esquerdo está apontando para baixo.
GameInputGamepadLeftThumbstickLeft	Indica que o direcional analógico esquerdo está apontando para a esquerda.
GameInputGamepadLeftThumbstickRight	Indica que o direcional analógico esquerdo está apontando para a direita.
GameInputGamepadRightThumbstick	Indica que o direcional analógico direito está pressionado.
GameInputGamepadRightThumbstickUp	Indica que o direcional analógico direito está apontando para cima.
GameInputGamepadRightThumbstickDown	Indica que o direcional analógico direito está apontando para baixo.
GameInputGamepadRightThumbstickLeft	Indica que o direcional analógico direito está apontando para a esquerda.
GameInputGamepadRightThumbstickRight	Indica que o direcional analógico direito está apontando para a direita.
GameInputGamepadPaddleLeft1	Indica que o primeiro botão de pá esquerdo está pressionado.
GameInputGamepadPaddleLeft2	Indica que o segundo botão de pá esquerdo está pressionado.
GameInputGamepadPaddleRight1	Indica que o primeiro botão de pá direito está pressionado.
GameInputGamepadPaddleRight2	Indica que o segundo botão de pá direito está pressionado.

Módulos de gamepad

Os módulos representam agrupamentos de elementos do gamepad comumente encontrados juntos.

Constante	Descrição
GameInputGamepadModuleSystemDuo	Botões Menu e Exibir.
GameInputGamepadModuleDpad	Botões do D-pad (cima, baixo, esquerda, direita).
GameInputGamepadModuleShoulders	Botões superiores esquerdo e direito.
GameInputGamepadModuleTriggers	Gatilhos esquerdo e direito.
GameInputGamepadModuleThumbsticks	Direcionais analógicos esquerdo e direito.
GameInputGamepadModulePaddles2	Os dois primeiros botões de pá (esquerdo 1 e direito 1).
GameInputGamepadModulePaddles4	Todos os quatro botões de pá (esquerdo 1, esquerdo 2, direito 1, direito 2).

Layouts de gamepad

Layouts de gamepad comumente encontrados.

Constante	Descrição
GameInputGamepadLayoutBasic	Dupla do sistema (Menu e Exibir), D-pad e botões A e B.
GameInputGamepadLayoutButtons	Layout básico mais os botões X e Y e os botões superiores.
GameInputGamepadLayoutStandard	Layout padrão encontrado em gamepads desde o XBOX 360.
GameInputGamepadLayoutElite	Layout encontrado no XBOX Elite Controller Series.

Comentários

Essa enumeração é usada na estrutura GameInputGamePadState. Você pode combinar valores para ler vários botões simultaneamente. GameInputGamepadLeftTriggerButton, GameInputGamepadRightTriggerButton, GameInputGamepadLeftThumbstickUp, GameInputGamepadLeftThumbstickDown, GameInputGamepadLeftThumbstickLeft, GameInputGamepadLeftThumbstickRight, GameInputGamepadRightThumbstickUp, GameInputGamepadRightThumbstickDown, GameInputGamepadRightThumbstickLeft, e GameInputGamepadRightThumbstickRight são representações digitais dos eixos analógicos correspondentes encontrados na maioria dos gamepads. Por exemplo, se o direcional analógico esquerdo for empurrado totalmente para cima, tanto o botão GameInputGamepadLeftThumbstickUp quanto o eixo GameInputGamepadLeftThumbstickY exibirão o valor 1.0. Para obter mais informações, confira a seção Obtendo dados de leituras de Leituras do GameInput. Essa enumeração também pode ser usada com o método IGameInputMapper::GetGamepadButtonMappingInfo para recuperar informações de mapeamento de um botão específico do gamepad.

Requisitos

Cabeçalho: GameInput.h Plataformas compatíveis: Windows, consoles da família XBOX One e consoles XBOX Series

Confira também

Visão geral do GameInput
GameInput

Histórico de versões

Versão	Alterações
v3	Adicionadas 16 novas constantes de sinalizador: `C`, `Z`, `LeftTriggerButton`, `RightTriggerButton`, quatro direcionais `LeftThumbstick`, quatro direcionais `RightThumbstick`, `PaddleLeft1`, `PaddleLeft2`, `PaddleRight1`, `PaddleRight2`. Também foram adicionadas 11 constantes compostas/de layout.
v0	Introduzido.

Apêndice: versões anteriores

v0

enum GameInputGamepadButtons
{
    GameInputGamepadNone            = 0x00000000,
    GameInputGamepadMenu            = 0x00000001,
    GameInputGamepadView            = 0x00000002,
    GameInputGamepadA               = 0x00000004,
    GameInputGamepadB               = 0x00000008,
    GameInputGamepadX               = 0x00000010,
    GameInputGamepadY               = 0x00000020,
    GameInputGamepadDPadUp          = 0x00000040,
    GameInputGamepadDPadDown        = 0x00000080,
    GameInputGamepadDPadLeft        = 0x00000100,
    GameInputGamepadDPadRight       = 0x00000200,
    GameInputGamepadLeftShoulder    = 0x00000400,
    GameInputGamepadRightShoulder   = 0x00000800,
    GameInputGamepadLeftThumbstick  = 0x00001000,
    GameInputGamepadRightThumbstick = 0x00002000,
};

Porting

Build Paths

GameInputGamepadButtons

GameInputGamepadButtons

Sintaxe

Constantes

Módulos de gamepad

Layouts de gamepad

Comentários

Requisitos

Confira também

Histórico de versões

Apêndice: versões anteriores

v0

​GameInputGamepadButtons

​Sintaxe

​Constantes

​Módulos de gamepad

​Layouts de gamepad

​Comentários

​Requisitos

​Confira também

​Histórico de versões

​Apêndice: versões anteriores

​v0

GameInputGamepadButtons

Sintaxe

Constantes

Módulos de gamepad

Layouts de gamepad

Comentários

Requisitos

Confira também

Histórico de versões

Apêndice: versões anteriores

v0