NM_CUSTOMDRAW (visualizzazione elenco) codice di notifica

Inviato da un controllo visualizzazione elenco per notificare alle finestre padre le operazioni di disegno. Questo codice di notifica viene inviato sotto forma di messaggio di WM_NOTIFY .

NM_CUSTOMDRAW

    lpNMCustomDraw = (LPNMLVCUSTOMDRAW) lParam;

Parametri

lParam

Puntatore a una struttura NMLVCUSTOMDRAW contenente informazioni sull'operazione di disegno. Il primo membro di questa struttura , nmcd, è un puntatore a una struttura NMCUSTOMDRAW . Il membro dwItemSpec della struttura a cui punta nmcd contiene l'identificatore dell'elemento da disegnare e il membro lItemlParam contiene i dati definiti dall'applicazione.

Valore restituito

Il valore che l'applicazione può restituire dipende dalla fase di disegno corrente. Il membro dwDrawStage della struttura NMCUSTOMDRAW associata contiene un valore che specifica la fase di disegno. È necessario restituire uno dei valori seguenti.

Codice restituito	Descrizione
CDRF_DODEFAULT	Il controllo disegnerà se stesso. Non invierà altri codici di notifica NM_CUSTOMDRAW per questo ciclo di disegno. Ciò si verifica quando dwDrawStage è uguale a CDDS_PREPAINT.
CDRF_DOERASE	Windows Vista. Il controllo dipinge solo lo sfondo.
CDRF_NOTIFYITEMDRAW	Il controllo invia una notifica all'elemento padre di qualsiasi operazione di disegno correlata all'elemento. Invierà NM_CUSTOMDRAW codici di notifica prima e dopo il disegno. Ciò si verifica quando dwDrawStage è uguale a CDDS_PREPAINT.
CDRF_NOTIFYPOSTERASE	Il controllo notifica all'elemento padre dopo la cancellazione di un elemento. Ciò si verifica quando dwDrawStage è uguale a CDDS_PREPAINT.
CDRF_NOTIFYPOSTPAINT	Il controllo invia una notifica all'elemento padre dopo il disegno di un elemento. Ciò si verifica quando dwDrawStage è uguale a CDDS_PREPAINT.
CDRF_NEWFONT	L'applicazione ha specificato un nuovo tipo di carattere per l'elemento; il controllo utilizzerà il nuovo tipo di carattere. Per altre informazioni sulla modifica dei tipi di carattere, vedere Modifica di tipi di carattere e colori. Ciò si verifica quando dwDrawStage è uguale a CDDS_ITEMPREPAINT.
CDRF_NOTIFYSUBITEMDRAW	Versione 4.71. L'applicazione riceverà un codice di controllo NM_CUSTOMDRAW con dwDrawStage impostato su CDDS_ITEMPREPAINT | CDDS_SUBITEM prima che venga disegnato ogni sottoelemento della visualizzazione elenco. È quindi possibile specificare il tipo di carattere e il colore per ogni elemento secondario separatamente o restituire CDRF_DODEFAULT per l'elaborazione predefinita. Ciò si verifica quando dwDrawStage è uguale a CDDS_ITEMPREPAINT.
CDRF_SKIPDEFAULT	L'applicazione ha disegnato manualmente l'elemento. Il controllo non disegnerà l'elemento. Ciò si verifica quando dwDrawStage è uguale a CDDS_ITEMPREPAINT.
CDRF_SKIPPOSTPAINT	Windows Vista. Il controllo non disegnerà il rettangolo di messa a fuoco.

Commenti

Versione 5.80. Se si modifica il tipo di carattere restituendo CDRF_NEWFONT, il controllo visualizzazione elenco potrebbe visualizzare il testo ritagliato. Questo comportamento è necessario per la compatibilità con le versioni precedenti dei controlli comuni. Se si desidera modificare il tipo di carattere di un controllo visualizzazione elenco, si otterranno risultati migliori se si invia un messaggio di CCM_SETVERSION con il valore wParam impostato su 5 prima di aggiungere elementi al controllo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	Commctrl.h