入力デバイスのフォーカス ポリシーを列挙します。
構文
typedef enum GameInputFocusPolicy
{
GameInputDefaultFocusPolicy = 0x00000000,
GameInputDisableBackgroundInput = 0x00000001,
GameInputExclusiveForegroundInput = 0x00000002,
GameInputDisableBackgroundGuideButton = 0x00000004,
GameInputExclusiveForegroundGuideButton = 0x00000008,
GameInputDisableBackgroundShareButton = 0x00000010,
GameInputExclusiveForegroundShareButton = 0x00000020
} GameInputFocusPolicy
定数
| 定数 | 説明 |
|---|---|
| GameInputDefaultFocusPolicy | フォーカスされていない場合でも、入力とシステム ボタンが常にゲームに送信されるようにします。 これは、入力デバイスの既定のフォーカス ポリシーです。 |
| GameInputDisableBackgroundInput | フォーカスされているときにのみ、入力 (システム ボタンを除く) がゲームに送信されるようにします。 ゲームがフォーカスされていない場合、ユーザーがデバイスを操作していない場合のように、入力デバイスはニュートラルまたは "休止" 状態の報告をゲームに送信します。 |
| GameInputExclusiveForegroundInput | ゲームが受信する入力を GameInput を使用している他のプロセスが確認できないようにします。 この制限は、ゲームがフォーカスされているときにのみ有効であり、システム ボタンには適用されません。 |
| GameInputDisableBackgroundGuideButton | [ガイド] ボタン イベントが、ゲームがフォーカスされているときにのみゲームに送信されるようにします。 ゲームがフォーカスされていない場合、[ガイド] ボタンが押されていないと報告されます。 |
| GameInputExclusiveForegroundGuideButton | GameInput を使用している他のプロセスに、受信した [ガイド] ボタンの押下が表示されないようにします。 この制限は、ゲームがフォーカスされているときにのみ有効です。 |
| GameInputDisableBackgroundShareButton | [共有] ボタン イベントが、ゲームがフォーカスされているときにのみゲームに送信されるようにします。 ゲームがフォーカスされていない場合、[共有] ボタンが押されていないと報告されます。 |
| GameInputExclusiveForegroundShareButton | GameInput を使用している他のプロセスに、受信した [共有] ボタンの押下が表示されないようにします。 この制限は、ゲームがフォーカスされているときにのみ有効です。 |
解説
この列挙は、 IGameInput::SetFocusPolicy メソッドで使用されます。
SetFocusPolicy を呼び出し、フォーカスがないときにゲームに入力を送信するかどうかを指定します。 以前のバージョンの GameInput では、既定でバックグラウンドのすべてのアプリケーションに入力が送信されていました。 GameInput v2 以降では、古い v0 および v1 インターフェイスに対しても、既定では入力は送信されません。 バックグラウンド入力を受信するようにアプリケーションを登録するには、SetFocusPolicy を通じてフォーカス ポリシーを上記の値のいずれかに明示的に設定します。 値を組み合わせることができます。
ゲームが [ガイド] ボタンまたは [共有] ボタンを処理する場合、GameInputExclusiveForegroundGuideButton フラグまたは GameInputExclusiveForegroundShareButton フラグをそれぞれ設定すると、バックグラウンド オーバーレイ アプリケーションがそれらを処理しないようにするのに役立ちます。 たとえば、ボタン自体を使用するゲームで、不要なオーバーレイ メニューやスクリーンショットがポップアップ表示されないようにすることができます。
注意
多くのユーザーは、メニューの [ガイド] ボタンとスクリーンショットの [共有] ボタンを使用するオーバーレイ アプリケーションを使用します。 ユーザーの混乱を避けるために、ゲームでその機能をオーバーライドする必要があるかどうかを検討します。 フォーカス ポリシーは Windows でのみ適用されます。 GameInputFocusPolicy の [ガイド] ボタンと [共有] ボタンの値は、Windows SDK 10.0.26031 Preview GameInput.h に追加され、GDK の今後のリリースに追加される予定です。
詳細については、「GameInput の基礎」を参照してください。
要件
ヘッダー: GameInput.h
サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体