DisplayInformation Klasse

Referenz

Definition

Namespace:: Windows.Graphics.Display

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

Überwacht und steuert anzeigebezogene Informationen für eine Anwendungsansicht. Die -Klasse stellt Ereignisse bereit, mit denen Clients Änderungen in der Anwendungsansicht überwachen können, die sich darauf auswirken, auf welchen Anzeigen sich die Ansicht befindet, sowie Änderungen in Anzeigen, die sich auf die Anwendungsansicht auswirken können.

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

Vererbung: Object Platform::Object IInspectable DisplayInformation

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

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

Hinweise

Ein DisplayInformation-instance wird keiner bestimmten Anzeige zugeordnet, sondern verfolgt anzeigebezogene Informationen für den Standort der Anwendungsansicht nach. Der Aufruf von GetForCurrentView gibt immer den einzelnen instance für coreApplicationView des aktuellen Threads zurück. Eine instance von DisplayInformation kann nur in dem Thread verwendet werden, auf dem sie erstellt wurde.

Verwenden Sie einen Ereignishandler für das jeweilige Ereignis, um DisplayInformation-Ereignisse zu behandeln. Verwenden Sie beispielsweise für DisplayInformation.DpiChanged "TypedEventHandler<DisplayInformation, Object> DpiChanged".

Jedes Eigenschaftsänderungsereignis von DisplayInformation kann ausgelöst werden, wenn Ihre App von einem Monitor auf einen anderen verschoben wird. ColorProfileChanged wird ausgelöst, wenn sich das Farbprofil der Anzeige ändert. DpiChanged wird ausgelöst, wenn sich die Eigenschaften LogicalDpi, ResolutionScale und RawPixelsPerViewPixel ändern, weil ein Benutzer einen anderen Zoomfaktor ausgewählt oder die Bildschirmauflösung geändert hat. OrientationChanged wird ausgelöst, wenn ein Benutzer die Bildschirmausrichtung ändert.

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1511	10586	DiagonalSizeInInInches
1607	14393	ScreenHeightInRawPixels
1607	14393	ScreenWidthInRawPixels
1803	17134	AdvancedColorInfoChanged
1803	17134	GetAdvancedColorInfo

Eigenschaften

AutoRotationPreferences	Ruft die bevorzugte Ausrichtung der App ab und legt sie fest.
CurrentOrientation	Ruft die aktuelle Ausrichtung eines rechteckigen Monitors ab.
DiagonalSizeInInches	Diagonale Größe der Anzeige in Zoll.
LogicalDpi	Ruft die Pixel pro logischem Zoll der aktuellen Umgebung ab.
NativeOrientation	Ruft die native Ausrichtung des Anzeigemonitors ab. Dies ist in der Regel die Ausrichtung, an der die Schaltflächen auf dem Gerät mit der Ausrichtung des Monitors übereinstimmen.
RawDpiX	Ruft die unformatierten Punkte pro Zoll (DPI) entlang der x-Achse des Anzeigemonitors ab.
RawDpiY	Ruft die unformatierten DPI -Werte (Dots per Inch) entlang der y-Achse des Anzeigemonitors ab.
RawPixelsPerViewPixel	Ruft einen Wert ab, der die Anzahl der unformatierten (physischen) Pixel für jedes Ansichtspixel (Layout) darstellt.
ResolutionScale	Ruft den Skalierungsfaktor des App-Fensters ab.
ScreenHeightInRawPixels	Gibt die aktuelle Höhenauflösung des logischen Monitors zurück.
ScreenWidthInRawPixels	Gibt die aktuelle Breite des logischen Monitors zurück.
StereoEnabled	Ruft einen Wert ab, der angibt, ob das Gerät stereoskopisches 3D unterstützt.

Methoden

GetAdvancedColorInfo()	Ruft die Erweiterten Farbinformationen ab.
GetColorProfileAsync()	Ruft asynchron das Standardfarbprofil des International Color Consortium (ICC) ab, das der physischen Anzeige zugeordnet ist.
GetForCurrentView()	Ruft die DisplayInformation-instance ab, die der CoreApplicationView des aktuellen Threads zugeordnet ist. Diese DisplayInformation-instance ist an die Ansicht gebunden und kann nicht von anderen Threads verwendet werden.

Ereignisse

AdvancedColorInfoChanged	Wird ausgelöst, wenn die erweiterten Farbinformationen geändert werden.
ColorProfileChanged	Tritt auf, wenn sich das Farbprofil der physischen Anzeige ändert.
DisplayContentsInvalidated	Tritt auf, wenn für die Anzeige ein Neuzeichnen erforderlich ist.
DpiChanged	Tritt auf, wenn sich die LogicalDpi-Eigenschaft ändert, weil sich die Pixel pro Zoll (PPI) der Anzeige ändern.
OrientationChanged	Tritt auf, wenn sich die CurrentOrientation - oder NativeOrientation-Eigenschaft aufgrund einer Modusänderung oder einer Monitoränderung ändert.
StereoEnabledChanged	Tritt auf, wenn sich die StereoEnabled-Eigenschaft ändert, da sich die Unterstützung für stereoskopische 3D ändert.

Gilt für: