枚举输入设备的焦点策略。
语法
enum GameInputFocusPolicy
{
GameInputDefaultFocusPolicy = 0x00000000,
GameInputExclusiveForegroundInput = 0x00000002,
GameInputExclusiveForegroundGuideButton = 0x00000008,
GameInputExclusiveForegroundShareButton = 0x00000020,
GameInputEnableBackgroundInput = 0x00000040,
GameInputEnableBackgroundGuideButton = 0x00000080,
GameInputEnableBackgroundShareButton = 0x00000100
};
常量
| 常量 | 说明 |
|---|---|
| GameInputDefaultFocusPolicy | 确保输入和系统按钮仅在焦点处于焦点时发送到进程。 |
| GameInputExclusiveForegroundInput | 防止使用 GameInput 的其他进程看到它接收的输入。 仅当游戏处于焦点且不适用于系统按钮时，此限制才有效。 |
| GameInputDisableBackgroundGuideButton | 确保仅当游戏处于焦点时，“指南”按钮事件才会发送到游戏。 游戏不处于焦点中时，“导航”按钮报告为未按下。 |
| GameInputExclusiveForegroundGuideButton | 防止使用 GameInput 的其他进程看到“指南”按钮按下它接收的信息。 只有当游戏处于焦点中时，此限制才会生效。 |
| GameInputExclusiveForegroundShareButton | 防止使用 GameInput 的其他进程看到其接收的“共享”按钮按下。 只有当游戏处于焦点中时，此限制才会生效。 |
| GameInputEnableBackgroundInput | 确保始终将输入发送到游戏，即使它不在焦点中也是如此。 这不包括需要使用其各自的焦点策略标志的系统按钮。 |
| GameInputEnableBackgroundGuideButton | 确保即使没有焦点，“指南”按钮事件也会发送到游戏。 当焦点进程中的 独占访问权限时，指南按钮的按下作仍不会发送到应用程序。 |
| GameInputEnableBackgroundShareButton | 确保“共享”按钮事件即使在没有焦点的情况下也发送到游戏。 当焦点中进程独占访问时，“共享”按钮仍不会发送到应用程序。 |
备注
此枚举由 IGameInput::SetFocusPolicy 方法使用。 调用SetFocusPolicy以指定游戏未处于焦点中时，输入是否被发送到游戏。 默认情况下，GameInput 不提供后台输入。 可以组合值。
如果游戏处理“指南”或“共享”按钮，则分别设置 GameInputExclusiveForegroundGuideButton 或 GameInputExclusiveForegroundShareButton 标志有助于确保后台覆盖应用程序不会也处理它们。 例如，这可以防止在打算使用按钮的游戏上弹出不需要的覆盖菜单或屏幕截图。
注意
许多用户使用覆盖应用程序，这些应用程序使用菜单的“导航”按钮和屏幕截图的“共享”按钮。 考虑游戏是否需要重写该功能以避免用户混淆。
焦点策略仅适用于 Windows。 GameInputFocusPolicy 的“指南”和“共享”按钮值已添加到 Windows SDK 10.0.26031 预览版 GameInput.h 中，并将添加到 GDK 的未来版本中。
有关详细信息，请参阅 GameInput 基础。
要求
头文件：GameInput.h
支持的平台： 窗户