> ## 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. Les entrées en arrière-plan s'appliquent à tous les types d'entrée à la fois, y compris les boutons système Guide et Partager signalés au moyen de [IGameInputReading::GetSystemButtonState](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getsystembuttonstate.md). Appelez `EnableBackgroundInput(false)` pour revenir au comportement par défaut.

Ce paramètre est surtout pertinent sur 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-CA/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_setfocuspolicy.md) et l'énumération [GameInputFocusPolicy](https://docs.xbox.com/fr-CA/reference/input/gameinput/deprecated/enums/gameinputfocuspolicy.md) des versions antérieures de GameInput. Les stratégies exclusives au premier plan, qui empêchaient d'autres processus de recevoir les entrées, ne sont pas disponibles dans GameInput v4.

Sur PC, lorsque le runtime GameInput est chargé latéralement avec l'application plutôt qu'installé sur le système, l'activation des entrées en arrière-plan est ignorée. Pour plus d'informations, consultez [Chargement latéral de GameInput](https://docs.xbox.com/fr-CA/build/core-features/common/input/overviews/input-agility-redistributable.md).

> [!NOTE]
>
> De nombreux utilisateurs exécutent des applications de superposition qui utilisent le bouton Guide pour les menus et le 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-CA/build/core-features/common/input/overviews/input-overview.md)\
[Notions fondamentales de GameInput](https://docs.xbox.com/fr-CA/build/core-features/common/input/overviews/input-fundamentals.md)\
[Chargement latéral de GameInput](https://docs.xbox.com/fr-CA/build/core-features/common/input/overviews/input-agility-redistributable.md)\
[IGameInput](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinput/igameinput.md)\
[IGameInput::SetFocusPolicy (déprécié)](https://docs.xbox.com/fr-CA/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_setfocuspolicy.md)

## Historique des versions

| Version | Modifications |
| - | - |
| **v4** | Introduit. |


## Related topics

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