Funzione SetWindowTheme (uxtheme.h)

Articolo
03/03/2024

Fa in modo che una finestra usi un set diverso di informazioni sullo stile di visualizzazione rispetto alla relativa classe usata 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 utilizzare 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 .

Commenti

Gestione temi mantiene le associazioni pszSubAppName e pszSubIdList per tutta 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 a SetWindowTheme , in modo che sia possibile trovare e applicare il nuovo stile di visualizzazione.

Quando pszSubAppName e pszSubIdList sono NULL, gestione 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.

Esempio

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

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	uxtheme.h
Libreria	UxTheme.lib
DLL	UxTheme.dll

Condividi tramite