OpenThemeDataForDpi 함수(uxtheme.h)

특정 DPI와 연결된 테마 핸들을 여는 OpenThemeData 의 변형입니다.

구문

HTHEME OpenThemeDataForDpi(
  HWND    hwnd,
  LPCWSTR pszClassList,
  UINT    dpi
);

매개 변수

hwnd

테마 데이터가 필요한 창의 핸들입니다.

pszClassList

세미콜론으로 구분된 클래스 목록을 포함하는 문자열에 대한 포인터입니다.

dpi

테마 핸들을 연결할 지정된 DPI 값입니다. 이 값이 연결된 모니터 집합에 해당하는 값을 벗어나면 함수가 오류를 반환합니다.

반환 값

OpenThemeData를 참조하세요.

설명

OpenThemeData 는 모니터당 v2 창과 함께 사용할 때 창의 DPI와 연결된 테마 핸들을 만듭니다. OpenThemeDataForDpi를 사용하면 해당 DPI에 창이 없는 경우 특정 DPI에 대한 테마 핸들을 열 수 있습니다.

요청된 DPI 값이 현재 연결된 디스플레이에 해당하지 않으면 반환된 테마 핸들의 동작이 훼손됩니다. 테마 시스템은 현재 연결된 디스플레이에 해당하는 DPI 값 집합에 대한 테마 자산만 로드합니다.

시스템에서 테마 데이터를 다시 로드할 때마다 테마 핸들이 무효화됩니다. 애플리케이션은 WM_THEMECHANGED 모니터링하고 모든 테마 핸들을 닫고 다시 열어야 합니다. 이 동작은 OpenThemeData 또는 OpenThemeDataForDpi를 통해 핸들이 열렸는지 여부에 관계없이 동일합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10 버전 1703 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2016 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	uxtheme.h
라이브러리	uxtheme.lib
DLL	uxtheme.dll

추가 정보

OpenThemeData