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

Énumère les boutons de la manette de jeu, y compris le bouton directionnel (croix directionnelle) et les conversions d'axes en boutons.

<a id="syntaxSection" />

## Syntaxe

```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 | Description |
| - | - |
| GameInputGamepadNone | Indique qu'aucun bouton n'est enfoncé. |
| GameInputGamepadMenu | Indique que le bouton Menu est enfoncé. |
| GameInputGamepadView | Indique que le bouton Affichage est enfoncé. |
| GameInputGamepadA | Indique que le bouton A est enfoncé. |
| GameInputGamepadB | Indique que le bouton B est enfoncé. |
| GameInputGamepadC | Indique que le bouton C est enfoncé. |
| GameInputGamepadX | Indique que le bouton X est enfoncé. |
| GameInputGamepadY | Indique que le bouton Y est enfoncé. |
| GameInputGamepadZ | Indique que le bouton Z est enfoncé. |
| GameInputGamepadDPadUp | Indique que la partie supérieure de la croix directionnelle est enfoncée. |
| GameInputGamepadDPadDown | Indique que la partie inférieure de la croix directionnelle est enfoncée. |
| GameInputGamepadDPadLeft | Indique que la partie gauche de la croix directionnelle est enfoncée. |
| GameInputGamepadDPadRight | Indique que la partie droite de la croix directionnelle est enfoncée. |
| GameInputGamepadLeftShoulder | Indique que le bouton supérieur gauche est enfoncé. |
| GameInputGamepadRightShoulder | Indique que le bouton supérieur droit est enfoncé. |
| GameInputGamepadLeftTriggerButton | Indique que le bouton de la gâchette gauche est enfoncé. |
| GameInputGamepadRightTriggerButton | Indique que le bouton de la gâchette droite est enfoncé. |
| GameInputGamepadLeftThumbstick | Indique que le bâton analogique gauche est enfoncé. |
| GameInputGamepadLeftThumbstickUp | Indique que le bâton analogique gauche est orienté vers le haut. |
| GameInputGamepadLeftThumbstickDown | Indique que le bâton analogique gauche est orienté vers le bas. |
| GameInputGamepadLeftThumbstickLeft | Indique que le bâton analogique gauche est orienté vers la gauche. |
| GameInputGamepadLeftThumbstickRight | Indique que le bâton analogique gauche est orienté vers la droite. |
| GameInputGamepadRightThumbstick | Indique que le bâton analogique droit est enfoncé. |
| GameInputGamepadRightThumbstickUp | Indique que le bâton analogique droit est orienté vers le haut. |
| GameInputGamepadRightThumbstickDown | Indique que le bâton analogique droit est orienté vers le bas. |
| GameInputGamepadRightThumbstickLeft | Indique que le bâton analogique droit est orienté vers la gauche. |
| GameInputGamepadRightThumbstickRight | Indique que le bâton analogique droit est orienté vers la droite. |
| GameInputGamepadPaddleLeft1 | Indique que le premier bouton palette gauche est enfoncé. |
| GameInputGamepadPaddleLeft2 | Indique que le deuxième bouton palette gauche est enfoncé. |
| GameInputGamepadPaddleRight1 | Indique que le premier bouton palette droit est enfoncé. |
| GameInputGamepadPaddleRight2 | Indique que le deuxième bouton palette droit est enfoncé. |

### Modules de manette de jeu

Les modules représentent des regroupements d'éléments de manette de jeu couramment présents ensemble.

| Constante | Description |
| - | - |
| GameInputGamepadModuleSystemDuo | Boutons Menu et Affichage. |
| GameInputGamepadModuleDpad | Boutons de la croix directionnelle (haut, bas, gauche, droite). |
| GameInputGamepadModuleShoulders | Boutons supérieurs gauche et droit. |
| GameInputGamepadModuleTriggers | Gâchettes gauche et droite. |
| GameInputGamepadModuleThumbsticks | Bâtons analogiques gauche et droit. |
| GameInputGamepadModulePaddles2 | Deux premiers boutons palettes (gauche 1 et droite 1). |
| GameInputGamepadModulePaddles4 | Les quatre boutons palettes (gauche 1, gauche 2, droite 1, droite 2). |

### Dispositions de manette de jeu

Dispositions de manette de jeu courantes.

| Constante | Description |
| - | - |
| GameInputGamepadLayoutBasic | Duo système (Menu et Affichage), croix directionnelle et boutons A et B. |
| GameInputGamepadLayoutButtons | Disposition de base plus les boutons X et Y et les boutons supérieurs. |
| GameInputGamepadLayoutStandard | Disposition standard présente sur les manettes de jeu depuis la XBOX 360. |
| GameInputGamepadLayoutElite | Disposition présente sur la manette XBOX Elite Series. |

<a id="remarksSection" />

## Remarques

Cette énumération est utilisée dans la structure [GameInputGamePadState](/fr-CA/reference/input/gameinput/structs/gameinputgamepadstate). Vous pouvez combiner des valeurs pour lire plusieurs boutons simultanément.

`GameInputGamepadLeftTriggerButton`, `GameInputGamepadRightTriggerButton`, `GameInputGamepadLeftThumbstickUp`, `GameInputGamepadLeftThumbstickDown`, `GameInputGamepadLeftThumbstickLeft`, `GameInputGamepadLeftThumbstickRight`, `GameInputGamepadRightThumbstickUp`, `GameInputGamepadRightThumbstickDown`, `GameInputGamepadRightThumbstickLeft` et `GameInputGamepadRightThumbstickRight` sont des représentations numériques des axes analogiques correspondants présents sur la plupart des manettes de jeu. Par exemple, si le bâton analogique gauche est poussé complètement vers le haut, le bouton `GameInputGamepadLeftThumbstickUp` et l'axe `GameInputGamepadLeftThumbstickY` afficheront tous deux la valeur 1.0.

Pour plus d'information, consultez la section [Obtention de données à partir des lectures](/fr-CA/build/core-features/common/input/overviews/input-readings#gettingStateSection) de [Lectures GameInput](/fr-CA/build/core-features/common/input/overviews/input-readings).

Cette énumération peut également être utilisée avec la méthode [IGameInputMapper::GetGamepadButtonMappingInfo](/fr-CA/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getgamepadbuttonmappinginfo) pour récupérer les informations de mappage d'un bouton de manette de jeu précis.

<a id="requirementsSection" />

## Configuration requise

**En-tête :** GameInput.h

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

<a id="seealsoSection" />

## Voir aussi

[Vue d'ensemble de GameInput](/fr-CA/build/core-features/common/input/overviews/input-overview)\
[GameInput](/fr-CA/reference/input/gameinput/gameinput_members)

## Historique des versions

| Version | Modifications |
| - | - |
| **v3** | **Ajout de 16 nouvelles constantes d'indicateur** : `C`, `Z`, `LeftTriggerButton`, `RightTriggerButton`, quatre directions `LeftThumbstick`, quatre directions `RightThumbstick`, `PaddleLeft1`, `PaddleLeft2`, `PaddleRight1`, `PaddleRight2`. Ajout également de 11 constantes composites/de disposition. |
| **v0** | Introduit. |

## Annexe : versions précédentes

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