Export (0) Print
Expand All
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

DisplayProperties class

Applies to Windows and Windows Phone

[DisplayProperties may be altered or unavailable for releases after Windows 8.1. Instead, use DisplayInformation. ]

Provides various properties that are related to the physical display.

For most of these properties, the class provides events to allow clients to monitor for changes in the properties.

Syntax

Public NotInheritable Class DisplayProperties

Attributes

[Deprecated()]
[MarshalingBehavior(Agile)]
[Version(0x06020000)]

Members

The DisplayProperties class has these types of members:

Events

The DisplayProperties class has these events.

EventDescription
ColorProfileChanged DisplayProperties may be altered or unavailable for releases after Windows 8.1. Instead, use DisplayInformation. Occurs when the physical display's color profile changes.
DisplayContentsInvalidated DisplayProperties may be altered or unavailable for releases after Windows 8.1. Instead, use DisplayInformation. Occurs when the display requires redrawing.
LogicalDpiChanged DisplayProperties may be altered or unavailable for releases after Windows 8.1. Instead, use DisplayInformation. Occurs when the LogicalDpi property changes because the pixels per inch (PPI) of the display changes.
OrientationChanged DisplayProperties may be altered or unavailable for releases after Windows 8.1. Instead, use DisplayInformation. Occurs when either the CurrentOrientation or NativeOrientation property changes because of a mode change or a monitor change.
StereoEnabledChanged DisplayProperties may be altered or unavailable for releases after Windows 8.1. Instead, use DisplayInformation. Occurs when the StereoEnabled property changes because support for stereoscopic 3D changes.

 

Methods

The DisplayProperties class has these methods. With C#, Visual Basic, and C++, it also inherits methods from the Object class.

MethodDescription
GetColorProfileAsync DisplayProperties may be altered or unavailable for releases after Windows 8.1. Instead, use DisplayInformation. Asynchronously gets the default International Color Consortium (ICC) color profile that is associated with the physical display.

 

Properties

The DisplayProperties class has these properties.

PropertyAccess typeDescription

AutoRotationPreferences

Read/writeDisplayProperties may be altered or unavailable for releases after Windows 8.1. Instead, use DisplayInformation. Gets and sets the preferred orientation of the app.

CurrentOrientation

Read-onlyDisplayProperties may be altered or unavailable for releases after Windows 8.1. Instead, use DisplayInformation. Gets the current orientation of a rectangular monitor.

LogicalDpi

Read-onlyDisplayProperties may be altered or unavailable for releases after Windows 8.1. Instead, use DisplayInformation. Gets the pixels per logical inch of the current environment.

NativeOrientation

Read-onlyDisplayProperties may be altered or unavailable for releases after Windows 8.1. Instead, use DisplayInformation. Gets the native orientation of the display monitor, which is typically the orientation where the buttons on the device match the orientation of the monitor.

ResolutionScale

Read-onlyDisplayProperties may be altered or unavailable for releases after Windows 8.1. Instead, use DisplayInformation. Gets the scale factor of the immersive environment.

StereoEnabled

Read-onlyDisplayProperties may be altered or unavailable for releases after Windows 8.1. Instead, use DisplayInformation. Gets a value that indicates whether the device supports stereoscopic 3D.

 

Requirements

Minimum supported client

Windows 8 [Windows Store apps only]

Minimum supported server

Windows Server 2012 [Windows Store apps only]

Minimum supported phone

Windows Phone 8

Namespace

Windows.Graphics.Display
Windows::Graphics::Display [C++]

Metadata

Windows.winmd

 

 

Show:
© 2014 Microsoft