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 n’est en vigueur que 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 appuis sur le bouton Guide qu’il reçoit. Cette restriction n’est en vigueur que lorsque le jeu a le focus.
GameInputExclusiveForegroundShareButton	Empêche les autres processus utilisant GameInput de voir les appuis sur le bouton Partager qu’il reçoit. Cette restriction n’est en vigueur que 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 appuis sur le bouton Guide ne sont toujours pas envoyés à 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 appuis sur le bouton Partager ne sont toujours pas envoyés à 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 de menus de superposition ou de captures d’écran indésirables par-dessus un jeu qui souhaite utiliser lui-même ces boutons.

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

La stratégie de focus ne s’applique que sous Windows. Les valeurs des boutons Guide et Partager de GameInputFocusPolicy ont été ajoutées dans le fichier GameInput.h du Windows SDK 10.0.26031 Preview et seront ajoutées dans une future version du GDK. Pour plus d’informations, 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	Suppression de `DisableBackgroundInput` (0x1) et `DisableBackgroundShareButton` (0x10). Ajout de `EnableBackgroundGuideButton` (0x80) et `EnableBackgroundShareButton` (0x100).
v0	Introduction.

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’utilisent 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’enregistrer 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