GetThemeBackgroundExtent-Funktion (uxtheme.h)

Berechnet die Größe und Position des Hintergrunds, die durch den visuellen Stil definiert werden, unter Berücksichtigung des Inhaltsbereichs.

Syntax

HRESULT GetThemeBackgroundExtent(
  [in]  HTHEME  hTheme,
  [in]  HDC     hdc,
  [in]  int     iPartId,
  [in]  int     iStateId,
  [in]  LPCRECT pContentRect,
  [out] LPRECT  pExtentRect
);

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, der beim Zeichnen verwendet werden soll. Dieser Parameter kann auf NULL festgelegt werden.

[in] iPartId

Typ: int

Der Wert vom Typ int , der den Teil angibt, der den Inhalt 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, der den Inhalt enthält. Weitere Informationen finden Sie unter Teile und Zustände.

[in] pContentRect

Typ: LPCRECT

Zeiger auf eine RECT-Struktur , die das Inhaltshintergrundrechteck in logischen Koordinaten enthält. Dieses Rechteck wird von GetThemeBackgroundContentRect zurückgegeben.

[out] pExtentRect

Typ: LPRECT

Zeiger auf eine RECT-Struktur , die das Hintergrundrechteck in logischen Koordinaten empfängt. Dieses Rechteck basiert auf pContentRect.

Rückgabewert

Typ: HRESULT

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

Hinweise

Ein Design kann einen Inhaltsbereich in jedem Hintergrundbild definieren. Dies ist der Bereich, in dem Inhalte wie Text und Symbole platziert werden können, ohne Hintergrundrahmen zu überschreiben.

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

GetThemeBackgroundContentRect

Eigenschaftsbezeichner

Referenz