DisplayInformation Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.Graphics.Display
Modifica

Monitora e controlla le informazioni correlate alla visualizzazione di un'applicazione. La classe fornisce eventi per consentire ai client di monitorare le modifiche nella visualizzazione applicazione che influiscono sulle visualizzazioni in cui si trovano le visualizzazioni, nonché sulle modifiche nelle visualizzazioni che possono influire sulla visualizzazione dell'applicazione.

public ref class DisplayInformation sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DisplayInformation final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DisplayInformation
Public NotInheritable Class DisplayInformation
Ereditarietà
Object Platform::Object IInspectable DisplayInformation
Attributi
ContractVersionAttribute MarshalingBehaviorAttribute

Requisiti Windows

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

Commenti

Un'istanza di DisplayInformation non viene mappata a una visualizzazione specifica, ma tiene traccia delle informazioni correlate alla visualizzazione per ogni posizione della visualizzazione dell'applicazione. La chiamata a GetForCurrentView restituirà sempre l'istanza singola per CoreApplicationView del thread corrente. Un'istanza di DisplayInformation può essere usata solo dal thread in cui è stato creato.

Per gestire gli eventi DisplayInformation, usare un gestore eventi per l'evento specifico. Ad esempio, per DisplayInformation.DpiChanged, usare "TypedEventHandler<DisplayInformation, Object> DpiChanged".

Qualsiasi evento di modifica delle proprietà di DisplayInformation potrebbe attivare se l'app viene spostata da un monitoraggio a un altro monitoraggio. ColorProfileChanged viene attivato quando il profilo di colore della visualizzazione cambia. DpiChanged viene attivato quando le proprietà LogicalDpi, ResolutionScale e RawPixelsPerViewPixel cambiano perché un utente ha selezionato un livello di zoom diverso o ha modificato la risoluzione dello schermo. OrientationChanged viene attivato se un utente modifica l'orientamento dello schermo.

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
1511 10586 DiagonalSizeInInches
1607 14393 ScreenHeightInRawPixels
1607 14393 ScreenWidthInRawPixels
1803 17134 AdvancedColorInfoChanged
1803 17134 GetAdvancedColorInfo

Proprietà

AutoRotationPreferences

Ottiene e imposta l'orientamento preferito dell'app.
CurrentOrientation

Ottiene l'orientamento corrente di un monitor rettangolare.
DiagonalSizeInInches

Dimensioni diagonali dello schermo in pollici.
LogicalDpi

Ottiene i pixel per pollice logico dell'ambiente corrente.
NativeOrientation

Ottiene l'orientamento nativo del monitor di visualizzazione, che è in genere l'orientamento in cui i pulsanti del dispositivo corrispondono all'orientamento del monitor.
RawDpiX

Ottiene i punti non elaborati per pollice (DPI) lungo l'asse x del monitor di visualizzazione.
RawDpiY

Ottiene i punti non elaborati per pollice (DPI) lungo l'asse y del monitor di visualizzazione.
RawPixelsPerViewPixel

Ottiene un valore che rappresenta il numero di pixel non elaborati (fisici) per ogni pixel di visualizzazione (layout).
ResolutionScale

Ottiene il fattore di scala della finestra dell'app.
ScreenHeightInRawPixels

Restituisce la risoluzione dell'altezza corrente del monitoraggio logico.
ScreenWidthInRawPixels

Restituisce la risoluzione corrente della larghezza del monitoraggio logico.
StereoEnabled

Ottiene un valore che indica se il dispositivo supporta stereoscopica 3D.

Metodi

GetAdvancedColorInfo()

Recupera le informazioni avanzate sul colore.
GetColorProfileAsync()

Ottiene in modo asincrono il profilo di colore international color Consortium (ICC) predefinito associato alla visualizzazione fisica.
GetForCurrentView()

Ottiene l'istanza di DisplayInformation associata a CoreApplicationView del thread corrente. Questa istanza di DisplayInformation è associata alla visualizzazione e non può essere usata da altri thread.

Eventi

AdvancedColorInfoChanged

Generato quando vengono modificate le informazioni sul colore avanzate.
ColorProfileChanged

Si verifica quando il profilo di colore della visualizzazione fisica cambia.
DisplayContentsInvalidated

Si verifica quando la visualizzazione richiede il ridisegno.
DpiChanged

Si verifica quando la proprietà LogicalDpi cambia perché i pixel per pollice (PPI) della visualizzazione cambiano.
OrientationChanged

Si verifica quando la proprietà CurrentOrientation o NativeOrientation cambia a causa di una modifica della modalità o di una modifica del monitoraggio.
StereoEnabledChanged

Si verifica quando la proprietà StereoEnabled cambia perché il supporto per le modifiche stereoscopiche 3D.

Si applica a

Vedi anche