GameInputFocusPolicy
入力デバイスのフォーカス ポリシーを列挙します。
構文
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 を呼び出し、フォーカスがないときにゲームに入力を送信するかどうかを指定します。 既定では、入力はフォーカスがあるかどうかに関係なく、すべてのプロセスにブロードキャストされます。 値を組み合わせることができます。
ゲームが [ガイド] ボタンまたは [共有] ボタンを処理する場合、GameInputExclusiveForegroundGuideButton フラグまたは GameInputExclusiveForegroundShareButton フラグをそれぞれ設定すると、バックグラウンド オーバーレイ アプリケーションがそれらを処理しないようにするのに役立ちます。 たとえば、ボタン自体を使用するゲームで、不要なオーバーレイ メニューやスクリーンショットがポップアップ表示されないようにすることができます。
注意
多くのユーザーは、メニューの [ガイド] ボタンとスクリーンショットの [共有] ボタンを使用するオーバーレイ アプリケーションを使用します。 ユーザーの混乱を避けるために、ゲームでその機能をオーバーライドする必要があるかどうかを検討します。 フォーカス ポリシーは Windows でのみ適用されます。 GameInputFocusPolicy の [ガイド] ボタンと [共有] ボタンの値は、Windows SDK 10.0.26031 Preview GameInput.h に追加され、GDK の今後のリリースに追加される予定です。
詳細については、「GameInput の基礎」を参照してください。
要件
ヘッダー: GameInput.h
サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体