DPI_AWARENESS_CONTEXT 핸들

  • 아티클

창에 대한 인식 컨텍스트를 식별합니다.

Syntax

#define DPI_AWARENESS_CONTEXT_UNAWARE              ((DPI_AWARENESS_CONTEXT)-1)
#define DPI_AWARENESS_CONTEXT_SYSTEM_AWARE         ((DPI_AWARENESS_CONTEXT)-2)
#define DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE    ((DPI_AWARENESS_CONTEXT)-3)
#define DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2 ((DPI_AWARENESS_CONTEXT)-4)
#define DPI_AWARENESS_CONTEXT_UNAWARE_GDISCALED    ((DPI_AWARENESS_CONTEXT)-5)

상수

DPI_AWARENESS_CONTEXT_UNAWARE

DPI를 인식하지 못합니다. 이 창은 DPI 변경에 대해 크기가 조정되지 않으며 항상 100%(96DPI)의 배율 인수로 간주됩니다. 다른 DPI 설정에서 시스템에 의해 자동으로 크기가 조정됩니다.

DPI_AWARENESS_CONTEXT_SYSTEM_AWARE

시스템 DPI 인식. 이 창은 DPI 변경에 대해 크기가 조정되지 않습니다. DPI를 한 번 쿼리하고 프로세스 수명 동안 해당 값을 사용합니다. DPI가 변경되면 프로세스가 새 DPI 값으로 조정되지 않습니다. DPI가 시스템 값에서 변경되면 시스템에 의해 자동으로 확장 또는 축소됩니다.

DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE

모니터별 DPI 인식. 이 창은 DPI가 만들어질 때 DPI를 확인하고 DPI가 변경 될 때마다 배율 인수를 조정합니다. 이러한 프로세스는 시스템에 의해 자동으로 확장되지 않습니다.

DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2

모니터당 v2라고도 합니다. 애플리케이션이 최상위 창별로 새 DPI 관련 크기 조정 동작에 액세스할 수 있도록 하는 원래 모니터별 DPI 인식 모드에 대한 향상된 기능입니다.
모니터별 v2는 Windows 10 크리에이터스 업데이트에서 사용할 수 있으며 이전 버전의 운영 체제에서는 사용할 수 없습니다.
도입된 추가 동작은 다음과 같습니다.

  • 자식 창 DPI 변경 알림 - 모니터별 v2 컨텍스트에서 전체 창 트리에 발생하는 모든 DPI 변경 내용에 대한 알림이 표시됩니다.
  • 비 클라이언트 영역 크기 조정 - 모든 창에는 DPI에 민감한 방식으로 비 클라이언트 영역이 자동으로 그려집니다. EnableNonClientDpiScaling에 대한 호출은 필요하지 않습니다.
  • Win32 메뉴 크기 조정 - 모니터별 v2 컨텍스트에서 만든 모든 NTUSER 메뉴는 모니터별로 크기가 조정됩니다.
  • 대화 상자 크기 조정 - 모니터별 v2 컨텍스트에서 만든 Win32 대화 상자는 DPI 변경 내용에 자동으로 응답합니다.
  • comctl32 컨트롤의 크기 조정 개선 - 다양한 comctl32 컨트롤은 모니터별 v2 컨텍스트에서 DPI 크기 조정 동작을 개선했습니다.
  • 향상된 테마 동작 - 모니터별 v2 창의 컨텍스트에서 열린 UxTheme 핸들은 해당 창과 연결된 DPI 측면에서 작동합니다.

DPI_AWARENESS_CONTEXT_UNAWARE_GDISCALED

DPI는 GDI 기반 콘텐츠의 품질 향상을 인식하지 못합니다. 이 모드는 DPI_AWARENESS_CONTEXT_UNAWARE 비슷하게 동작하지만, 높은 DPI 모니터에 창이 표시될 때 시스템에서 텍스트 및 기타 GDI 기반 기본 형식의 렌더링 품질을 자동으로 개선할 수 있습니다.

자세한 내용은 GDI 기반 데스크톱 앱에서 높은 DPI 환경 개선을 참조하세요.

DPI_AWARENESS_CONTEXT_UNAWARE_GDISCALED 2018년 10월 Windows 10 업데이트(버전 1809라고도 함)에 도입되었습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows 10 버전 1607 [데스크톱 앱만 해당]
지원되는 최소 서버
 지원되는 버전 없음
헤더
windef.h

추가 정보

AreDpiAwarenessContextsEqual

GetAwarenessFromDpiAwarenessContext

GetDpiFromDpiAwarenessContext

GetThreadDpiAwarenessContext

GetWindowDpiAwarenessContext

IsValidDpiAwarenessContext

SetProcessDpiAwarenessContext

SetThreadDpiAwarenessContext