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

> Habilita ou desabilita a entrega de entrada ao aplicativo enquanto ele está em segundo plano.

Habilita ou desabilita a entrega de entrada ao aplicativo enquanto ele está em segundo plano.

## Sintaxe

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

### Parâmetros

*enable*   \_In\_\
Tipo: bool

`true` para receber entrada enquanto o aplicativo não tem o foco; `false` para receber entrada somente enquanto o aplicativo tem o foco.

### Valor retornado

Tipo: void

Este método não retorna um valor.

## Comentários

Por padrão, o GameInput entrega entrada a um aplicativo somente enquanto ele está em primeiro plano e tem o foco. Chame `EnableBackgroundInput(true)` para também receber entrada enquanto outro aplicativo tem o foco. A entrada em segundo plano se aplica a todos os tipos de entrada de uma só vez, incluindo os botões do sistema Guia e Compartilhar, que são relatados por meio de [IGameInputReading::GetSystemButtonState](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getsystembuttonstate.md). Chame `EnableBackgroundInput(false)` para voltar ao comportamento padrão.

Essa configuração é relevante principalmente no Windows, onde vários aplicativos podem ser executados lado a lado e o foco pode alternar entre eles.

Este método substitui o método [IGameInput::SetFocusPolicy](https://docs.xbox.com/pt-BR/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_setfocuspolicy.md) e a enumeração [GameInputFocusPolicy](https://docs.xbox.com/pt-BR/reference/input/gameinput/deprecated/enums/gameinputfocuspolicy.md) de versões anteriores do GameInput. As políticas exclusivas de primeiro plano, que impediam outros processos de receber entrada, não estão disponíveis no GameInput v4.

No PC, quando o runtime do GameInput é distribuído via sideload com o aplicativo, em vez de instalado no sistema, a habilitação da entrada em segundo plano é ignorada. Para obter mais informações, confira [Sideload do GameInput](https://docs.xbox.com/pt-BR/build/core-features/common/input/overviews/input-agility-redistributable.md).

> [!NOTE]
>
> Muitos usuários executam aplicativos de sobreposição que usam o botão Guia para menus e o botão Compartilhar para capturas de tela. Avalie se o seu aplicativo precisa processar os botões do sistema enquanto está em segundo plano.

## Requisitos

**Cabeçalho:** GameInput.h

**Biblioteca:** gameinput.lib

**Plataformas com suporte:** Windows, consoles da família XBOX One e consoles XBOX Series

## Confira também

[Visão geral do GameInput](https://docs.xbox.com/pt-BR/build/core-features/common/input/overviews/input-overview.md)\
[Fundamentos do GameInput](https://docs.xbox.com/pt-BR/build/core-features/common/input/overviews/input-fundamentals.md)\
[Sideload do GameInput](https://docs.xbox.com/pt-BR/build/core-features/common/input/overviews/input-agility-redistributable.md)\
[IGameInput](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinput/igameinput.md)\
[IGameInput::SetFocusPolicy (Preterido)](https://docs.xbox.com/pt-BR/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_setfocuspolicy.md)

## Histórico de versões

| Versão | Alterações |
| - | - |
| **v4** | Introduzido. |


## Related topics

- [IGameInput::SetFocusPolicy (Preterido)](https://docs.xbox.com/pt-BR/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_setfocuspolicy.md)
- [GameInputFocusPolicy (Preterido)](https://docs.xbox.com/pt-BR/reference/input/gameinput/deprecated/enums/gameinputfocuspolicy.md)
- [IGameInputReading::GetSystemButtonState](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getsystembuttonstate.md)
- [Sideload do GameInput](https://docs.xbox.com/pt-BR/build/core-features/common/input/overviews/input-agility-redistributable.md)
- [Membros preteridos da API GameInput](https://docs.xbox.com/pt-BR/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)