DisplayInformation Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.Graphics.Display

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

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

Condividi tramite