語法
參數
buttons _Out_類型:GameInputSystemButtons* 接收在此讀數中按下的系統按鈕集合。
傳回值
類型:bool 如果讀數包含系統按鈕狀態,則傳回true。如果不包含,則傳回 false,在此情況下 buttons 會設定為 GameInputSystemButtonNone。
備註
在 GameInput v4 中,系統按鈕是一般的輸入類型GameInputKindSystemButton。來自具有系統按鈕之裝置的每個讀數,都會在 IGameInputReading::GetInputKind 中包含 GameInputKindSystemButton,而 GetSystemButtonState 會以 IGameInputReading::GetGamepadState 傳回遊戲台按鈕狀態的相同方式,傳回這些按鈕的目前狀態。若要找出裝置具有哪些系統按鈕,請呼叫 IGameInputDevice::GetSupportedSystemButtons。
讀數會回報哪些按鈕處於按下狀態,而不是按下或放開事件。若要偵測按下或放開,請將狀態與前一個讀數的狀態進行比較。
此方法取代了舊版 GameInput 中的 IGameInput::RegisterSystemButtonCallback 方法。若要接收系統按鈕輸入,請搭配 GameInputKindSystemButton 使用 IGameInput::RegisterReadingCallback,或使用 IGameInput::GetCurrentReading 進行輪詢。
只有在應用程式處於焦點時才會傳遞系統按鈕輸入,除非已使用 IGameInput::EnableBackgroundInput 啟用背景輸入。
下列範例示範如何偵測 Guide 按鈕的新按下動作。
需求
標頭: GameInput.h 程式庫: gameinput.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機另請參閱
GameInput 概觀IGameInputReading
GameInputSystemButtons
GameInputKind
IGameInput::EnableBackgroundInput
IGameInputDevice::GetSupportedSystemButtons
