DrawThemeBackground-Funktion (uxtheme.h)

Artikel
03/03/2024

Zeichnet den Rahmen und die Füllung, die durch den visuellen Stil für das angegebene Steuerelementteil definiert sind.

Syntax

HRESULT DrawThemeBackground(
  [in] HTHEME  hTheme,
  [in] HDC     hdc,
  [in] int     iPartId,
  [in] int     iStateId,
  [in] LPCRECT pRect,
  [in] LPCRECT pClipRect
);

Parameter

[in] hTheme

Typ: HTHEME

Behandeln Sie die angegebenen Designdaten eines Fensters. Verwenden Sie OpenThemeData , um ein HTHEME zu erstellen.

[in] hdc

Typ: HDC

HDC zum Zeichnen des designdefinierten Hintergrundbilds.

[in] iPartId

Typ: int

Wert des Typs int , der das zu zeichnende Teil angibt. Weitere Informationen finden Sie unter Teile und Zustände.

[in] iStateId

Typ: int

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

[in] pRect

Typ: const RECT*

Zeiger auf eine RECT-Struktur , die das Rechteck in logischen Koordinaten enthält, in dem das Hintergrundbild gezeichnet wird.

[in] pClipRect

Typ: const RECT*

Zeiger auf eine RECT-Struktur , die ein Abschneiderecht enthält. Dieser Parameter kann auf NULL festgelegt werden.

Rückgabewert

Typ: HRESULT

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

Hinweise

Zeichnungsvorgänge werden so skaliert, dass sie dem in pRect angegebenen Rechteck entsprechen und nicht überschreiten. Ihre Anwendung sollte nicht außerhalb des durch pClipRect angegebenen Rechtecks zeichnen.

Beispiele

Bevor Sie DrawThemeBackground aufrufen, um das Hintergrundbild für ein Fenster zu zeichnen, können Sie IsThemeBackgroundPartiallyTransparent aufrufen. Diese Methode bestimmt, ob DrawThemeParentBackground aufgerufen werden soll, um hinter teilweise transparenten oder alpha-gemischten untergeordneten Steuerelementen im Hintergrund zu zeichnen. Dies wird im folgenden Beispiel veranschaulicht.

if (_hTheme)
{
  if (IsThemeBackgroundPartiallyTransparent(_hTheme, BP_PUSHBUTTON, _iStateId))
  {
    DrawThemeParentBackground(_hwnd, hdcPaint, prcPaint);
  }

  DrawThemeBackground(_hTheme,
                    hdcPaint,
                    BP_PUSHBUTTON,
                    _iStateId,
                    &rcClient,
                    prcPaint);
}

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

Eigenschaftsbezeichner

Freigeben über