> ## 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 los botones del mando, incluida la cruz de dirección (D-pad) y las traducciones de eje a botón.

<a id="syntaxSection" />

## Sintaxis

```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                            | Descripción                                                            |
| ------------------------------------ | ---------------------------------------------------------------------- |
| GameInputGamepadNone                 | Indica que no hay ningún botón presionado.                             |
| GameInputGamepadMenu                 | Indica que el botón de menú está presionado.                           |
| GameInputGamepadView                 | Indica que el botón de vista está presionado.                          |
| GameInputGamepadA                    | Indica que el botón A está presionado.                                 |
| GameInputGamepadB                    | Indica que el botón B está presionado.                                 |
| GameInputGamepadC                    | Indica que el botón C está presionado.                                 |
| GameInputGamepadX                    | Indica que el botón X está presionado.                                 |
| GameInputGamepadY                    | Indica que el botón Y está presionado.                                 |
| GameInputGamepadZ                    | Indica que el botón Z está presionado.                                 |
| GameInputGamepadDPadUp               | Indica que la parte superior de la cruz de dirección está presionada.  |
| GameInputGamepadDPadDown             | Indica que la parte inferior de la cruz de dirección está presionada.  |
| GameInputGamepadDPadLeft             | Indica que la parte izquierda de la cruz de dirección está presionada. |
| GameInputGamepadDPadRight            | Indica que la parte derecha de la cruz de dirección está presionada.   |
| GameInputGamepadLeftShoulder         | Indica que el botón superior izquierdo está presionado.                |
| GameInputGamepadRightShoulder        | Indica que el botón superior derecho está presionado.                  |
| GameInputGamepadLeftTriggerButton    | Indica que el botón del gatillo izquierdo está presionado.             |
| GameInputGamepadRightTriggerButton   | Indica que el botón del gatillo derecho está presionado.               |
| GameInputGamepadLeftThumbstick       | Indica que el stick izquierdo está presionado.                         |
| GameInputGamepadLeftThumbstickUp     | Indica que el stick izquierdo apunta hacia arriba.                     |
| GameInputGamepadLeftThumbstickDown   | Indica que el stick izquierdo apunta hacia abajo.                      |
| GameInputGamepadLeftThumbstickLeft   | Indica que el stick izquierdo apunta hacia la izquierda.               |
| GameInputGamepadLeftThumbstickRight  | Indica que el stick izquierdo apunta hacia la derecha.                 |
| GameInputGamepadRightThumbstick      | Indica que el stick derecho está presionado.                           |
| GameInputGamepadRightThumbstickUp    | Indica que el stick derecho apunta hacia arriba.                       |
| GameInputGamepadRightThumbstickDown  | Indica que el stick derecho apunta hacia abajo.                        |
| GameInputGamepadRightThumbstickLeft  | Indica que el stick derecho apunta hacia la izquierda.                 |
| GameInputGamepadRightThumbstickRight | Indica que el stick derecho apunta hacia la derecha.                   |
| GameInputGamepadPaddleLeft1          | Indica que el primer botón de pala izquierdo está presionado.          |
| GameInputGamepadPaddleLeft2          | Indica que el segundo botón de pala izquierdo está presionado.         |
| GameInputGamepadPaddleRight1         | Indica que el primer botón de pala derecho está presionado.            |
| GameInputGamepadPaddleRight2         | Indica que el segundo botón de pala derecho está presionado.           |

### Módulos de mando

Los módulos representan agrupaciones de elementos del mando que suelen encontrarse juntos.

| Constante                         | Descripción                                                                  |
| --------------------------------- | ---------------------------------------------------------------------------- |
| GameInputGamepadModuleSystemDuo   | Botones de menú y vista.                                                     |
| GameInputGamepadModuleDpad        | Botones de la cruz de dirección (arriba, abajo, izquierda, derecha).         |
| GameInputGamepadModuleShoulders   | Botones superiores izquierdo y derecho.                                      |
| GameInputGamepadModuleTriggers    | Gatillos izquierdo y derecho.                                                |
| GameInputGamepadModuleThumbsticks | Sticks izquierdo y derecho.                                                  |
| GameInputGamepadModulePaddles2    | Los dos primeros botones de pala (izquierdo 1 y derecho 1).                  |
| GameInputGamepadModulePaddles4    | Los cuatro botones de pala (izquierdo 1, izquierdo 2, derecho 1, derecho 2). |

### Diseños de mando

Diseños de mando que se encuentran habitualmente.

| Constante                      | Descripción                                                        |
| ------------------------------ | ------------------------------------------------------------------ |
| GameInputGamepadLayoutBasic    | Dúo del sistema (menú y vista), cruz de dirección y botones A y B. |
| GameInputGamepadLayoutButtons  | Diseño básico más los botones X e Y y los botones superiores.      |
| GameInputGamepadLayoutStandard | Diseño estándar presente en los mandos desde la XBOX 360.          |
| GameInputGamepadLayoutElite    | Diseño presente en la serie XBOX Elite Controller.                 |

<a id="remarksSection" />

## Comentarios

Esta enumeración se usa en la estructura [GameInputGamePadState](/reference/input/gameinput/structs/gameinputgamepadstate). Puede combinar valores para leer varios botones simultáneamente.

`GameInputGamepadLeftTriggerButton`, `GameInputGamepadRightTriggerButton`, `GameInputGamepadLeftThumbstickUp`, `GameInputGamepadLeftThumbstickDown`, `GameInputGamepadLeftThumbstickLeft`, `GameInputGamepadLeftThumbstickRight`, `GameInputGamepadRightThumbstickUp`, `GameInputGamepadRightThumbstickDown`, `GameInputGamepadRightThumbstickLeft` y `GameInputGamepadRightThumbstickRight` son representaciones digitales de los ejes analógicos correspondientes que se encuentran en la mayoría de los mandos. Por ejemplo, si el stick izquierdo se empuja completamente hacia arriba, tanto el botón `GameInputGamepadLeftThumbstickUp` como el eje `GameInputGamepadLeftThumbstickY` mostrarán el valor 1.0.

Para obtener más información, consulte la sección [Obtención de datos de las lecturas](/build/core-features/common/input/overviews/input-readings#gettingStateSection) de [Lecturas de GameInput](/build/core-features/common/input/overviews/input-readings).

Esta enumeración también se puede usar con el método [IGameInputMapper::GetGamepadButtonMappingInfo](/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getgamepadbuttonmappinginfo) para recuperar información de asignación de un botón específico del mando.

<a id="requirementsSection" />

## Requisitos

**Encabezado:** GameInput.h

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

<a id="seealsoSection" />

## Consulte también

[Información general de GameInput](/build/core-features/common/input/overviews/input-overview)\
[GameInput](/reference/input/gameinput/gameinput_members)

## Historial de versiones

| Versión | Cambios                                                                                                                                                                                                                                                                                                            |
| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **v3**  | **Se agregaron 16 nuevas constantes de marca**: `C`, `Z`, `LeftTriggerButton`, `RightTriggerButton`, cuatro direccionales de `LeftThumbstick`, cuatro direccionales de `RightThumbstick`, `PaddleLeft1`, `PaddleLeft2`, `PaddleRight1`, `PaddleRight2`. También se agregaron 11 constantes compuestas o de diseño. |
| **v0**  | Se introdujo.                                                                                                                                                                                                                                                                                                      |

## Apéndice: versiones 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

- [GameInput](/es/reference/input/gameinput/gameinput_members.md)
- [GameInputMouseButtons](/es/reference/input/gameinput/enums/gameinputmousebuttons.md)
- [IGameInputReading::GetGamepadState](/es/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getgamepadstate.md)
- [GameInputSystemButtonCallback](/es/reference/input/gameinput/functions/gameinputsystembuttoncallback.md)
- [GameInputFlightStickButtons](/es/reference/input/gameinput/enums/gameinputflightstickbuttons.md)