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

# GameInputFlightStickButtons

> GameInputFlightStickButtons

# GameInputFlightStickButtons

枚举飞行摇杆按钮。

## 语法

```cpp theme={null}
enum GameInputFlightStickButtons
{
    GameInputFlightStickNone           = 0x00000000,
    GameInputFlightStickMenu           = 0x00000001,
    GameInputFlightStickView           = 0x00000002,
    GameInputFlightStickFirePrimary    = 0x00000004,
    GameInputFlightStickFireSecondary  = 0x00000008,
    GameInputFlightStickHatSwitchUp    = 0x00000010,
    GameInputFlightStickHatSwitchDown  = 0x00000020,
    GameInputFlightStickHatSwitchLeft  = 0x00000040,
    GameInputFlightStickHatSwitchRight = 0x00000080,
    GameInputFlightStickA              = 0x00000100,
    GameInputFlightStickB              = 0x00000200,
    GameInputFlightStickX              = 0x00000400,
    GameInputFlightStickY              = 0x00000800,
};
```

## 常量

| 常量 | 说明 |
| - | - |
| GameInputFlightStickNone | 表示未按下任何按钮。 |
| GameInputFlightStickMenu | 表示已按下菜单按钮。 |
| GameInputFlightStickView | 表示已按下视图按钮。 |
| GameInputFlightStickFirePrimary | 表示已按下主开火按钮。 |
| GameInputFlightStickFireSecondary | 表示已按下次开火按钮。 |
| GameInputFlightStickHatSwitchUp | 表示已按下帽形开关的顶部。 |
| GameInputFlightStickHatSwitchDown | 表示已按下帽形开关的底部。 |
| GameInputFlightStickHatSwitchLeft | 表示已按下帽形开关的左侧。 |
| GameInputFlightStickHatSwitchRight | 表示已按下帽形开关的右侧。 |
| GameInputFlightStickA | 表示已按下手柄 A 按钮。 |
| GameInputFlightStickB | 表示已按下手柄 B 按钮。 |
| GameInputFlightStickX | 表示已按下手柄 X 按钮。 |
| GameInputFlightStickY | 表示已按下手柄 Y 按钮。 |

## 备注

此枚举在 [GameInputFlightStickState](https://docs.xbox.com/zh-CN/reference/input/gameinput/structs/gameinputflightstickstate.md) 结构中使用。你可以组合多个值以同时读取多个按钮。

`GameInputFlightStickHatSwitchUp`、`GameInputFlightStickHatSwitchDown`、`GameInputFlightStickHatSwitchLeft` 和 `GameInputFlightStickHatSwitchRight` 是帽形开关向按钮值的转换。对角方向通过同时呈现两个按钮为按下状态来表示，如同游戏手柄上的方向键。帽形开关的中心状态通过这些按钮均未被按下来表示。这些按钮也是使用 [IGameInputMapper::GetFlightStickButtonMappingInfo](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getflightstickbuttonmappinginfo.md) 方法查询帽形开关映射信息的唯一方式。

`GameInputFlightStickA`、`GameInputFlightStickB`、`GameInputFlightStickX` 和 `GameInputFlightStickY` 不属于飞行摇杆映射，而是从游戏手柄按钮报告中复制过来的值。如果没有映射到该设备的游戏手柄，这些值将始终为 0。

有关详细信息，请参阅 [GameInput 读数](https://docs.xbox.com/zh-CN/build/core-features/common/input/overviews/input-readings.md) 中的 [从读数获取数据](https://docs.xbox.com/zh-CN/build/core-features/common/input/overviews/input-readings.md#gettingStateSection) 部分。

此枚举还可与 [IGameInputMapper::GetFlightStickButtonMappingInfo](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getflightstickbuttonmappinginfo.md) 方法配合使用，以检索特定飞行摇杆按钮的映射信息。

## 要求

**标头：** GameInput.h

**支持的平台：** Windows、XBOX One 系列主机和 XBOX Series 主机

## 另请参阅

[GameInput 概述](https://docs.xbox.com/zh-CN/build/core-features/common/input/overviews/input-overview.md)\
[GameInput](https://docs.xbox.com/zh-CN/reference/input/gameinput/gameinput_members.md)

## 版本历史

| 版本 | 变更 |
| - | - |
| **v3** | **新增 8 个常量**：`HatSwitchUp`、`HatSwitchDown`、`HatSwitchLeft`、`HatSwitchRight`、`A`、`B`、`X`、`Y`，用于类手柄按钮。 |
| **v0** | 引入。 |

## 附录：以前的版本

### v0

```cpp theme={null}
enum GameInputFlightStickButtons
{
    GameInputFlightStickNone          = 0x00000000,
    GameInputFlightStickMenu          = 0x00000001,
    GameInputFlightStickView          = 0x00000002,
    GameInputFlightStickFirePrimary   = 0x00000004,
    GameInputFlightStickFireSecondary = 0x00000008,
};
```


## Related topics

- [GameInput API 成员](https://docs.xbox.com/zh-CN/reference/input/gameinput/gameinput_members.md)
- [GetFlightStickState](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getflightstickstate.md)
- [GameInputArcadeStickButtons](https://docs.xbox.com/zh-CN/reference/input/gameinput/enums/gameinputarcadestickbuttons.md)
- [GameInputKind](https://docs.xbox.com/zh-CN/reference/input/gameinput/enums/gameinputkind.md)
- [GameInputLabel](https://docs.xbox.com/zh-CN/reference/input/gameinput/enums/gameinputlabel.md)