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 instance 특정 디스플레이에 매핑되지 않고 대신 애플리케이션 보기가 배치되는 위치에 대한 표시 관련 정보를 추적합니다. GetForCurrentView를 호출하면 항상 현재 스레드의 CoreApplicationView에 대한 단일 instance 반환됩니다. DisplayInformation의 instance 만든 스레드에서만 사용할 수 있습니다.

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(International Color Consortium) 색 프로필을 비동기적으로 가져옵니다.
GetForCurrentView()

현재 스레드의 CoreApplicationView와 연결된 DisplayInformation instance 가져옵니다. 이 DisplayInformation instance 보기에 연결되며 다른 스레드에서는 사용할 수 없습니다.

이벤트

AdvancedColorInfoChanged

고급 색 정보가 변경될 때 발생합니다.
ColorProfileChanged

실제 디스플레이의 색 프로필이 변경될 때 발생합니다.
DisplayContentsInvalidated

디스플레이에 다시 그리기가 필요할 때 발생합니다.
DpiChanged

디스플레이의 PPI(인치당 픽셀)가 변경되므로 LogicalDpi 속성이 변경되면 발생합니다.
OrientationChanged

모드 변경 또는 모니터 변경으로 인해 CurrentOrientation 또는 NativeOrientation 속성이 변경되면 발생합니다.
StereoEnabledChanged

스테레오스코픽 3D에 대한 지원이 변경되므로 StereoEnabled 속성이 변경되면 발생합니다.

적용 대상

추가 정보