入力デバイスのフォーカス ポリシーを列挙します。
構文
enum GameInputFocusPolicy
{
GameInputDefaultFocusPolicy = 0x00000000,
GameInputDisableBackgroundInput = 0x00000001,
GameInputExclusiveForegroundInput = 0x00000002,
GameInputDisableBackgroundGuideButton = 0x00000004,
GameInputExclusiveForegroundGuideButton = 0x00000008,
GameInputDisableBackgroundShareButton = 0x00000010,
GameInputExclusiveForegroundShareButton = 0x00000020,
GameInputEnableBackgroundInput = 0x00000040
};
定数
| 定数 | 説明 |
|---|---|
| GameInputDefaultFocusPolicy | フォーカスがないときに、入力とシステム ボタンがゲームに送信されないようにします。 これは、入力デバイスの既定のフォーカス ポリシーです。 |
| GameInputDisableBackgroundInput | フォーカスされているときにのみ、入力 (システム ボタンを除く) がゲームに送信されるようにします。 ゲームがフォーカスされていない場合、ユーザーがデバイスを操作していない場合のように、入力デバイスはニュートラルまたは "休止" 状態の報告をゲームに送信します。 |
| GameInputExclusiveForegroundInput | ゲームが受信する入力を GameInput を使用している他のプロセスが確認できないようにします。 この制限は、ゲームがフォーカスされているときにのみ有効であり、システム ボタンには適用されません。 |
| GameInputDisableBackgroundGuideButton | [ガイド] ボタン イベントが、ゲームがフォーカスされているときにのみゲームに送信されるようにします。 ゲームがフォーカスされていない場合、[ガイド] ボタンが押されていないと報告されます。 |
| GameInputExclusiveForegroundGuideButton | GameInput を使用している他のプロセスに、受信した [ガイド] ボタンの押下が表示されないようにします。 この制限は、ゲームがフォーカスされているときにのみ有効です。 |
| GameInputDisableBackgroundShareButton | [共有] ボタン イベントが、ゲームがフォーカスされているときにのみゲームに送信されるようにします。 ゲームがフォーカスされていない場合、[共有] ボタンが押されていないと報告されます。 |
| GameInputExclusiveForegroundShareButton | GameInput を使用している他のプロセスに、受信した [共有] ボタンの押下が表示されないようにします。 この制限は、ゲームがフォーカスされているときにのみ有効です。 |
| GameInputEnableBackgroundInput | フォーカスがない場合でも、入力 (システム ボタンを除く) が常にゲームに送信されるようにします。 |
解説
この列挙は、 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