Funzione SetWindowTheme (uxtheme.h)

Articolo
02/20/2025

Fa in modo che una finestra usi un set diverso di informazioni sullo stile di visualizzazione rispetto alla relativa classe utilizzata normalmente.

Sintassi

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

Parametri

[in] hwnd

Tipo: HWND

Handle nella finestra le cui informazioni sullo stile di visualizzazione devono essere modificate.

[in] pszSubAppName

Tipo: LPCWSTR

Puntatore a una stringa contenente il nome dell'applicazione da usare al posto del nome dell'applicazione chiamante. Se questo parametro è NULL, viene usato il nome dell'applicazione chiamante.

[in] pszSubIdList

Tipo: LPCWSTR

Puntatore a una stringa contenente un elenco delimitato da punto e virgola di nomi CLSID da usare al posto dell'elenco effettivo passato dalla classe della finestra. Se questo parametro è NULL, viene usato l'elenco ID della classe chiamante.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT.

Osservazioni

Il gestore dei temi mantiene le pszSubAppName e il pszSubIdList associazioni attraverso la durata della finestra, anche se gli stili di visualizzazione cambiano successivamente. La finestra viene inviata una WM_THEMECHANGED messaggio alla fine di una chiamata SetWindowTheme, in modo che sia possibile trovare e applicare il nuovo stile di visualizzazione.

Quando pszSubAppName e pszSubIdList sono NULL, il gestore dei temi rimuove le associazioni applicate in precedenza. È possibile impedire l'applicazione degli stili di visualizzazione a una finestra specificata specificando una stringa vuota (L""), che non corrisponde ad alcuna voce di sezione.

Esempi

Il codice di esempio seguente fornisce a un controllo visualizzazione elenco l'aspetto di un elenco di Esplora risorse:

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

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	uxtheme.h
libreria	UxTheme.lib
dll	UxTheme.dll

Condividi tramite