GameInputFocusPolicy

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

Sintaxe

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

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.

Comentários

Essa enumeração é usada pelo método 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.

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.

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.

Requisitos

Cabeçalho: GameInput.h Plataformas compatíveis: Windows, consoles da família XBOX One e consoles XBOX Series

Confira também

Visão geral do GameInput
GameInput

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

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.

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

GameInputFocusPolicy

GameInputFocusPolicy

Sintaxe

Constantes

Comentários

Requisitos

Confira também

Histórico de versões

Apêndice: versões anteriores

v0

​GameInputFocusPolicy

​Sintaxe

​Constantes

​Comentários

​Requisitos

​Confira também

​Histórico de versões

​Apêndice: versões anteriores

​v0

GameInputFocusPolicy

Sintaxe

Constantes

Comentários

Requisitos

Confira também

Histórico de versões

Apêndice: versões anteriores

v0