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
- Наследование
- Атрибуты
Требования к 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 из-за изменения поддержки стереоскопических трехмерных данных. |
Применяется к
См. также раздел
- Пример ориентации экрана (Windows 10)
- Масштабирование в соответствии с примером DPI (Windows 10)
- Пример кадра предварительного просмотра камеры (Windows 10)
- Пример приложения "Базовая камера" (Windows 10)
- Пример стабилизации видео (Windows 10)
- Пример обнаружения лиц с камеры (Windows 10)
- Пример элементов управления камерой вручную (Windows 10)
- Пример с высоким динамическим диапазоном (Windows 10)
- Пример расширенного захвата камеры