跳轉到主要內容
從輸入讀數擷取系統按鈕 (例如 Guide 和 Share 按鈕) 的狀態。

語法

參數

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

版本歷程記錄

最後修改於 2026年11月6日