DisplayInformation 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
애플리케이션 보기에 대한 표시 관련 정보를 모니터링하고 제어합니다. 클래스는 클라이언트가 보기가 상주하는 디스플레이에 영향을 주는 애플리케이션 보기의 변경 내용과 애플리케이션 보기에 영향을 줄 수 있는 디스플레이의 변경 내용을 모니터링할 수 있도록 하는 이벤트를 제공합니다.
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 DisplayInformationPublic NotInheritable Class DisplayInformation- 상속
- 특성
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 속성이 변경되면 발생합니다. |