DisplayProperties DisplayProperties DisplayProperties DisplayProperties Class

Definition

Note

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.

public : static class DisplayProperties
public static class DisplayProperties
Public Static Class DisplayProperties
// This class does not provide a public constructor.
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Properties

AutoRotationPreferences AutoRotationPreferences AutoRotationPreferences AutoRotationPreferences

Note

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

Gets and sets the preferred orientation of the app.

public : static DisplayOrientations AutoRotationPreferences { get; set; }
public static DisplayOrientations AutoRotationPreferences { get; set; }
Public Static ReadWrite Property AutoRotationPreferences As DisplayOrientations
var displayOrientations = Windows.Graphics.Display.DisplayProperties.autoRotationPreferences;
displayProperties.autoRotationPreferences = displayOrientations;
Value
DisplayOrientations DisplayOrientations DisplayOrientations DisplayOrientations

The orientation of a rectangular monitor.

CurrentOrientation CurrentOrientation CurrentOrientation CurrentOrientation

Note

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

Gets the current orientation of a rectangular monitor.

public : static DisplayOrientations CurrentOrientation { get; }
public static DisplayOrientations CurrentOrientation { get; }
Public Static ReadOnly Property CurrentOrientation As DisplayOrientations
var displayOrientations = Windows.Graphics.Display.DisplayProperties.currentOrientation;
Value
DisplayOrientations DisplayOrientations DisplayOrientations DisplayOrientations

The current orientation of a rectangular monitor.

LogicalDpi LogicalDpi LogicalDpi LogicalDpi

Note

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

Gets the pixels per logical inch of the current environment.

public : static float LogicalDpi { get; }
public static float LogicalDpi { get; }
Public Static ReadOnly Property LogicalDpi As float
var float = Windows.Graphics.Display.DisplayProperties.logicalDpi;
Value
float float float float

The pixels per logical inch of the current environment.

NativeOrientation NativeOrientation NativeOrientation NativeOrientation

Note

DisplayProperties 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.

public : static DisplayOrientations NativeOrientation { get; }
public static DisplayOrientations NativeOrientation { get; }
Public Static ReadOnly Property NativeOrientation As DisplayOrientations
var displayOrientations = Windows.Graphics.Display.DisplayProperties.nativeOrientation;
Value
DisplayOrientations DisplayOrientations DisplayOrientations DisplayOrientations

The native orientation of the display monitor.

ResolutionScale ResolutionScale ResolutionScale ResolutionScale

Note

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

Gets the scale factor of the immersive environment.

public : static ResolutionScale ResolutionScale { get; }
public static ResolutionScale ResolutionScale { get; }
Public Static ReadOnly Property ResolutionScale As ResolutionScale
var resolutionScale = Windows.Graphics.Display.DisplayProperties.resolutionScale;
Value
ResolutionScale ResolutionScale ResolutionScale ResolutionScale

The scale factor of the immersive environment.

StereoEnabled StereoEnabled StereoEnabled StereoEnabled

Note

DisplayProperties 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.

public : static Platform::Boolean StereoEnabled { get; }
public static bool StereoEnabled { get; }
Public Static ReadOnly Property StereoEnabled As bool
var bool = Windows.Graphics.Display.DisplayProperties.stereoEnabled;
Value
Platform::Boolean bool bool bool

TRUE if the device is capable of stereoscopic 3D and stereoscopic 3D is currently enabled; FALSE otherwise.

Methods

GetColorProfileAsync() GetColorProfileAsync() GetColorProfileAsync() GetColorProfileAsync()

Note

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.

public : static IAsyncOperation<IRandomAccessStream> GetColorProfileAsync()
public static IAsyncOperation<IRandomAccessStream> GetColorProfileAsync()
Public Static Function GetColorProfileAsync() As IAsyncOperation( Of IRandomAccessStream )
Windows.Graphics.Display.DisplayProperties.getColorProfileAsync().done( /* Your success and error handlers */ );
Returns
See Also

Events

ColorProfileChanged ColorProfileChanged ColorProfileChanged ColorProfileChanged

Note

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

Occurs when the physical display's color profile changes.

public : event DisplayPropertiesEventHandler ColorProfileChanged<>
public event DisplayPropertiesEventHandler ColorProfileChanged<>
Public Event DisplayPropertiesEventHandler ColorProfileChanged( Of )
function onColorProfileChanged(eventArgs){/* Your code */}


displayProperties.addEventListener("colorProfileChanged", onColorProfileChanged);
displayProperties.removeEventListener("colorProfileChanged", onColorProfileChanged);
See Also

DisplayContentsInvalidated DisplayContentsInvalidated DisplayContentsInvalidated DisplayContentsInvalidated

Note

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

Occurs when the display requires redrawing.

public : event DisplayPropertiesEventHandler DisplayContentsInvalidated<>
public event DisplayPropertiesEventHandler DisplayContentsInvalidated<>
Public Event DisplayPropertiesEventHandler DisplayContentsInvalidated( Of )
function onDisplayContentsInvalidated(eventArgs){/* Your code */}


displayProperties.addEventListener("displayContentsInvalidated", onDisplayContentsInvalidated);
displayProperties.removeEventListener("displayContentsInvalidated", onDisplayContentsInvalidated);

Examples


    DisplayProperties::DisplayContentsInvalidated +=
        ref new DisplayPropertiesEventHandler(this, &ShapesPuzzle::OnDisplayContentsInvalidated);

LogicalDpiChanged LogicalDpiChanged LogicalDpiChanged LogicalDpiChanged

Note

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.

public : event DisplayPropertiesEventHandler LogicalDpiChanged<>
public event DisplayPropertiesEventHandler LogicalDpiChanged<>
Public Event DisplayPropertiesEventHandler LogicalDpiChanged( Of )
function onLogicalDpiChanged(eventArgs){/* Your code */}


displayProperties.addEventListener("logicalDpiChanged", onLogicalDpiChanged);
displayProperties.removeEventListener("logicalDpiChanged", onLogicalDpiChanged);

OrientationChanged OrientationChanged OrientationChanged OrientationChanged

Note

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.

public : event DisplayPropertiesEventHandler OrientationChanged<>
public event DisplayPropertiesEventHandler OrientationChanged<>
Public Event DisplayPropertiesEventHandler OrientationChanged( Of )
function onOrientationChanged(eventArgs){/* Your code */}


displayProperties.addEventListener("orientationChanged", onOrientationChanged);
displayProperties.removeEventListener("orientationChanged", onOrientationChanged);

StereoEnabledChanged StereoEnabledChanged StereoEnabledChanged StereoEnabledChanged

Note

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.

public : event DisplayPropertiesEventHandler StereoEnabledChanged<>
public event DisplayPropertiesEventHandler StereoEnabledChanged<>
Public Event DisplayPropertiesEventHandler StereoEnabledChanged( Of )
function onStereoEnabledChanged(eventArgs){/* Your code */}


displayProperties.addEventListener("stereoEnabledChanged", onStereoEnabledChanged);
displayProperties.removeEventListener("stereoEnabledChanged", onStereoEnabledChanged);