Funzione OpenThemeDataForDpi (uxtheme.h)

Variante di OpenThemeData che apre un handle di tema associato a un valore DPI specifico.

Sintassi

HTHEME OpenThemeDataForDpi(
  HWND    hwnd,
  LPCWSTR pszClassList,
  UINT    dpi
);

Parametri

hwnd

Handle della finestra per cui sono necessari i dati del tema.

pszClassList

Puntatore a una stringa contenente un elenco delimitato da punto e virgola di classi.

dpi

Valore DPI specificato al quale associare l'handle del tema. La funzione restituirà un errore se questo valore è esterno a quelli che corrispondono al set di monitor connessi.

Valore restituito

Vedere OpenThemeData.

Commenti

OpenThemeData creerà handle di tema associati alla dpi di una finestra quando viene usata con le finestre Per Monitor v2. OpenThemeDataForDpi consente di aprire un handle di tema per un valore DPI specifico quando non si dispone di una finestra con tale dpi.

Il comportamento dell'handle del tema restituito verrà compromesso se il valore DPI richiesto non corrisponde a uno schermo attualmente connesso. Il sistema di tema carica solo gli asset del tema per il set di valori DPI corrispondenti agli schermi attualmente connessi.

L'handle del tema diventerà non valido ogni volta che il sistema ricarica i dati del tema. Le applicazioni sono necessarie per monitorare WM_THEMECHANGED e chiudere e riaprire tutti gli handle di tema in risposta. Questo comportamento è lo stesso indipendentemente dal fatto che gli handle siano stati aperti tramite OpenThemeData o OpenThemeDataForDpi.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 versione 1703 [solo app desktop]
Server minimo supportato	Windows Server 2016 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	uxtheme.h
Libreria	uxtheme.lib
DLL	uxtheme.dll

Vedi anche

OpenThemeData