> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GameInputGamepadButtons

> GameInputGamepadButtons

# GameInputGamepadButtons

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

<a id="syntaxSection" />

## Sintaxe

```cpp theme={null}
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;
```

<a id="constantsSection" />

## 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. |

<a id="remarksSection" />

## Comentários

Essa enumeração é usada na estrutura [GameInputGamePadState](/pt-BR/reference/input/gameinput/structs/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](/pt-BR/build/core-features/common/input/overviews/input-readings#gettingStateSection) de [Leituras do GameInput](/pt-BR/build/core-features/common/input/overviews/input-readings).

Essa enumeração também pode ser usada com o método [IGameInputMapper::GetGamepadButtonMappingInfo](/pt-BR/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getgamepadbuttonmappinginfo) para recuperar informações de mapeamento de um botão específico do gamepad.

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** GameInput.h

**Plataformas compatíveis:** Windows, consoles da família XBOX One e consoles XBOX Series

<a id="seealsoSection" />

## Confira também

[Visão geral do GameInput](/pt-BR/build/core-features/common/input/overviews/input-overview)\
[GameInput](/pt-BR/reference/input/gameinput/gameinput_members)

## 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

```cpp theme={null}
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,
};
```


## Related topics

- [GameInputGamepadButtons](/reference/input/gameinput/enums/gameinputgamepadbuttons.md)
- [GameInputGamepadInfo](/reference/input/gameinput/structs/gameinputgamepadinfo.md)
- [IGameInputMapper::GetGamepadButtonMapping](/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getgamepadbuttonmappinginfo.md)
- [GameInputGamepadState](/reference/input/gameinput/structs/gameinputgamepadstate.md)
- [GameInput](/reference/input/gameinput/gameinput_members.md)