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

# GameInputGamepadButtons

> GameInputGamepadButtons

# GameInputGamepadButtons

ゲームパッドのボタン (方向パッド (D-pad) や軸からボタンへの変換を含む) を列挙します。

## 構文

```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;
```

## 定数

| 定数 | 説明 |
| - | - |
| GameInputGamepadNone | ボタンが押されていないことを示します。 |
| GameInputGamepadMenu | メニュー ボタンが押されていることを示します。 |
| GameInputGamepadView | ビュー ボタンが押されていることを示します。 |
| GameInputGamepadA | A ボタンが押されていることを示します。 |
| GameInputGamepadB | B ボタンが押されていることを示します。 |
| GameInputGamepadC | C ボタンが押されていることを示します。 |
| GameInputGamepadX | X ボタンが押されていることを示します。 |
| GameInputGamepadY | Y ボタンが押されていることを示します。 |
| GameInputGamepadZ | Z ボタンが押されていることを示します。 |
| GameInputGamepadDPadUp | D-pad の上部分が押されていることを示します。 |
| GameInputGamepadDPadDown | D-pad の下部分が押されていることを示します。 |
| GameInputGamepadDPadLeft | D-pad の左部分が押されていることを示します。 |
| GameInputGamepadDPadRight | D-pad の右部分が押されていることを示します。 |
| GameInputGamepadLeftShoulder | 左ショルダー ボタンが押されていることを示します。 |
| GameInputGamepadRightShoulder | 右ショルダー ボタンが押されていることを示します。 |
| GameInputGamepadLeftTriggerButton | 左トリガー ボタンが押されていることを示します。 |
| GameInputGamepadRightTriggerButton | 右トリガー ボタンが押されていることを示します。 |
| GameInputGamepadLeftThumbstick | 左サムスティックが押されていることを示します。 |
| GameInputGamepadLeftThumbstickUp | 左サムスティックが上を指していることを示します。 |
| GameInputGamepadLeftThumbstickDown | 左サムスティックが下を指していることを示します。 |
| GameInputGamepadLeftThumbstickLeft | 左サムスティックが左を指していることを示します。 |
| GameInputGamepadLeftThumbstickRight | 左サムスティックが右を指していることを示します。 |
| GameInputGamepadRightThumbstick | 右サムスティックが押されていることを示します。 |
| GameInputGamepadRightThumbstickUp | 右サムスティックが上を指していることを示します。 |
| GameInputGamepadRightThumbstickDown | 右サムスティックが下を指していることを示します。 |
| GameInputGamepadRightThumbstickLeft | 右サムスティックが左を指していることを示します。 |
| GameInputGamepadRightThumbstickRight | 右サムスティックが右を指していることを示します。 |
| GameInputGamepadPaddleLeft1 | 1 つ目の左パドル ボタンが押されていることを示します。 |
| GameInputGamepadPaddleLeft2 | 2 つ目の左パドル ボタンが押されていることを示します。 |
| GameInputGamepadPaddleRight1 | 1 つ目の右パドル ボタンが押されていることを示します。 |
| GameInputGamepadPaddleRight2 | 2 つ目の右パドル ボタンが押されていることを示します。 |

### ゲームパッド モジュール

モジュールは、一般的にまとめて存在するゲームパッド要素のグループを表します。

| 定数 | 説明 |
| - | - |
| GameInputGamepadModuleSystemDuo | メニュー ボタンとビュー ボタン。 |
| GameInputGamepadModuleDpad | D-pad ボタン (上、下、左、右)。 |
| GameInputGamepadModuleShoulders | 左右のショルダー ボタン。 |
| GameInputGamepadModuleTriggers | 左右のトリガー。 |
| GameInputGamepadModuleThumbsticks | 左右のサムスティック。 |
| GameInputGamepadModulePaddles2 | 最初の 2 つのパドル ボタン (左 1 と右 1)。 |
| GameInputGamepadModulePaddles4 | 4 つすべてのパドル ボタン (左 1、左 2、右 1、右 2)。 |

