構文
パラメーター
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 でバックグラウンド入力が有効になっていない限り、システム ボタン入力はアプリケーションにフォーカスがある間のみ配信されます。
次の例は、ガイド ボタンの新しい押下を検出する方法を示しています。
要件
ヘッダー: GameInput.h ライブラリ: gameinput.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体、XBOX Series 本体関連項目
GameInput の概要IGameInputReading
GameInputSystemButtons
GameInputKind
IGameInput::EnableBackgroundInput
IGameInputDevice::GetSupportedSystemButtons
