_CUSTOMDRAW nm (mode liste) Code de notification

Envoyé par un contrôle List-View pour notifier à ses fenêtres parentes les opérations de dessin. Ce code de notification est envoyé sous la forme d’un message WM _ Notify .

NM_CUSTOMDRAW

    lpNMCustomDraw = (LPNMLVCUSTOMDRAW) lParam;

Paramètres

lParam

Pointeur vers une structure NMLVCUSTOMDRAW qui contient des informations sur l’opération de dessin. Le premier membre de cette structure, NMCD, est un pointeur vers une structure NMCUSTOMDRAW . Le membre dwItemSpec de la structure vers laquelle pointe NMCD contient l’identificateur de l’élément qui est dessiné et le membre lItemlParam contient ses données définies par l’application.

Valeur retournée

La valeur que votre application peut retourner dépend de l’étape de dessin actuelle. Le membre dwDrawStage de la structure NMCUSTOMDRAW associée contient une valeur qui spécifie la phase de dessin. Vous devez retourner l’une des valeurs suivantes.

Code de retour Description
CDRF _ par défaut
Le contrôle se dessine lui-même. Il n’enverra pas de codes de notification _ CUSTOMDRAW nm supplémentaires pour ce cycle de peinture. Cela se produit lorsque dwDrawStage est égal à CDDS _ prépaint.
CDRF, _ INerase
Windows Vista. Le contrôle peint uniquement l’arrière-plan.
CDRF _ NOTIFYITEMDRAW
Le contrôle notifie le parent de toutes les opérations de dessin liées aux éléments. Il envoie les codes de notification _ CUSTOMDRAW nm avant et après les éléments de dessin. Cela se produit lorsque dwDrawStage est égal à CDDS _ prépaint.
CDRF _ NOTIFYPOSTERASE
Le contrôle notifie le parent après l’effacement d’un élément. Cela se produit lorsque dwDrawStage est égal à CDDS _ prépaint.
CDRF _ NOTIFYPOSTPAINT
Le contrôle notifie le parent après avoir peint un élément. Cela se produit lorsque dwDrawStage est égal à CDDS _ prépaint.
CDRF _ NEWFONT
L’application a spécifié une nouvelle police pour l’élément ; le contrôle utilise la nouvelle police. Pour plus d’informations sur la modification des polices, consultez modification des polices et des couleurs. Cela se produit lorsque dwDrawStage est égal à CDDS _ ITEMPREPAINT.
CDRF _ NOTIFYSUBITEMDRAW
Version 4,71. Votre application recevra un code de contrôle _ CUSTOMDRAW nm avec dwDrawStage défini sur CDDS _ ITEMPREPAINT CDDS sous- | _ élément avant que chaque sous-élément de vue liste soit dessiné. Vous pouvez ensuite spécifier la police et la couleur de chaque sous-élément séparément ou retourner CDRF _ par défaut pour le traitement par défaut. Cela se produit lorsque dwDrawStage est égal à CDDS _ ITEMPREPAINT.
CDRF _ SKIPDEFAULT
L’application a dessiné l’élément manuellement. Le contrôle ne dessine pas l’élément. Cela se produit lorsque dwDrawStage est égal à CDDS _ ITEMPREPAINT.
CDRF _ SKIPPOSTPAINT
Windows Vista. Le contrôle ne dessine pas le rectangle de focus.

Remarques

Version 5,80. Si vous modifiez la police en retournant CDRF _ NEWFONT, le contrôle List-View peut afficher du texte tronqué. Ce comportement est nécessaire pour la compatibilité descendante avec les versions antérieures des contrôles communs. Si vous souhaitez modifier la police d’un contrôle List-View, vous obtiendrez de meilleurs résultats si vous envoyez un message CCM _ SETVERSION avec la valeur wParam définie sur 5 avant d’ajouter des éléments au contrôle.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows [Applications de bureau Vista uniquement]
Serveur minimal pris en charge
Windows Serveur 2003 [ applications de bureau uniquement]
En-tête
Commctrl. h