GetThemeBackgroundRegion-Funktion (uxtheme.h)

Berechnet den Bereich für einen regulären oder teilweise transparenten Hintergrund, der durch ein angegebenes Rechteck begrenzt wird.

Syntax

HRESULT GetThemeBackgroundRegion(
  [in]  HTHEME  hTheme,
  [in]  HDC     hdc,
  [in]  int     iPartId,
  [in]  int     iStateId,
  [in]  LPCRECT pRect,
  [out] HRGN    *pRegion
);

Parameter

[in] hTheme

Typ: HTHEME

Handle für die angegebenen Designdaten eines Fensters. Verwenden Sie OpenThemeData , um eine HTHEME zu erstellen.

[in] hdc

Typ: HDC

HDC, in den gezeichnet werden soll. Der DC verwendet die DPI-Skalierung (Dots per Inch). Dieser Parameter kann auf NULL festgelegt werden.

[in] iPartId

Typ: int

Wert vom Typ int , der den Teil angibt, der den Bereich enthält. Weitere Informationen finden Sie unter Teile und Zustände.

[in] iStateId

Typ: int

Der Wert vom Typ int , der den Zustand des Teils angibt. Weitere Informationen finden Sie unter Teile und Zustände.

[in] pRect

Typ: LPCRECT

Zeiger auf eine RECT-Struktur , die in logischen Koordinaten das angegebene Rechteck enthält, das zum Berechnen der Region verwendet wird.

[out] pRegion

Typ: HRGN*

Zeiger auf das Handle auf die berechnete Region.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Das von dieser Funktion zurückgegebene Regionshandle sollte mit DeleteObject freigegeben werden, wenn es nicht mehr benötigt wird.

Anforderungen

Anforderung	Wert
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

Andere Ressourcen

Eigenschaftsbezeichner

Referenz

Regionen