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

# GameInputFocusPolicy (en desuso)

> Enumera las directivas de foco de un dispositivo de entrada (se quitó en v4).

> [!WARNING]
>
> **En desuso.** Esta enumeración se quitó en GameInput v4 y no está disponible en la API actual. Use [IGameInput::EnableBackgroundInput](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinput/methods/igameinput_enablebackgroundinput.md) en su lugar.

Enumera las directivas de foco de un dispositivo de entrada.

## Sintaxis

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

## Constantes

| Constante | Descripción |
| - | - |
| GameInputDefaultFocusPolicy | Garantiza que la entrada y los botones del sistema solo se envíen al proceso cuando tiene el foco. |
| GameInputExclusiveForegroundInput | Impide que otros procesos que usan GameInput vean la entrada que recibe. Esta restricción solo está en vigor cuando el juego tiene el foco y no se aplica a los botones del sistema. |
| GameInputExclusiveForegroundGuideButton | Impide que otros procesos que usan GameInput vean las pulsaciones del botón Guía que recibe. Esta restricción solo está en vigor cuando el juego tiene el foco. |
| GameInputExclusiveForegroundShareButton | Impide que otros procesos que usan GameInput vean las pulsaciones del botón Compartir que recibe. Esta restricción solo está en vigor cuando el juego tiene el foco. |
| GameInputEnableBackgroundInput | Garantiza que la entrada siempre se envíe al juego, incluso cuando no tiene el foco. Esto no incluye los botones del sistema, que requieren usar sus respectivas marcas de directiva de foco. |
| GameInputEnableBackgroundGuideButton | Garantiza que los eventos del botón Guía se envíen al juego incluso cuando no tiene el foco. Las pulsaciones del botón Guía seguirán sin enviarse a la aplicación cuando el proceso que tiene el foco tenga acceso exclusivo. |
| GameInputEnableBackgroundShareButton | Garantiza que los eventos del botón Compartir se envíen al juego incluso cuando no tiene el foco. Las pulsaciones del botón Compartir seguirán sin enviarse a la aplicación cuando el proceso que tiene el foco tenga acceso exclusivo. |

## Comentarios

El método [IGameInput::SetFocusPolicy](https://docs.xbox.com/es/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_setfocuspolicy.md) usa esta enumeración. Llame a `SetFocusPolicy` para especificar si la entrada se envía a un juego cuando no tiene el foco. De forma predeterminada, GameInput no proporciona entrada en segundo plano. Los valores se pueden combinar.

Si el juego procesa los botones Guía o Compartir, establecer las marcas `GameInputExclusiveForegroundGuideButton` o `GameInputExclusiveForegroundShareButton`, respectivamente, puede ayudar a garantizar que las aplicaciones de superposición en segundo plano no los controlen también. Por ejemplo, esto puede impedir que aparezcan menús de superposición o capturas de pantalla no deseados sobre un juego que pretende usar los botones por sí mismo.

> [!NOTE]
>
> Muchos usuarios usan aplicaciones de superposición que utilizan el botón Guía para los menús y el botón Compartir para las capturas de pantalla. Considere si su juego necesita invalidar esa funcionalidad para evitar confundir al usuario.

La directiva de foco solo se aplica en Windows. Los valores de los botones Guía y Compartir de GameInputFocusPolicy se agregaron en el archivo GameInput.h de la versión preliminar 10.0.26031 de Windows SDK y se agregarán en una versión futura del GDK.

Para obtener más información, consulte [Aspectos básicos de GameInput](https://docs.xbox.com/es/build/core-features/common/input/overviews/input-fundamentals.md).

## Requisitos

**Encabezado:** GameInput.h

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

[Miembros de la API de GameInput en desuso](https://docs.xbox.com/es/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)\
[IGameInput::EnableBackgroundInput](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinput/methods/igameinput_enablebackgroundinput.md)\
[Información general de GameInput](https://docs.xbox.com/es/build/core-features/common/input/overviews/input-overview.md)\

[GameInput](https://docs.xbox.com/es/reference/input/gameinput/gameinput_members.md)

## Historial de versiones

| Versión | Cambios |
| - | - |
| **v4** | Se quitó. |
| **v2** | **Se quitaron** `DisableBackgroundInput` (0x1) y `DisableBackgroundShareButton` (0x10). **Se agregaron** `EnableBackgroundGuideButton` (0x80) y `EnableBackgroundShareButton` (0x100). |
| **v0** | Se introdujo. |

## Apéndice: versiones anteriores

### v0

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

Tenga en cuenta las marcas DisableBackgroundInput (0x1) y DisableBackgroundShareButton (0x10), que se quitaron en v2. De forma predeterminada, las aplicaciones de GameInput no reciben entrada en segundo plano, por lo que estas marcas eran redundantes. Las marcas EnableBackgroundGuideButton (0x80) y EnableBackgroundShareButton (0x100) se agregaron en v2 para permitir que las aplicaciones registren su intención de recibir entrada en segundo plano.


## Related topics

- [IGameInput::SetFocusPolicy (en desuso)](https://docs.xbox.com/es/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_setfocuspolicy.md)
- [IGameInput::SetFocusPolicy](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinput/methods/igameinput_setfocuspolicy.md)
- [Miembros de la API de GameInput en desuso](https://docs.xbox.com/es/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)
- [GameInputString (en desuso)](https://docs.xbox.com/es/reference/input/gameinput/deprecated/structs/gameinputstring.md)
- [GameInputLocation (en desuso)](https://docs.xbox.com/es/reference/input/gameinput/deprecated/enums/gameinputlocation.md)
