GameInputFocusPolicy

Énumère les stratégies de focus d’un périphérique d’entrée.

Syntaxe

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

Constantes

Constante	Description
GameInputDefaultFocusPolicy	Garantit que les entrées et les boutons système ne sont envoyés au processus que lorsqu’il a le focus.
GameInputExclusiveForegroundInput	Empêche les autres processus utilisant GameInput de voir les entrées qu’il reçoit. Cette restriction s’applique uniquement lorsque le jeu a le focus et ne s’applique pas aux boutons système.
GameInputExclusiveForegroundGuideButton	Empêche les autres processus utilisant GameInput de voir les pressions du bouton Guide qu’il reçoit. Cette restriction s’applique uniquement lorsque le jeu a le focus.
GameInputExclusiveForegroundShareButton	Empêche les autres processus utilisant GameInput de voir les pressions du bouton Partager qu’il reçoit. Cette restriction s’applique uniquement lorsque le jeu a le focus.
GameInputEnableBackgroundInput	Garantit que les entrées sont toujours envoyées au jeu, même lorsqu’il n’a pas le focus. Cela n’inclut pas les boutons système, qui nécessitent l’utilisation de leurs indicateurs de stratégie de focus respectifs.
GameInputEnableBackgroundGuideButton	Garantit que les événements du bouton Guide sont envoyés au jeu même lorsqu’il n’a pas le focus. Les pressions du bouton Guide ne seront toujours pas envoyées à l’application lorsque le processus ayant le focus dispose d’un accès exclusif.
GameInputEnableBackgroundShareButton	Garantit que les événements du bouton Partager sont envoyés au jeu même lorsqu’il n’a pas le focus. Les pressions du bouton Partager ne seront toujours pas envoyées à l’application lorsque le processus ayant le focus dispose d’un accès exclusif.

Remarques

Cette énumération est utilisée par la méthode IGameInput::SetFocusPolicy. Appelez SetFocusPolicy pour indiquer si les entrées sont envoyées à un jeu lorsqu’il n’a pas le focus. Par défaut, GameInput ne fournit pas d’entrées en arrière-plan. Les valeurs peuvent être combinées. Si le jeu traite les boutons Guide ou Partager, la définition respective des indicateurs GameInputExclusiveForegroundGuideButton ou GameInputExclusiveForegroundShareButton peut aider à garantir que les applications de superposition en arrière-plan ne les traitent pas également. Par exemple, cela peut empêcher l’apparition non désirée de menus de superposition ou de captures d’écran par-dessus un jeu qui entend utiliser lui-même ces boutons.

De nombreux utilisateurs se servent d’applications de superposition qui utilisent le bouton Guide pour les menus et le bouton Partager pour les captures d’écran. Déterminez si votre jeu a réellement besoin de remplacer cette fonctionnalité afin d’éviter de semer la confusion chez les utilisateurs.

La stratégie de focus s’applique uniquement sur Windows. Les valeurs des boutons Guide et Partager de GameInputFocusPolicy ont été ajoutées dans le fichier GameInput.h de la préversion du Windows SDK 10.0.26031 et seront ajoutées dans une version future du GDK. Pour plus d’information, consultez Notions fondamentales de GameInput.

Configuration requise

En-tête : GameInput.h Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series

Voir aussi

Vue d’ensemble de GameInput
GameInput

Historique des versions

Version	Modifications
v2	Supprimé `DisableBackgroundInput` (0x1) et `DisableBackgroundShareButton` (0x10). Ajouté `EnableBackgroundGuideButton` (0x80) et `EnableBackgroundShareButton` (0x100).
v0	Introduit.

Annexe : versions précédentes

v0

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

Notez que les indicateurs DisableBackgroundInput (0x1) et DisableBackgroundShareButton (0x10) ont été supprimés dans la v2. Les applications GameInput n’ont par défaut aucune entrée en arrière-plan; ces indicateurs étaient donc redondants. Les indicateurs EnableBackgroundGuideButton (0x80) et EnableBackgroundShareButton (0x100) ont été ajoutés dans la v2 pour permettre aux applications d’indiquer leur intention de recevoir des entrées en arrière-plan.

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

GameInputFocusPolicy

GameInputFocusPolicy

Syntaxe

Constantes

Remarques

Configuration requise

Voir aussi

Historique des versions

Annexe : versions précédentes

v0

​GameInputFocusPolicy

​Syntaxe

​Constantes

​Remarques

​Configuration requise

​Voir aussi

​Historique des versions

​Annexe : versions précédentes

​v0

GameInputFocusPolicy

Syntaxe

Constantes

Remarques

Configuration requise

Voir aussi

Historique des versions

Annexe : versions précédentes

v0