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

> GAMEPAD_BUTTONS Enumeration

# GAMEPAD\_BUTTONS Enumeration

控制器按钮标识符标志。

**GAMEPAD\_BUTTONS** 值在 [GAMEPAD\_REPORT](/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](/reference/tools/xtf/xtfinput/structures/GAMEPAD_REPORT-xtfinput-xbox-windows-t) 结构的成员。它与有关非按钮输入（例如扳机键和摇杆值）的附加信息相结合，用于表示游戏手柄输入设备的状态。这些状态使用 [IXtfInputClient](/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t) 发送到主机。

## 要求

**头文件：** xtfinput.h

**库：** xtfinput.lib

**支持的平台：** Windows（用于 XBOX 主机工具）

## 另请参阅

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


## Related topics

- [GAMEPAD_MORE_BUTTONS](/zh-CN/reference/tools/xtf/xtfinput/enumerations/gamepad_more_buttons.md)
- [GameInputGamepadButtons](/zh-CN/reference/input/gameinput/enums/gameinputgamepadbuttons.md)
- [GAMEPAD_REPORT structure](/zh-CN/reference/tools/xtf/xtfinput/structures/GAMEPAD_REPORT-xtfinput-xbox-windows-t.md)
- [GAMEPAD_REPORT_EX](/zh-CN/reference/tools/xtf/xtfinput/structures/gamepad_report_ex.md)
- [IXtfInputClient::SendGamepadReport Method](/zh-CN/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/sendgamepadreport-ixtfinputclient-xtfinput-xbox-windows-m.md)