### ゲームパッド レイアウト

一般的なゲームパッドのレイアウト。

| 定数 | 説明 |
| - | - |
| GameInputGamepadLayoutBasic | システム デュオ (メニューとビュー)、D-pad、および A と B ボタン。 |
| GameInputGamepadLayoutButtons | 基本レイアウトに加えて X と Y ボタン、ショルダー ボタン。 |
| GameInputGamepadLayoutStandard | XBOX 360 以降のゲームパッドで見られる標準レイアウト。 |
| GameInputGamepadLayoutElite | XBOX Elite Controller シリーズで見られるレイアウト。 |

## 解説

この列挙型は [GameInputGamePadState](https://docs.xbox.com/ja-jp/reference/input/gameinput/structs/gameinputgamepadstate.md) 構造体で使用されます。値を組み合わせることで、複数のボタンを同時に読み取ることができます。

`GameInputGamepadLeftTriggerButton`、`GameInputGamepadRightTriggerButton`、`GameInputGamepadLeftThumbstickUp`、`GameInputGamepadLeftThumbstickDown`、`GameInputGamepadLeftThumbstickLeft`、`GameInputGamepadLeftThumbstickRight`、`GameInputGamepadRightThumbstickUp`、`GameInputGamepadRightThumbstickDown`、`GameInputGamepadRightThumbstickLeft`、および `GameInputGamepadRightThumbstickRight` は、ほとんどのゲームパッドに搭載されている対応するアナログ軸のデジタル表現です。たとえば、左サムスティックが上方向に完全に押された場合、`GameInputGamepadLeftThumbstickUp` ボタンと `GameInputGamepadLeftThumbstickY` 軸の両方が値 1.0 を表示します。

詳細については、[GameInput readings](https://docs.xbox.com/ja-jp/build/core-features/common/input/overviews/input-readings.md) の [読み取り値からのデータの取得](https://docs.xbox.com/ja-jp/build/core-features/common/input/overviews/input-readings.md#gettingStateSection) セクションを参照してください。

この列挙型は、特定のゲームパッド ボタンのマッピング情報を取得するために [IGameInputMapper::GetGamepadButtonMappingInfo](https://docs.xbox.com/ja-jp/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getgamepadbuttonmappinginfo.md) メソッドと共に使用することもできます。

## 要件

**ヘッダー:** GameInput.h

**サポートされているプラットフォーム:** Windows、XBOX One ファミリ本体、および XBOX Series 本体

## 関連項目

[GameInput の概要](https://docs.xbox.com/ja-jp/build/core-features/common/input/overviews/input-overview.md)\
[GameInput](https://docs.xbox.com/ja-jp/reference/input/gameinput/gameinput_members.md)

## バージョン履歴

| バージョン | 変更内容 |
| - | - |
| **v3** | **16 個の新しいフラグ定数を追加**: `C`、`Z`、`LeftTriggerButton`、`RightTriggerButton`、4 つの `LeftThumbstick` 方向値、4 つの `RightThumbstick` 方向値、`PaddleLeft1`、`PaddleLeft2`、`PaddleRight1`、`PaddleRight2`。また、11 個の複合/レイアウト定数も追加。 |
| **v0** | 導入されました。 |

## 付録: 以前のバージョン

### 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 API メンバー](https://docs.xbox.com/ja-jp/reference/input/gameinput/gameinput_members.md)
- [GameInputMouseButtons](https://docs.xbox.com/ja-jp/reference/input/gameinput/enums/gameinputmousebuttons.md)
- [GetGamepadState](https://docs.xbox.com/ja-jp/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getgamepadstate.md)
- [GameInputSystemButtonCallback](https://docs.xbox.com/ja-jp/reference/input/gameinput/functions/gameinputsystembuttoncallback.md)
- [GameInputRacingWheelButtons](https://docs.xbox.com/ja-jp/reference/input/gameinput/enums/gameinputracingwheelbuttons.md)
