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

Enumera as políticas de foco de um dispositivo de entrada.

<a id="syntaxSection" />

## Sintaxe

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

<a id="constantsSection" />

## Constantes

| Constante | Descrição |
| - | - |
| GameInputDefaultFocusPolicy | Garante que a entrada e os botões do sistema sejam enviados ao processo somente quando ele estiver em foco. |
| GameInputExclusiveForegroundInput | Impede que outros processos que usam o GameInput vejam a entrada que ele recebe. Essa restrição só vigora quando o jogo está em foco e não se aplica aos botões do sistema. |
| GameInputExclusiveForegroundGuideButton | Impede que outros processos que usam o GameInput vejam os pressionamentos do botão Guia que ele recebe. Essa restrição só vigora quando o jogo está em foco. |
| GameInputExclusiveForegroundShareButton | Impede que outros processos que usam o GameInput vejam os pressionamentos do botão Compartilhar que ele recebe. Essa restrição só vigora quando o jogo está em foco. |
| GameInputEnableBackgroundInput | Garante que a entrada seja sempre enviada ao jogo, mesmo quando ele não estiver em foco. Isso não inclui os botões do sistema, que exigem o uso dos respectivos sinalizadores de política de foco. |
| GameInputEnableBackgroundGuideButton | Garante que os eventos do botão Guia sejam enviados ao jogo mesmo quando ele não estiver em foco. Os pressionamentos do botão Guia ainda não serão enviados ao aplicativo quando o processo em foco tiver acesso exclusivo. |
| GameInputEnableBackgroundShareButton | Garante que os eventos do botão Compartilhar sejam enviados ao jogo mesmo quando ele não estiver em foco. Os pressionamentos do botão Compartilhar ainda não serão enviados ao aplicativo quando o processo em foco tiver acesso exclusivo. |

<a id="remarksSection" />

## Comentários

Essa enumeração é usada pelo método [IGameInput::SetFocusPolicy](/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_setfocuspolicy). Chame `SetFocusPolicy` para especificar se a entrada é enviada a um jogo quando ele não está em foco. Por padrão, o GameInput não fornece entrada em segundo plano. Os valores podem ser combinados.

Se o jogo processar os botões Guia ou Compartilhar, definir os sinalizadores `GameInputExclusiveForegroundGuideButton` ou `GameInputExclusiveForegroundShareButton`, respectivamente, pode ajudar a garantir que aplicativos de sobreposição em segundo plano não os processem também. Por exemplo, isso pode impedir que menus de sobreposição ou capturas de tela indesejados apareçam sobre um jogo que pretende usar os botões por conta própria.

<Note>Muitos usuários usam 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 jogo precisa substituir essa funcionalidade para evitar confusão para o usuário.</Note>

A política de foco só se aplica ao Windows. Os valores dos botões Guia e Compartilhar de GameInputFocusPolicy foram adicionados ao GameInput.h do Windows SDK 10.0.26031 Preview e serão adicionados a uma versão futura do GDK.

Para obter mais informações, confira [Fundamentos do GameInput](/pt-BR/build/core-features/common/input/overviews/input-fundamentals).

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** GameInput.h

**Plataformas compatíveis:** Windows, consoles da família XBOX One e consoles XBOX Series

<a id="seealsoSection" />

## Confira também

[Visão geral do GameInput](/pt-BR/build/core-features/common/input/overviews/input-overview)<br />
[GameInput](/pt-BR/reference/input/gameinput/gameinput_members)

## Histórico de versões

| Versão | Alterações |
| - | - |
| **v2** | **Removidos** `DisableBackgroundInput` (0x1) e `DisableBackgroundShareButton` (0x10). **Adicionados** `EnableBackgroundGuideButton` (0x80) e `EnableBackgroundShareButton` (0x100). |
| **v0** | Introduzido. |

## Apêndice: versões anteriores

### v0

```cpp theme={null}
enum GameInputFocusPolicy
{
    GameInputDefaultFocusPolicy             = 0x00000000,
    GameInputDisableBackgroundInput         = 0x00000001,
    GameInputExclusiveForegroundInput       = 0x00000002,
    GameInputExclusiveForegroundGuideButton = 0x00000008,
    GameInputDisableBackgroundShareButton   = 0x00000010,
    GameInputExclusiveForegroundShareButton = 0x00000020,
    GameInputEnableBackgroundInput          = 0x00000040,
};
```

Observe os sinalizadores DisableBackgroundInput (0x1) e DisableBackgroundShareButton (0x10), que foram removidos na v2. Por padrão, os aplicativos GameInput não recebem entrada em segundo plano, portanto esses sinalizadores eram redundantes. Os sinalizadores EnableBackgroundGuideButton (0x80) e EnableBackgroundShareButton (0x100) foram adicionados na v2 para permitir que os aplicativos registrem a intenção de receber entrada em segundo plano.


## Related topics

- [IGameInput::SetFocusPolicy](/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_setfocuspolicy.md)
- [IGameInput::RegisterSystemButtonCallback](/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback.md)
- [GameInput](/pt-BR/reference/input/gameinput/gameinput_members.md)
- [Portabilidade do XInput para o GameInput](/pt-BR/build/core-features/common/input/porting/input-porting-xinput.md)
- [Fundamentos do GameInput](/pt-BR/build/core-features/common/input/overviews/input-fundamentals.md)