Função SetWindowTheme (uxtheme.h)

Faz com que uma janela use um conjunto diferente de informações de estilo visual do que sua classe normalmente usa.

Sintaxe

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

Parâmetros

[in] hwnd

Tipo: HWND

Manipule para a janela cujas informações de estilo visual devem ser alteradas.

[in] pszSubAppName

Tipo: LPCWSTR

Ponteiro para uma cadeia de caracteres que contém o nome do aplicativo a ser usado no lugar do nome do aplicativo de chamada. Se esse parâmetro for NULL, o nome do aplicativo de chamada será usado.

[in] pszSubIdList

Tipo: LPCWSTR

Ponteiro para uma cadeia de caracteres que contém uma lista separada por ponto e vírgula de nomes CLSID a serem usados no lugar da lista real passada pela classe da janela. Se esse parâmetro for NULL, a lista de IDs da classe de chamada será usada.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O gerenciador de temas retém as associações pszSubAppName e pszSubIdList durante o tempo de vida da janela, mesmo se os estilos visuais forem alterados posteriormente. A janela recebe uma mensagem WM_THEMECHANGED no final de uma chamada SetWindowTheme , para que o novo estilo visual possa ser encontrado e aplicado.

Quando pszSubAppName e pszSubIdList são NULL, o gerenciador de temas remove as associações aplicadas anteriormente. Você pode impedir que estilos visuais sejam aplicados a uma janela especificada especificando uma cadeia de caracteres vazia, (L"), que não corresponde a nenhuma entrada de seção.

Exemplos

O código de exemplo a seguir fornece a um controle de exibição de lista a aparência de uma lista do Windows Explorer:

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	uxtheme.h
Biblioteca	UxTheme.lib
DLL	UxTheme.dll