GameBar Classe

Definizione

Spazio dei nomi:

Windows.Gaming.UI

Fornisce notifiche e informazioni sullo stato di visibilità e reindirizzamento dell'input della barra del gioco.

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

Ereditarietà

Object Platform::Object IInspectable GameBar

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10586.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v2.0)

Commenti

Gli eventi e le proprietà di sono statici della classe. Non viene creata un'istanza degli oggetti per questa classe.

Proprietà

IsInputRedirected

Indica se l'input è attualmente reindirizzato alla barra del gioco. Dopo che l'utente richiama la barra del gioco, l'input può essere reindirizzato alla barra del gioco mentre il giocatore interagisce con esso. I giochi che non ricevono più input in genere vogliono sospendere il gioco o presentare uno stato di inattività. Durante la sospensione o l'inattività, è consigliabile continuare a eseguire il rendering del fotogramma o della scena corrente, in modo che la registrazione sia fluida e trasparente se il lettore inizia la registrazione o sta già registrando. I giochi multiplayer potrebbero scegliere di continuare la modalità di gioco invece di sospendere. Per ricevere una notifica delle modifiche a , gestire l'evento IsInputRedirectedChanged .

Visible

Indica se la barra del gioco è attualmente visibile. Utilizzare la proprietà per determinare lo stato di visibilità della barra del gioco. I giochi possono scegliere di sospendere il gioco o presentare uno stato di inattività quando la barra del gioco è visibile e disegnata sul gioco. Durante la sospensione o l'inattività, è consigliabile continuare a eseguire il rendering del fotogramma o della scena corrente, in modo che la registrazione sia fluida e trasparente se il lettore inizia la registrazione o sta già registrando. I giochi multiplayer potrebbero scegliere di continuare la modalità di gioco invece di sospendere. Per ricevere una notifica delle modifiche a , gestire l'evento VisibilityChanged .

Eventi

IsInputRedirectedChanged

Si verifica quando l'input viene reindirizzato alla barra del gioco o all'input viene ripristinato nel gioco. Dopo che l'utente richiama la barra del gioco, l'input può essere reindirizzato alla barra del gioco mentre il giocatore interagisce con esso. I giochi che non ricevono più input in genere vogliono sospendere il gioco o presentare uno stato di inattività. Durante la sospensione o l'inattività, è consigliabile continuare a eseguire il rendering del fotogramma o della scena corrente, in modo che la registrazione sia fluida e trasparente se il lettore inizia la registrazione o sta già registrando. I giochi multiplayer potrebbero scegliere di continuare la modalità di gioco invece di sospendere. Suggerimento Questo evento può essere generato su thread in background (non dell'interfaccia utente). Potrebbe essere necessario pubblicare un evento nel thread dell'interfaccia utente per eseguire azioni dell'interfaccia utente. Usa IsInputRedirected per determinare se l'input è attualmente reindirizzato alla barra del gioco.

VisibilityChanged

Si verifica quando la barra del gioco viene visualizzata o ignorata. Usare l'evento per monitorare lo stato di visibilità della barra del gioco. I giochi possono scegliere di sospendere il gioco o presentare uno stato di inattività quando la barra del gioco è visibile e disegnata sul gioco. Durante la sospensione o l'inattività, è consigliabile continuare a eseguire il rendering del fotogramma o della scena corrente, in modo che la registrazione sia fluida e trasparente se il lettore inizia la registrazione o sta già registrando. I giochi multiplayer potrebbero scegliere di continuare la modalità di gioco invece di sospendere. Suggerimento Questo evento può essere generato su thread in background (non dell'interfaccia utente). Potrebbe essere necessario pubblicare un evento nel thread dell'interfaccia utente per eseguire azioni dell'interfaccia utente. Usa Visible per determinare se la barra del gioco è attualmente visibile.