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

# IGameInput::EnableBackgroundInput

> Active ou désactive la transmission des entrées à l'application lorsqu'elle est en arrière-plan.

Active ou désactive la transmission des entrées à l'application lorsqu'elle est en arrière-plan.

## Syntaxe

```cpp theme={null}
void EnableBackgroundInput(
    bool enable
);
```

### Paramètres

*enable*   \_In\_\
Type : bool

`true` pour recevoir les entrées lorsque l'application n'a pas le focus ; `false` pour recevoir les entrées uniquement lorsque l'application a le focus.

### Valeur de retour

Type : void

Cette méthode ne retourne aucune valeur.

## Remarques

Par défaut, GameInput transmet les entrées à une application uniquement lorsqu'elle est au premier plan et qu'elle a le focus. Appelez `EnableBackgroundInput(true)` pour recevoir également les entrées lorsqu'une autre application a le focus. L'entrée en arrière-plan s'applique simultanément à tous les types d'entrée, y compris les boutons système Guide et Partager signalés via [IGameInputReading::GetSystemButtonState](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getsystembuttonstate.md). Appelez `EnableBackgroundInput(false)` pour revenir au comportement par défaut.

Ce paramètre concerne principalement Windows, où plusieurs applications peuvent s'exécuter côte à côte et où le focus peut passer de l'une à l'autre.

Cette méthode remplace la méthode [IGameInput::SetFocusPolicy](https://docs.xbox.com/fr/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_setfocuspolicy.md) et l'énumération [GameInputFocusPolicy](https://docs.xbox.com/fr/reference/input/gameinput/deprecated/enums/gameinputfocuspolicy.md) des versions antérieures de GameInput. Les stratégies de premier plan exclusif, qui empêchaient d'autres processus de recevoir des entrées, ne sont pas disponibles dans GameInput v4.

Sur PC, lorsque le runtime GameInput est chargé de manière indépendante avec l'application au lieu d'être installé sur le système, l'activation de l'entrée en arrière-plan est ignorée. Pour plus d'informations, consultez [Chargement indépendant de GameInput](https://docs.xbox.com/fr/build/core-features/common/input/overviews/input-agility-redistributable.md).

> [!NOTE]
>
> De nombreux utilisateurs exécutent 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 application a besoin de traiter les boutons système lorsqu'elle est en arrière-plan.

## Configuration requise

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

**Bibliothèque :** gameinput.lib

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

## Voir aussi

[Vue d'ensemble de GameInput](https://docs.xbox.com/fr/build/core-features/common/input/overviews/input-overview.md)\
[Notions fondamentales de GameInput](https://docs.xbox.com/fr/build/core-features/common/input/overviews/input-fundamentals.md)\
[Chargement indépendant de GameInput](https://docs.xbox.com/fr/build/core-features/common/input/overviews/input-agility-redistributable.md)\
[IGameInput](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinput/igameinput.md)\
[IGameInput::SetFocusPolicy (déconseillé)](https://docs.xbox.com/fr/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_setfocuspolicy.md)

## Historique des versions

| Version | Modifications |
| - | - |
| **v4** | Introduite. |


## Related topics

- [IGameInput::SetFocusPolicy (déconseillé)](https://docs.xbox.com/fr/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_setfocuspolicy.md)
- [GameInputFocusPolicy (déconseillé)](https://docs.xbox.com/fr/reference/input/gameinput/deprecated/enums/gameinputfocuspolicy.md)
- [IGameInputReading::GetSystemButtonState](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getsystembuttonstate.md)
- [Chargement indépendant de GameInput](https://docs.xbox.com/fr/build/core-features/common/input/overviews/input-agility-redistributable.md)
- [Membres obsolètes de l'API GameInput](https://docs.xbox.com/fr/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)