GetThemeBackgroundContentRect-Funktion (uxtheme.h)

Artikel
03/03/2024

Ruft die Größe des Inhaltsbereichs für den Hintergrund ab, der durch den visuellen Stil definiert wird.

Syntax

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

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

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

[in] iStateId

Typ: int

Wert des Typs int , der den Zustand des Teils angibt, der den Inhaltsbereich enthält. Weitere Informationen finden Sie unter Teile und Zustände.

[in] pBoundingRect

Typ: LPCRECT

Zeiger auf eine RECT-Struktur , die das gesamte Hintergrundrechteck in logischen Koordinaten enthält. Dies ist der Bereich innerhalb der Rahmen oder Ränder.

[out] pContentRect

Typ: LPRECT

Zeiger auf eine RECT-Struktur , die das Hintergrundrechteck des Inhaltsbereichs in logischen Koordinaten empfängt. Dieses Rechteck wird so berechnet, dass es dem Inhaltsbereich entspricht.

Rückgabewert

Typ: HRESULT

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

Hinweise

Ein visueller Stil kann einen Inhaltsbereich innerhalb jedes Hintergrundbilds definieren. Dies ist der Bereich, in dem Inhalte wie Text und Symbole platziert werden können, ohne Hintergrundrahmen zu überschreiben.

Beispiele

Wenn Sie ein Design auf einen gesamten Clientbereich eines Fensters anwenden, können Sie GetClientRect aufrufen, um diesen Bereich in einem RECT abzurufen, der wie im folgenden Beispiel über den Zeiger als pContentRect-Parameter an GetThemeBackgroundContentRect übergeben werden kann.

DWORD resultFlags = GetThemeAppProperties();
bool ctrlsAreThemed = ((resultFlags & STAP_ALLOW_CONTROLS) != 0);

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

GetThemeBackgroundExtent

Eigenschaftsbezeichner

Referenz

Freigeben über