枚举游戏板按钮，包括方向键 (方向键) 和轴到按钮的转换。
语法
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 | 指示按下方向键的顶部部分。 |
| GameInputGamepadDPadDown | 指示按下 D-pad 的底部部分。 |
| GameInputGamepadDPadLeft | 指示按下 D 键的左侧部分。 |
| GameInputGamepadDPadRight | 指示按下方向键的右侧部分。 |
| GameInputGamepadLeftShoulder | 指示按下左肩按钮。 |
| GameInputGamepadRightShoulder | 指示按下右肩按钮。 |
| GameInputGamepadLeftTriggerButton | 指示按下左侧触发器按钮。 |
| GameInputGamepadRightTriggerButton | 指示按下右侧触发器按钮。 |
| GameInputGamepadLeftThumbstick | 指示按下左纵杆。 |
| GameInputGamepadLeftThumbstickUp | 指示左纵杆向上指向。 |
| GameInputGamepadLeftThumbstickDown | 指示左纵杆向下指向。 |
| GameInputGamepadLeftThumbstickLeft | 指示左纵杆指向左侧。 |
| GameInputGamepadLeftThumbstickRight | 指示左纵杆指向右侧。 |
| GameInputGamepadRightThumbstick | 指示按下右侧纵杆。 |
| GameInputGamepadRightThumbstickUp | 指示右纵杆向上指向。 |
| GameInputGamepadRightThumbstickDown | 指示右纵杆向下指。 |
| GameInputGamepadRightThumbstickLeft | 指示右纵杆指向左侧。 |
| GameInputGamepadRightThumbstickRight | 指示右侧纵杆指向右侧。 |
| GameInputGamepadPaddleLeft1 | 指示按下第一个左划桨按钮。 |
| GameInputGamepadPaddleLeft2 | 指示按下第二个左桨按钮。 |
| GameInputGamepadPaddleRight1 | 指示按下第一个右桨按钮。 |
| GameInputGamepadPaddleRight2 | 指示按下第二个右桨按钮。 |
游戏板模块
模块表示通常位于一起的游戏板元素的分组。
| 常量 | 说明 |
|---|---|
| GameInputGamepadModuleSystemDuo | 菜单和视图按钮。 |
| GameInputGamepadModuleDpad | 方向键按钮 (向上、向下、向左、向右) 。 |
| GameInputGamepadModuleShoulders | 左肩和右肩按钮。 |
| GameInputGamepadModuleTriggers | 左触发器和右触发器。 |
| GameInputGamepadModuleThumbsticks | 左右纵杆。 |
| GameInputGamepadModulePaddles2 | 两个拳头桨按钮 (左1和右1) 。 |
| GameInputGamepadModulePaddles4 | 所有四个划桨按钮 (左 1、左 2、右 1、右 2) 。 |
游戏板布局
常见的游戏板布局。
| 常量 | 说明 |
|---|---|
| GameInputGamepadLayoutBasic | 系统二人 (菜单并查看) 、D-pad 以及 A 和 B 按钮。 |
| GameInputGamepadLayoutButtons | 基本布局加上 X 和 Y 按钮和肩部按钮。 |
| GameInputGamepadLayoutStandard | Standard自 Xbox 360 以来在游戏板上找到的布局。 |
| GameInputGamepadLayoutElite | 在 Xbox Elite 控制器系列上找到的布局。 |
备注
此枚举用于 GameInputGamePadState 结构。 通过将值合并，可以同时读取多个按钮。
GameInputGamepadLeftTriggerButton、 GameInputGamepadRightTriggerButton、 GameInputGamepadLeftThumbstickUp、 GameInputGamepadLeftThumbstickDown、 GameInputGamepadLeftThumbstickLeft、 GameInputGamepadLeftThumbstickRight、 GameInputGamepadRightThumbstickUp、 GameInputGamepadRightThumbstickDown、 GameInputGamepadRightThumbstickLeft、 和 GameInputGamepadRightThumbstickRight 是大多数游戏板上找到的相应模拟轴的数字表示形式。 例如，如果左纵杆完全向上推，按钮 GameInputGamepadLeftThumbstickUp 和 GameInputGamepadLeftThumbstickY 轴都将显示值 1.0。
有关详细信息，请参阅 GameInput 读数中的从读数中获取数据部分。
此外，还可以将此枚举与 IGameInputMapper：：GetGamepadButtonMappingInfo 方法一起使用，以检索特定游戏板按钮的映射信息。
要求
头文件：GameInput.h
支持平台：Windows、Xbox One 系列主机和 Xbox Series 主机