GameBar Klasse

Referenz

Definition

Namespace:: Windows.Gaming.UI

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Stellt Benachrichtigungen und Informationen zum Sichtbarkeits- und Eingabeumleitungsstatus der Spielleiste bereit.

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

Vererbung: Object Platform::Object IInspectable GameBar

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10586.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v2.0)

Hinweise

Die Ereignisse und Eigenschaften von sind klasse statisch. Objekte werden für diese Klasse nicht instanziiert.

Eigenschaften

IsInputRedirected

Gibt an, ob die Eingabe derzeit an die Spielleiste umgeleitet wird.

Nachdem der Benutzer die Spielleiste aufgerufen hat, kann die Eingabe an die Spielleiste weitergeleitet werden, während der Spieler damit interagiert. Spiele, die keine Eingabe mehr erhalten, möchten in der Regel das Spiel anhalten oder einen Leerlaufzustand darstellen. Während angehalten oder im Leerlauf, besteht eine bewährte Methode darin, den aktuellen Frame oder die aktuelle Szene weiterhin zu rendern, sodass die Aufzeichnung reibungslos und nahtlos verläuft, wenn der Player mit der Aufzeichnung beginnt oder bereits aufgezeichnet wird. Multiplayer-Spiele können sich dafür entscheiden, das Gameplay fortzusetzen, anstatt anzuhalten.

Um über Änderungen an benachrichtigt zu werden, behandeln Sie das IsInputRedirectedChanged-Ereignis .

Visible

Gibt an, ob die Spielleiste derzeit sichtbar ist.

Verwenden Sie die -Eigenschaft, um den Sichtbarkeitsstatus der Spielleiste zu bestimmen. Spiele können das Spiel anhalten oder einen Leerlaufzustand darstellen, wenn die Spielleiste sichtbar ist und über das Spiel gezogen wird. Während angehalten oder im Leerlauf, besteht eine bewährte Methode darin, den aktuellen Frame oder die aktuelle Szene weiterhin zu rendern, sodass die Aufzeichnung reibungslos und nahtlos verläuft, wenn der Player mit der Aufzeichnung beginnt oder bereits aufgezeichnet wird. Multiplayer-Spiele können sich dafür entscheiden, das Gameplay fortzusetzen, anstatt anzuhalten.

Behandeln Sie das VisibilityChanged-Ereignis , um über Änderungen an benachrichtigt zu werden.

Ereignisse

IsInputRedirectedChanged

Tritt auf, wenn die Eingabe an die Spielleiste umgeleitet oder die Eingabe im Spiel wiederhergestellt wird.

Tipp

Dieses Ereignis kann in Hintergrundthreads (nicht auf der Benutzeroberfläche) ausgelöst werden. Möglicherweise müssen Sie ein Ereignis im UI-Thread posten, um UI-Aktionen auszuführen.

Verwenden Sie IsInputRedirected , um zu bestimmen, ob die Eingabe derzeit an die Spielleiste umgeleitet wird.

VisibilityChanged

Tritt auf, wenn die Spielleiste angezeigt oder geschlossen wird.

Verwenden Sie das -Ereignis, um den Sichtbarkeitsstatus der Spielleiste zu überwachen. Spiele können das Spiel anhalten oder einen Leerlaufzustand darstellen, wenn die Spielleiste sichtbar ist und über das Spiel gezogen wird. Während angehalten oder im Leerlauf, besteht eine bewährte Methode darin, den aktuellen Frame oder die aktuelle Szene weiterhin zu rendern, sodass die Aufzeichnung reibungslos und nahtlos verläuft, wenn der Player mit der Aufzeichnung beginnt oder bereits aufgezeichnet wird. Multiplayer-Spiele können sich dafür entscheiden, das Gameplay fortzusetzen, anstatt anzuhalten.

Tipp

Dieses Ereignis kann in Hintergrundthreads (nicht auf der Benutzeroberfläche) ausgelöst werden. Möglicherweise müssen Sie ein Ereignis im UI-Thread posten, um UI-Aktionen auszuführen.

Verwenden Sie Visible , um zu bestimmen, ob die Spielleiste derzeit sichtbar ist.

Gilt für:

Freigeben über