Méthode INameSpaceTreeControlCustomDraw ::ItemPrePaint (shobjidl.h)

Article
08/26/2023

Appelé avant qu’un élément du contrôle d’arborescence de l’espace de noms ne soit dessiné.

Syntaxe

HRESULT ItemPrePaint(
  [in]      HDC            hdc,
  [in]      RECT           *prc,
  [in]      NSTCCUSTOMDRAW *pnstccdItem,
  [in, out] COLORREF       *pclrText,
  [in, out] COLORREF       *pclrTextBk,
  [out]     LRESULT        *plres
);

Paramètres

[in] hdc

Type : HDC

Handle du contexte d’appareil du contrôle. Utilisez ce HDC pour effectuer des fonctions GDI.

[in] prc

Type : RECT*

Pointeur vers la structure RECT qui décrit le rectangle englobant de la zone en cours de dessin.

[in] pnstccdItem

Type : NSTCCUSTOMDRAW*

Pointeur vers la structure NSTCCUSTOMDRAW qui détermine les détails du dessin.

[in, out] pclrText

Type : COLORREF*

Lors de l’entrée, pointeur vers une structure COLORREF qui déclare la couleur par défaut du texte. Lorsque cette méthode retourne, contient un pointeur vers une structure COLORREF qui déclare la couleur qui doit être utilisée à sa place, le cas échéant. Cela permet au client de fournir sa propre couleur s’il ne souhaite pas utiliser la valeur par défaut.

[in, out] pclrTextBk

Type : COLORREF*

Lors de l’entrée, pointeur vers une structure COLORREF qui déclare la couleur par défaut de l’arrière-plan. Lorsque cette méthode retourne, contient un pointeur vers une structure COLORREF qui déclare la couleur qui doit être utilisée à sa place, le cas échéant. Cela permet au client de fournir sa propre couleur s’il ne souhaite pas utiliser la valeur par défaut.

[out] plres

Type : LRESULT*

Lorsque cette méthode retourne, contient un pointeur vers un LRESULT, qui pointe vers une ou plusieurs valeurs de l’énumération des constantes CDRF .

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl.h

Voir aussi

INameSpaceTreeControlCustomDraw

Partager via