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
Referenz