Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Enumerates focus policies for an input device.
Syntax
enum GameInputFocusPolicy
{
GameInputDefaultFocusPolicy = 0x00000000,
GameInputExclusiveForegroundInput = 0x00000002,
GameInputExclusiveForegroundGuideButton = 0x00000008,
GameInputExclusiveForegroundShareButton = 0x00000020,
GameInputEnableBackgroundInput = 0x00000040,
GameInputEnableBackgroundGuideButton = 0x00000080,
GameInputEnableBackgroundShareButton = 0x00000100
};
Constants
| Constant | Description |
|---|---|
| GameInputDefaultFocusPolicy | Ensures that input and system buttons is only sent to the process when it is in focus. |
| GameInputExclusiveForegroundInput | Prevents other processes using GameInput from seeing the input it receives. This restriction is in effect only when the game is in focus and does not apply to system buttons. |
| GameInputDisableBackgroundGuideButton | Ensures that Guide button events are sent to the game only when it is in focus. The Guide button is reported as not pressed when the game is not in focus. |
| GameInputExclusiveForegroundGuideButton | Prevents other processes using GameInput from seeing Guide button presses it receives. This restriction is in effect only when the game is in focus. |
| GameInputExclusiveForegroundShareButton | Prevents other processes using GameInput from seeing Share button presses it receives. This restriction is in effect only when the game is in focus. |
| GameInputEnableBackgroundInput | Ensures that input is always sent to the game, even when it is not in focus. This does not include the system buttons, which require using their respective focus policy flags. |
| GameInputEnableBackgroundGuideButton | Ensures that Guide button events are sent to the game even when not in focus. Guide button presses will still not be sent to the application when the in focus process exclusive access. |
| GameInputEnableBackgroundShareButton | Ensures that Share button events are sent to the game even when not in focus. Share button presses will still not be sent to the application when the in focus process exclusive access. |
Remarks
This enumeration is used by the IGameInput::SetFocusPolicy method. Call SetFocusPolicy to specify whether input is sent to a game when it is not in focus. By default, GameInput will not provide background input. Values may be combined.
If the game processes the Guide or Share buttons, setting the GameInputExclusiveForegroundGuideButton or GameInputExclusiveForegroundShareButton flags respectively can help ensure background overlay applications do not also handle them. For example, this can prevent unwanted overlay menus or screenshots from popping up over a game that intends to use the buttons itself.
Note
Many users use overlay applications that use the Guide button for menus and the Share button for screenshots. Consider whether your game has a need to override that functionality to avoid user confusion.
Focus policy only applies on Windows. The Guide and Share button values of GameInputFocusPolicy were added in the Windows SDK 10.0.26031 Preview GameInput.h and will be added to a future release of the GDK.
For more information, see GameInput fundamentals.
Requirements
Header: GameInput.h
Supported platforms: Windows