通过

GameBar 类

  • 参考

定义

命名空间:
Windows.Gaming.UI
编辑

提供有关游戏栏的可见性和输入重定向状态的通知和信息。

public ref class GameBar abstract sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class GameBar final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class GameBar
Public Class GameBar
继承
Object Platform::Object IInspectable GameBar
属性
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列
Windows 10 (在 10.0.10586.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v2.0 中引入)

注解

的事件和属性是类静态的。 不会为此类实例化对象。

属性

IsInputRedirected

指示输入当前是否重定向到游戏栏。

在用户调用游戏栏后，玩家与游戏栏交互时，可能会将输入重定向到游戏栏。 不再接收输入的游戏通常需要暂停游戏或呈现空闲状态。 暂停或空闲时，最佳做法是继续渲染当前帧或场景，以便在玩家开始录制或已经在录制时录制流畅且无缝。 多人游戏可能会选择继续玩游戏，而不是暂停。

若要收到更改的通知，请处理 IsInputRedirectedChanged 事件。
Visible

指示游戏栏当前是否可见。

使用 属性确定游戏栏的可见性状态。 当游戏栏可见并在游戏上绘制时，游戏可以选择暂停游戏或呈现空闲状态。 暂停或空闲时，最佳做法是继续渲染当前帧或场景，以便在玩家开始录制或已经在录制时录制流畅且无缝。 多人游戏可能会选择继续玩游戏，而不是暂停。

若要收到更改的通知，请处理 VisibilityChanged 事件。

事件

IsInputRedirectedChanged

当输入重定向到游戏栏或输入还原到游戏时发生。

在用户调用游戏栏后，玩家与游戏栏交互时，可能会将输入重定向到游戏栏。 不再接收输入的游戏通常需要暂停游戏或呈现空闲状态。 暂停或空闲时，最佳做法是继续渲染当前帧或场景，以便在玩家开始录制或已经在录制时录制流畅且无缝。 多人游戏可能会选择继续玩游戏，而不是暂停。

提示

可以在后台 (非 UI) 线程引发此事件。 可能需要将事件发布到 UI 线程以执行 UI 操作。

使用 IsInputRedirected 确定输入当前是否重定向到游戏栏。
VisibilityChanged

在显示或关闭游戏栏时发生。

使用 事件监视游戏栏的可见性状态。 当游戏栏可见并在游戏上绘制时，游戏可以选择暂停游戏或呈现空闲状态。 暂停或空闲时，最佳做法是继续渲染当前帧或场景，以便在玩家开始录制或已经在录制时录制流畅且无缝。 多人游戏可能会选择继续玩游戏，而不是暂停。

提示

可以在后台 (非 UI) 线程引发此事件。 可能需要将事件发布到 UI 线程以执行 UI 操作。

使用 Visible 确定游戏栏当前是否可见。

适用于