DisplayManager Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.Devices.Display.Core

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Gestisce la proprietà di un oggetto o di oggetti DisplayTarget e fornisce metodi per creare oggetti DisplayState .

public ref class DisplayManager sealed : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 458752)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DisplayManager final : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 458752)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DisplayManager : System.IDisposable

Public NotInheritable Class DisplayManager
Implements IDisposable

Ereditarietà: Object Platform::Object IInspectable DisplayManager

Attributi: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni: IClosable IDisposable

Requisiti Windows

Famiglia di dispositivi	Windows 10, version 1809 (è stato introdotto in 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v7.0)

Commenti

Questo oggetto implementa IClosableIDisposable/, che deve essere usato per revocare la proprietà di tutti gli oggetti DisplayTarget una volta che non vengono più usati.

Metodi

Close()	Revoca la proprietà di tutti gli oggetti DisplayTarget di proprietà di questa istanza di DisplayManager .
Create(DisplayManagerOptions)	Crea un'istanza di DisplayManager con le opzioni specificate.
CreateDisplayDevice(DisplayAdapter)	Crea un oggetto DisplayDevice per l'adattatore specificato. DisplayDevice può essere usato per creare e presentare contenuto a schermo intero alle destinazioni nella scheda specificata.
CreateDisplayDeviceForIndirectAdapter(DisplayAdapter, DisplayAdapter)	Gestisce la proprietà di un oggetto o di oggetti DisplayTarget e fornisce metodi per creare oggetti DisplayState .
Dispose()	Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite.
GetCurrentAdapters()	Enumera il set di adattatori di visualizzazione attualmente presenti nel sistema.
GetCurrentTargets()	Enumera il set di destinazioni di visualizzazione attualmente presenti nel sistema.
ReleaseTarget(DisplayTarget)	Rilascia la proprietà della destinazione di visualizzazione specificata, consentendo ad altri componenti del sistema di acquisire la proprietà.
Start()	Avvia l'ascolto di tutti gli eventi DisplayManager in modo atomico. Gli eventi DisplayManager non vengono generati fino a quando non si chiama Start.
Stop()	Arresta l'ascolto di tutti gli eventi DisplayManager in modo atomico e attiva disabilitati in modo sincrono.
TryAcquireTarget(DisplayTarget)	Tenta di acquisire la proprietà esclusiva di un displayTarget.
TryAcquireTargetsAndCreateEmptyState(IIterable<DisplayTarget>)	Tenta di acquisire la proprietà esclusiva di un insieme di oggetti DisplayTarget e crea un oggetto DisplayState modificabile vuoto, che supporta la connessione di percorsi a queste destinazioni.
TryAcquireTargetsAndCreateSubstate(DisplayState, IIterable<DisplayTarget>)	Tenta di acquisire la proprietà esclusiva di una raccolta di oggetti DisplayTarget e ritaglia un subset di un oggetto DisplayState specificato solo per le destinazioni passate a questo metodo. Lo stato risultante può essere modificato e applicato.
TryAcquireTargetsAndReadCurrentState(IIterable<DisplayTarget>)	Tenta di acquisire la proprietà esclusiva di un insieme di oggetti DisplayTarget e crea un oggetto DisplayState modificabile popolato con lo stato corrente delle destinazioni fornite.
TryReadCurrentStateForAllTargets()	Crea un oggetto DisplayState di sola lettura popolato con l'intero stato di visualizzazione del sistema per tutte le destinazioni.
TryReadCurrentStateForModeQuery()	Gestisce la proprietà di un oggetto o di oggetti DisplayTarget e fornisce metodi per creare oggetti DisplayState .

Eventi

Changed	Evento generato quando viene aggiunto, rimosso o modificato l'hardware di visualizzazione del sistema. Questa situazione può verificarsi ogni volta che le raccolte DisplayAdapter o DisplayTarget cambiano. Usare questo evento per rilevare queste modifiche e chiamare GetCurrentAdapters e/o GetCurrentTargets per ottenere le raccolte aggiornate.
Disabled	Evento generato ogni volta che lo stack di visualizzazione della sessione corrente è disabilitato e quando viene chiamato DisplayManager.Stop . È possibile disabilitare lo stack di visualizzazione della sessione in diversi casi, ad esempio il cambio di sessioni di Servizi terminal o il ripristino da errori del driver. È consigliabile che i sottoscrittori tentino di eseguire la pulizia quando viene richiamato Disabilitato . La maggior parte delle API di visualizzazione avrà esito negativo mentre lo stack di visualizzazione della sessione è disabilitato.
Enabled	Evento generato ogni volta che lo stack di visualizzazione della sessione corrente è abilitato e quando viene chiamato DisplayManager.Start . È possibile riabilitare lo stack di visualizzazione della sessione in diversi casi, ad esempio il cambio di sessioni di Servizi terminal o il ripristino da errori del driver. È consigliabile che i sottoscrittori enumerino nuovamente tutte le destinazioni e lo stato in questa chiamata, poiché lo stack di visualizzazione del sistema potrebbe essere lasciato in qualsiasi stato prima che venga generato questo evento.
PathsFailedOrInvalidated	Evento generato ogni volta che un percorso di visualizzazione non è riuscito o invalidato in modo asincrono dal sistema. Ciò può essere dovuto alla modifica dei requisiti di larghezza di banda hardware o a causa di errori del driver. I Sottoscrittori di questo evento devono chiamare TryAcquireTargetsAndReadCurrentState per le destinazioni di cui sono proprietari e verificare se una delle proprietà Status dell'oggetto DisplayState risultante è impostata su FailedAsync o InvalidatedAsync e intraprendere l'azione consigliata.

Si applica a

Condividi tramite