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

<a id="remarksSection" />

## Remarques

Cette énumération est utilisée par la méthode [IGameInput::SetFocusPolicy](/fr/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 de menus de superposition ou de captures d'écran indésirables par-dessus un jeu qui souhaite utiliser lui-même ces boutons.

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

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](/fr/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/build/core-features/common/input/overviews/input-overview)<br />
[GameInput](/fr/reference/input/gameinput/gameinput_members)

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

```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'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.


## Related topics

- [IGameInput::SetFocusPolicy](/fr/reference/input/gameinput/interfaces/igameinput/methods/igameinput_setfocuspolicy.md)
- [IGameInput::RegisterSystemButtonCallback](/fr/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback.md)
- [GameInput](/fr/reference/input/gameinput/gameinput_members.md)
- [Portage de XInput vers GameInput](/fr/build/core-features/common/input/porting/input-porting-xinput.md)
- [Notions fondamentales de GameInput](/fr/build/core-features/common/input/overviews/input-fundamentals.md)