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

# GAMEPAD_BUTTONS 列舉

> GAMEPAD_BUTTONS 列舉

# GAMEPAD\_BUTTONS 列舉

控制器按鈕識別碼旗標。

**GAMEPAD\_BUTTONS** 值用於 [GAMEPAD\_REPORT](/zh-TW/reference/tools/xtf/xtfinput/structures/GAMEPAD_REPORT-xtfinput-xbox-windows-t) 中，以指出目前按下了哪些按鈕。

<a id="syntaxSection" />

## 語法

```cpp theme={null}
typedef enum GAMEPAD_BUTTONS
{
    RIGHT_THUMBSTICK = 0x8000,
    LEFT_THUMBSTICK = 0x4000,
    RIGHT_SHOULDER = 0x2000,
    LEFT_SHOULDER = 0x1000,
    DPAD_RIGHT = 0x800,
    DPAD_LEFT = 0x400,
    DPAD_DOWN = 0x200,
    DPAD_UP = 0x100,
    Y = 0x80,
    X = 0x40,
    B = 0x20,
    A = 0x10,
    VIEW = 0x8,
    MENU = 0x4,
    NEXUS = 0x2,
    ENROLL = 0x1,
    NONE = 0
} GAMEPAD_BUTTONS, *PGAMEPAD_BUTTONS;  
```

<a id="ID4E6C" />

## 常數

| 常數 | 描述 |
| - | - |
| RIGHT\_THUMBSTICK | 右類比搖桿 |
| LEFT\_THUMBSTICK | 左類比搖桿 |
| RIGHT\_SHOULDER | 右肩按鈕 |
| LEFT\_SHOULDER | 左肩按鈕 |
| DPAD\_RIGHT | 方向鍵右按鈕 |
| DPAD\_LEFT | 方向鍵左按鈕 |
| DPAD\_DOWN | 方向鍵下按鈕 |
| DPAD\_UP | 方向鍵上按鈕。 |
| Y | Y 按鈕 |
| X | X 按鈕 |
| B | B 按鈕 |
| A | A 按鈕 |
| VIEW | 檢視按鈕 |
| MENU | 功能表按鈕 |
| NEXUS | Nexus 按鈕 |
| ENROLL | 註冊按鈕 |
| NONE | 表示目前未按下任何按鈕的值。 |

<a id="requirements" />

## 備註

**GAMEPAD\_BUTTONS** 是旗標列舉，因此可將這些值組合成單一值，以表示同時按下多個按鈕。**GAMEPAD\_BUTTONS** 是 [GAMEPAD\_REPORT](/zh-TW/reference/tools/xtf/xtfinput/structures/GAMEPAD_REPORT-xtfinput-xbox-windows-t) 結構的成員。它會與板機和搖桿值等非按鈕輸入的其他資訊結合，以表示遊戲控制器輸入裝置的狀態。這些狀態會使用 [IXtfInputClient](/zh-TW/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t) 傳送至主機。

## 需求

**標頭：** xtfinput.h

**程式庫：** xtfinput.lib

**支援的平台：** Windows (適用於 XBOX 主機工具)

## 另請參閱

[XtfInput](/zh-TW/reference/tools/xtf/xtfinput/xtfinput-xbox-microsoft-n)\
[GAMEPAD\_REPORT](/zh-TW/reference/tools/xtf/xtfinput/structures/GAMEPAD_REPORT-xtfinput-xbox-windows-t)\
[IXtfInputClient](/zh-TW/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t)


## Related topics

- [GameInput](/zh-TW/reference/input/gameinput/gameinput_members.md)
- [GameInputGamepadButtons](/zh-TW/reference/input/gameinput/enums/gameinputgamepadbuttons.md)
- [GAMEPAD_MORE_BUTTONS](/zh-TW/reference/tools/xtf/xtfinput/enumerations/gamepad_more_buttons.md)
- [IGameInputMapper::GetGamepadButtonMapping](/zh-TW/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getgamepadbuttonmappinginfo.md)
- [GAMEPAD_REPORT 結構](/zh-TW/reference/tools/xtf/xtfinput/structures/GAMEPAD_REPORT-xtfinput-xbox-windows-t.md)