GameInputFocusPolicy (非推奨)

非推奨。 この列挙型は GameInput v4 で削除され、現在の API では利用できません。代わりに IGameInput::EnableBackgroundInput を使用してください。

入力デバイスのフォーカスポリシーを列挙します。

構文

enum GameInputFocusPolicy
{
    GameInputDefaultFocusPolicy             = 0x00000000,
    GameInputExclusiveForegroundInput       = 0x00000002,
    GameInputExclusiveForegroundGuideButton = 0x00000008,
    GameInputExclusiveForegroundShareButton = 0x00000020,
    GameInputEnableBackgroundInput          = 0x00000040,
    GameInputEnableBackgroundGuideButton    = 0x00000080,
    GameInputEnableBackgroundShareButton    = 0x00000100
};

定数

定数	説明
GameInputDefaultFocusPolicy	入力とシステムボタンが、プロセスにフォーカスがあるときにのみそのプロセスに送信されるようにします。
GameInputExclusiveForegroundInput	GameInput を使用する他のプロセスが、このプロセスが受け取る入力を参照できないようにします。この制限はゲームにフォーカスがある場合にのみ有効で、システムボタンには適用されません。
GameInputExclusiveForegroundGuideButton	GameInput を使用する他のプロセスが、このプロセスが受け取る Guide ボタンの押下を参照できないようにします。この制限はゲームにフォーカスがある場合にのみ有効です。
GameInputExclusiveForegroundShareButton	GameInput を使用する他のプロセスが、このプロセスが受け取る Share ボタンの押下を参照できないようにします。この制限はゲームにフォーカスがある場合にのみ有効です。
GameInputEnableBackgroundInput	ゲームにフォーカスがない場合でも、入力が常にゲームに送信されるようにします。これにはシステムボタンは含まれません。システムボタンには、それぞれのフォーカスポリシーフラグを使用する必要があります。
GameInputEnableBackgroundGuideButton	フォーカスがない場合でも、Guide ボタンのイベントがゲームに送信されるようにします。ただし、フォーカスのあるプロセスが排他アクセスしている場合、Guide ボタンの押下はアプリケーションに送信されません。
GameInputEnableBackgroundShareButton	フォーカスがない場合でも、Share ボタンのイベントがゲームに送信されるようにします。ただし、フォーカスのあるプロセスが排他アクセスしている場合、Share ボタンの押下はアプリケーションに送信されません。

解説

この列挙型は IGameInput::SetFocusPolicy メソッドで使用されます。SetFocusPolicy を呼び出して、ゲームにフォーカスがないときに入力をゲームに送信するかどうかを指定します。既定では、GameInput はバックグラウンド入力を提供しません。値は組み合わせることができます。ゲームが Guide ボタンまたは Share ボタンを処理する場合は、それぞれ GameInputExclusiveForegroundGuideButton フラグまたは GameInputExclusiveForegroundShareButton フラグを設定すると、バックグラウンドのオーバーレイアプリケーションがそれらのボタンを処理しないようにするのに役立ちます。たとえば、ボタンを独自に使用するゲームの上に、不要なオーバーレイメニューやスクリーンショットが表示されるのを防ぐことができます。

多くのユーザーは、Guide ボタンをメニューに、Share ボタンをスクリーンショットに使用するオーバーレイアプリケーションを使用しています。ユーザーの混乱を避けるため、ゲームでその機能をオーバーライドする必要があるかどうかを検討してください。

フォーカスポリシーは Windows でのみ適用されます。GameInputFocusPolicy の Guide ボタンと Share ボタンの値は Windows SDK 10.0.26031 Preview の GameInput.h で追加されたもので、今後の GDK リリースで追加される予定です。詳細については、「GameInput の基礎」を参照してください。

要件

ヘッダー: GameInput.h サポートされているプラットフォーム: Windows、XBOX One ファミリー本体、XBOX Series 本体

バージョン履歴

バージョン	変更内容
v4	削除されました。
v2	`DisableBackgroundInput` (0x1) と `DisableBackgroundShareButton` (0x10) が削除されました。`EnableBackgroundGuideButton` (0x80) と `EnableBackgroundShareButton` (0x100) が追加されました。
v0	導入されました。

付録: 以前のバージョン

v0

enum GameInputFocusPolicy
{
    GameInputDefaultFocusPolicy             = 0x00000000,
    GameInputDisableBackgroundInput         = 0x00000001,
    GameInputExclusiveForegroundInput       = 0x00000002,
    GameInputExclusiveForegroundGuideButton = 0x00000008,
    GameInputDisableBackgroundShareButton   = 0x00000010,
    GameInputExclusiveForegroundShareButton = 0x00000020,
    GameInputEnableBackgroundInput          = 0x00000040,
};

DisableBackgroundInput (0x1) フラグと DisableBackgroundShareButton (0x10) フラグは v2 で削除されたことに注意してください。GameInput アプリケーションは既定でバックグラウンド入力を受け取らないため、これらのフラグは冗長でした。EnableBackgroundGuideButton (0x80) フラグと EnableBackgroundShareButton (0x100) フラグは、アプリケーションがバックグラウンドで入力を受け取る意図を登録できるように v2 で追加されました。

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

Additional pages

Reference

構文

定数

解説

要件

関連項目

バージョン履歴

付録: 以前のバージョン

v0

​構文

​定数

​解説

​要件

​関連項目

​バージョン履歴

​付録: 以前のバージョン

​v0

構文

定数

解説

要件

関連項目

バージョン履歴

付録: 以前のバージョン

v0