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