OpenThemeDataEx-Funktion (uxtheme.h)

Artikel
08/26/2023

Öffnet die Designdaten, die einem Fenster für angegebene Designklassen zugeordnet sind.

Syntax

HTHEME OpenThemeDataEx(
  [in] HWND    hwnd,
  [in] LPCWSTR pszClassList,
  [in] DWORD   dwFlags
);

Parameter

[in] hwnd

Typ: HWND

Ein Handle für ein Fenster oder Steuerelement, aus dem das Design abgerufen werden soll.

[in] pszClassList

Typ: LPCWSTR

Eine durch Semikolon getrennte Liste von Klassennamen, die übereinstimmen sollen.

[in] dwFlags

Typ: DWORD

Optionale Flags, die steuern, wie die Designdaten zurückgegeben werden. Kann auf eine Kombination der folgenden Werte festgelegt werden.

Wert	Bedeutung
OTD_FORCE_RECT_SIZING	Erzwingt, dass gezeichnete Bilder aus diesem Design so gestreckt werden, dass sie den durch Zeichnungsfunktionen angegebenen Rechtecke entsprechen.
OTD_NONCLIENT	Ermöglicht das Zeichnen von Designelementen im Nicht-Clientbereich des Fensters.

Rückgabewert

Typ: HTHEME

Wenn eine Übereinstimmung gefunden wird, wird ein gültiges Handle für ein Design zurückgegeben. Andernfalls wird ein NULL-Wert zurückgegeben.

Hinweise

Die von pszClassIdList angegebene Zeichenfolge wird mithilfe von Semikolons als Trennzeichen tokenisiert. Die Namen werden jeweils tokenbasiert mit Klassennamen abgeglichen. Wenn für ein bestimmtes Token keine Übereinstimmung gefunden wird, wird das nächste Token abgeglichen. Wenn eine Übereinstimmung gefunden wird, ist der Rückgabewert der Funktion das Designhandle, das der übereinstimmenden Klasse zugeordnet ist.

Klassennamen für das Aero-Design werden in AeroStyle.xml definiert.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	uxtheme.h
Bibliothek	UxTheme.lib
DLL	UxTheme.dll

Weitere Informationen

Openthemedata

Freigeben über