SetWindowTheme 함수(uxtheme.h)

창에서 해당 클래스가 일반적으로 사용하는 것과 다른 시각적 스타일 정보 집합을 사용하도록 합니다.

구문

HRESULT SetWindowTheme(
  [in] HWND    hwnd,
  [in] LPCWSTR pszSubAppName,
  [in] LPCWSTR pszSubIdList
);

매개 변수

[in] hwnd

형식: HWND

비주얼 스타일 정보를 변경할 창에 대한 핸들입니다.

[in] pszSubAppName

형식: LPCWSTR

호출하는 애플리케이션 이름 대신 사용할 애플리케이션 이름이 들어 있는 문자열에 대한 포인터입니다. 이 매개 변수가 NULL이면 호출 애플리케이션의 이름이 사용됩니다.

[in] pszSubIdList

형식: LPCWSTR

창의 클래스에서 전달된 실제 목록 대신 사용할 CLSID 이름의 세미콜론으로 구분된 목록을 포함하는 문자열에 대한 포인터입니다. 이 매개 변수가 NULL이면 호출 클래스의 ID 목록이 사용됩니다.

반환 값

형식: HRESULT

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

테마 관리자는 나중에 시각적 스타일이 변경되더라도 창의 수명 동안 pszSubAppName 및 pszSubIdList 연결을 유지합니다. 새 비주얼 스타일을 찾아 적용할 수 있도록 SetWindowTheme 호출이 끝날 때 창에 WM_THEMECHANGED 메시지가 전송됩니다.

pszSubAppName 및 pszSubIdList가 NULL이면 테마 관리자는 이전에 적용된 연결을 제거합니다. 섹션 항목과 일치하지 않는 빈 문자열(L" ")을 지정하여 시각적 스타일이 지정된 창에 적용되지 않도록 할 수 있습니다.

예제

다음 예제 코드는 목록 보기 컨트롤에 Windows Explorer 목록의 모양을 제공합니다.

SetWindowTheme(hwndList, L"Explorer", NULL);

요구 사항

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