Поделиться через


DisplayInformation Класс

Определение

Мониторы и элементы управления отображают сведения, связанные с представлением приложения. Класс предоставляет события, позволяющие клиентам отслеживать изменения в представлении приложения, влияющие на отображение представления, а также изменения в дисплеях, которые могут повлиять на представление приложения.

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
Атрибуты

Требования к 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 активируется при изменении цветового профиля дисплея. DpiChanged активируется при изменении свойств LogicalDpi, ResolutionScale и RawPixelsPerViewPixel , так как пользователь выбрал другой уровень масштабирования или изменил разрешение экрана. OrientationChanged активируется, если пользователь изменяет ориентацию экрана.

Журнал версий

Версия Windows Версия пакета SDK Добавленная стоимость
1511 10586 DiagonalSizeInInches
1607 14393 ScreenHeightInRawPixels
1607 14393 ScreenWidthInRawPixels
1803 17134 AdvancedColorInfoChanged
1803 17134 GetAdvancedColorInfo

Свойства

AutoRotationPreferences

Возвращает и задает предпочтительную ориентацию приложения.

CurrentOrientation

Возвращает текущую ориентацию прямоугольного монитора.

DiagonalSizeInInches

Диагональный размер дисплея в дюймах.

LogicalDpi

Возвращает пиксели на логический дюйм текущей среды.

NativeOrientation

Возвращает собственную ориентацию монитора дисплея, которая обычно является ориентацией, в которой кнопки на устройстве соответствуют ориентации монитора.

RawDpiX

Возвращает необработанные точки на дюйм (DPI) по оси X монитора дисплея.

RawDpiY

Возвращает необработанные точки на дюйм (DPI) по оси Y монитора дисплея.

RawPixelsPerViewPixel

Возвращает значение, представляющее количество необработанных (физических) пикселей для каждого пикселя представления (макета).

ResolutionScale

Возвращает коэффициент масштабирования окна приложения.

ScreenHeightInRawPixels

Возвращает текущее разрешение высоты логического монитора.

ScreenWidthInRawPixels

Возвращает текущее разрешение ширины логического монитора.

StereoEnabled

Возвращает значение, указывающее, поддерживает ли устройство стереоскопические трехмерные данные.

Методы

GetAdvancedColorInfo()

Извлекает дополнительные сведения о цвете.

GetColorProfileAsync()

Асинхронно получает профиль цвета по умолчанию International Color Consortium (ICC), связанный с физическим дисплеем.

GetForCurrentView()

Возвращает экземпляр DisplayInformation, связанный с элементом CoreApplicationView текущего потока. Этот экземпляр DisplayInformation привязан к представлению и не может использоваться из других потоков.

События

AdvancedColorInfoChanged

Возникает при изменении дополнительных сведений о цвете.

ColorProfileChanged

Происходит при изменении цветового профиля физического дисплея.

DisplayContentsInvalidated

Происходит, когда для отображения требуется перерисовка.

DpiChanged

Происходит при изменении свойства LogicalDpi из-за изменения пикселей на дюйм (PPI) дисплея.

OrientationChanged

Происходит при изменении свойства CurrentOrientation или NativeOrientation из-за изменения режима или изменения монитора.

StereoEnabledChanged

Происходит при изменении свойства StereoEnabled из-за изменения поддержки стереоскопических трехмерных данных.

Применяется к

См. также раздел