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 |