> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GameInputFocusPolicy

> GameInputFocusPolicy

# GameInputFocusPolicy

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

<a id="syntaxSection" />

## Syntaxe

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

<a id="constantsSection" />

## 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. |

<a id="remarksSection" />

## Remarques

Cette énumération est utilisée par la méthode [IGameInput::SetFocusPolicy](/fr-CA/reference/input/gameinput/interfaces/igameinput/methods/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.

<Note>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.</Note>

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](/fr-CA/build/core-features/common/input/overviews/input-fundamentals).

<a id="requirementsSection" />

## Configuration requise

**En-tête :** GameInput.h

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

<a id="seealsoSection" />

## Voir aussi

[Vue d'ensemble de GameInput](/fr-CA/build/core-features/common/input/overviews/input-overview)<br />
[GameInput](/fr-CA/reference/input/gameinput/gameinput_members)

## 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

```cpp theme={null}
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.


## Related topics

- [GameInputFocusPolicy](/reference/input/gameinput/enums/gameinputfocuspolicy.md)
- [IGameInput::SetFocusPolicy](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_setfocuspolicy.md)
- [IGameInput::RegisterSystemButtonCallback](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback.md)
- [GameInput](/reference/input/gameinput/gameinput_members.md)