OpenThemeDataForDpi-Funktion (uxtheme.h)

Eine Variante von OpenThemeData , die ein Designhandle öffnet, das einem bestimmten DPI zugeordnet ist.

Syntax

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

Parameter

hwnd

Das Handle des Fensters, für das Designdaten erforderlich sind.

pszClassList

Ein Zeiger auf eine Zeichenfolge, die eine durch Semikolon getrennte Liste von Klassen enthält.

dpi

Der angegebene DPI-Wert, dem das Designhandle zugeordnet werden soll. Die Funktion gibt einen Fehler zurück, wenn sich dieser Wert außerhalb derjenigen befindet, die dem Satz verbundener Monitore entsprechen.

Rückgabewert

Weitere Informationen finden Sie unter OpenThemeData.

Hinweise

OpenThemeData erstellt Designhandles, die dem DPI eines Fensters zugeordnet sind, wenn sie mit Pro Monitor v2-Fenstern verwendet werden. Mit OpenThemeDataForDpi können Sie ein Designhandle für eine bestimmte DPI öffnen, wenn Sie kein Fenster für diese DPI haben.

Das Verhalten des zurückgegebenen Designhandles wird unterlaufen, wenn der angeforderte DPI-Wert nicht einer aktuell verbundenen Anzeige entspricht. Das Designsystem lädt nur Designobjekte für den Satz von DPI-Werten, die den aktuell verbundenen Displays entsprechen.

Das Designhandle wird ungültig, wenn das System die Designdaten erneut lädt. Anwendungen müssen WM_THEMECHANGED überwachen und alle Designhandles als Antwort schließen und erneut öffnen. Dieses Verhalten ist unabhängig davon identisch, ob die Handles über OpenThemeData oder OpenThemeDataForDpi geöffnet wurden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1703 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	uxtheme.h
Bibliothek	uxtheme.lib
DLL	uxtheme.dll

Weitere Informationen

Openthemedata