DrawThemeParentBackgroundEx-Funktion (uxtheme.h)

  • Artikel

Wird von teilweise transparenten oder alpha-gemischten untergeordneten Steuerelementen verwendet, um den Teil ihres übergeordneten Steuerelements zu zeichnen, vor dem sie angezeigt werden. Sendet eine WM_ERASEBKGND Nachricht gefolgt von einer WM_PRINTCLIENT.

Syntax

HRESULT DrawThemeParentBackgroundEx(
  [in] HWND       hwnd,
  [in] HDC        hdc,
  [in] DWORD      dwFlags,
  [in] const RECT *prc
);

Parameter

[in] hwnd

Typ: HWND

Handle des untergeordneten Steuerelements.

[in] hdc

Typ: HDC

HDC des untergeordneten Steuerelements.

[in] dwFlags

Typ: DWORD

Null oder mehr der folgenden Werte. Wenn dieser Wert 0 ist, gibt diese Funktion S_OK nur zurück, wenn das übergeordnete Element WM_PRINTCLIENT verarbeitet hat.

Wert Bedeutung
DTPB_WINDOWDC
 Wenn festgelegt, wird hdc als Fenster-DC und nicht als Client-DC angenommen.
DTPB_USECTLCOLORSTATIC
 Wenn festgelegt, sendet diese Funktion eine WM_CTLCOLORSTATIC-Nachricht an das übergeordnete Element und verwendet den Pinsel, falls vorhanden. Andernfalls wird COLOR_BTNFACE verwendet.
DTPB_USEERASEBKGND
 Wenn festgelegt, gibt diese Funktion S_OK zurück, ohne eine WM_CTLCOLORSTATIC Nachricht zu senden, wenn das übergeordnete Element tatsächlich auf WM_ERASEBKGND gezeichnet wurde.

[in] prc

Typ: const RECT*

Optional. Der zu zeichnende Bereich in untergeordneten Koordinaten. Wenn dieser Parameter NULL ist, enthält der zu zeichnende Bereich den gesamten Bereich, der vom untergeordneten Steuerelement belegt wird.

Rückgabewert

Typ: HRESULT

S_OK bei erfolgreicher Ausführung; andernfalls S_FALSE.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile uxtheme.h
Bibliothek UxTheme.lib
DLL UxTheme.dll