共用方式為

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 來判斷遊戲列目前是否可見。

適用於