DisplayInformation 类

  • 参考

定义

命名空间:
Windows.Graphics.Display
编辑

监视和控制应用程序视图的显示相关信息。 类提供事件，使客户端能够监视应用程序视图中的更改，这些更改影响视图) (的显示，以及可能影响应用程序视图的显示器中的更改。

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
继承
Object Platform::Object IInspectable DisplayInformation
属性
ContractVersionAttribute MarshalingBehaviorAttribute

Windows 要求

设备系列
Windows 10 (在 10.0.10240.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

DisplayInformation 实例不会映射到特定显示器，而是跟踪应用程序视图放置位置的显示相关信息。 调用 GetForCurrentView 将始终返回当前线程的 CoreApplicationView 的单个实例。 DisplayInformation 实例只能从创建它的线程中使用。

若要处理 DisplayInformation 事件，请使用特定事件的事件处理程序。 例如，对于 DisplayInformation.DpiChanged，请使用“TypedEventHandler<DisplayInformation， Object> DpiChanged”。

如果你的应用从一个监视器移动到另一个监视器，则 DisplayInformation 的任何属性更改事件都可能会触发。 当显示器的颜色配置文件更改时，将触发 ColorProfileChanged。 当 LogicalDpi、ResolutionScale 和 RawPixelsPerViewPixel 属性更改时，将触发 DpiChanged，因为用户选择了不同的缩放级别或更改了屏幕分辨率。 如果用户更改屏幕方向，则会触发 OrientationChanged。

版本历史记录

Windows 版本 SDK 版本 已添加值
1511 10586 DiagonalSizeInInches
1607 14393 ScreenHeightInRawPixels
1607 14393 ScreenWidthInRawPixels
1803 17134 AdvancedColorInfoChanged
1803 17134 GetAdvancedColorInfo

属性

AutoRotationPreferences

获取并设置应用的首选方向。
CurrentOrientation

获取矩形监视器的当前方向。
DiagonalSizeInInches

显示器的对角大小（以英寸为单位）。
LogicalDpi

获取当前环境的每逻辑英寸的像素。
NativeOrientation

获取显示监视器的本机方向，该方向通常是设备上的按钮与监视器方向匹配的方向。
RawDpiX

获取沿显示监视器 x 轴的每英寸 (DPI) 的原始点数。
RawDpiY

获取沿显示监视器的 y 轴 (DPI) 的每英寸原始点数。
RawPixelsPerViewPixel

获取一个值，该值表示每个视图 (布局) 像素的原始 (物理) 像素数。
ResolutionScale

获取应用窗口的比例因子。
ScreenHeightInRawPixels

返回逻辑监视器的当前高度分辨率。
ScreenWidthInRawPixels

返回逻辑监视器的当前宽度分辨率。
StereoEnabled

获取一个值，该值指示设备是否支持立体 3D。

方法

GetAdvancedColorInfo()

检索高级颜色信息。
GetColorProfileAsync()

异步获取与物理显示器关联的国际颜色联盟 (ICC) 颜色配置文件。
GetForCurrentView()

获取与当前线程的 CoreApplicationView 关联的 DisplayInformation 实例。 此 DisplayInformation 实例绑定到视图，不能从其他线程使用。

事件

AdvancedColorInfoChanged

更改高级颜色信息时引发。
ColorProfileChanged

在物理显示器的颜色配置文件更改时发生。
DisplayContentsInvalidated

当显示器需要重绘时发生。
DpiChanged

当 LogicalDpi 属性更改时发生，因为每英寸像素 (PPI) 显示更改。
OrientationChanged

当 CurrentOrientation 或 NativeOrientation 属性由于模式更改或监视器更改而发生更改时发生。
StereoEnabledChanged

当 StereoEnabled 属性更改时发生，因为支持立体 3D 更改。

适用于

另请参阅