Funzione DrawThemeParentBackgroundEx (uxtheme.h)

  • Articolo

Utilizzato da controlli figlio parzialmente trasparenti o alfa per disegnare la parte del padre davanti alla quale vengono visualizzati. Invia un messaggio di WM_ERASEBKGND seguito da un WM_PRINTCLIENT.

Sintassi

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

Parametri

[in] hwnd

Tipo: HWND

Handle del controllo figlio.

[in] hdc

Tipo: HDC

HDC del controllo figlio.

[in] dwFlags

Tipo: DWORD

Zero o più dei valori seguenti. Se questo valore è zero, questa funzione restituisce S_OK solo se l'elemento padre ha gestito WM_PRINTCLIENT.

Valore Significato
DTPB_WINDOWDC
 Se impostato, si presuppone che hdc sia un controller di dominio finestra, non un controller di dominio client.
DTPB_USECTLCOLORSTATIC
 Se impostata, questa funzione invia un messaggio WM_CTLCOLORSTATIC all'elemento padre e usa il pennello, se specificato. In caso contrario, usa COLOR_BTNFACE.
DTPB_USEERASEBKGND
 Se impostata, questa funzione restituisce S_OK senza inviare un messaggio di WM_CTLCOLORSTATIC se l'elemento padre viene effettivamente disegnato su WM_ERASEBKGND.

[in] prc

Tipo: const RECT*

facoltativo. Area da disegnare, nelle coordinate figlio. Se questo parametro è NULL, l'area da disegnare include l'intera area occupata dal controllo figlio.

Valore restituito

Tipo: HRESULT

S_OK in caso di esito positivo; in caso contrario, S_FALSE.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione uxtheme.h
Libreria UxTheme.lib
DLL UxTheme.dll