メインコンテンツへスキップ
ガイド ボタンや共有ボタンなどのシステム ボタンの状態を入力読み取りから取得します。

構文

パラメーター

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

バージョン履歴

最終更新日 2026年11月6日