Função SetWindowTheme (uxtheme.h)

Artigo
02/20/2025

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.

Valor de retorno

Tipo: HRESULT

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

Observações

O gerenciador de temas mantém as associações pszSubAppName e pszSubIdList durante o tempo de vida da janela, mesmo que os estilos visuais sejam alterados posteriormente. A janela é enviada WM_THEMECHANGED mensagem 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
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	uxtheme.h
biblioteca	UxTheme.lib
de DLL	UxTheme.dll

Compartilhar via