语法
参数
buttons _Out_类型:GameInputSystemButtons* 接收在此读数中处于按下状态的系统按钮集合。
返回值
类型:bool 如果读数包含系统按钮状态,则返回true。如果不包含,则返回 false,在这种情况下,buttons 设置为 GameInputSystemButtonNone。
备注
在 GameInput v4 中,系统按钮是一种普通的输入类型,即GameInputKindSystemButton。来自具有系统按钮的设备的每个读数都会在 IGameInputReading::GetInputKind 中包含 GameInputKindSystemButton,并且 GetSystemButtonState 返回这些按钮当前状态的方式,与 IGameInputReading::GetGamepadState 返回游戏手柄按钮状态的方式相同。若要了解设备具有哪些系统按钮,请调用 IGameInputDevice::GetSupportedSystemButtons。
读数报告的是哪些按钮处于按下状态,而不是按下或释放事件。若要检测按下或释放,请将该状态与上一个读数的状态进行比较。
此方法取代了早期 GameInput 版本中的 IGameInput::RegisterSystemButtonCallback 方法。若要接收系统按钮输入,请将 IGameInput::RegisterReadingCallback 与 GameInputKindSystemButton 一起使用,或者使用 IGameInput::GetCurrentReading 进行轮询。
只有在应用程序具有焦点时才会传送系统按钮输入,除非已使用 IGameInput::EnableBackgroundInput 启用后台输入。
以下示例演示如何检测 Guide 按钮的新按下操作。
要求
头文件: GameInput.h 库: gameinput.lib 支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机另请参阅
GameInput 概述IGameInputReading
GameInputSystemButtons
GameInputKind
IGameInput::EnableBackgroundInput
IGameInputDevice::GetSupportedSystemButtons
