_Code de notification LVN GETDISPINFO

Envoyé par un contrôle List-View à sa fenêtre parente. Il s’agit d’une demande de la fenêtre parente pour fournir les informations nécessaires à l’affichage ou au tri d’un élément de liste. Ce code de notification est envoyé sous la forme d’un message WM _ Notify .

LVN_GETDISPINFO
        
    pdi = (NMLVDISPINFO*) lParam

Paramètres

lParam

Pointeur vers une structure NMLVDISPINFO . En entrée, la structure LVITEM contenue dans cette structure spécifie le type d’informations requis et identifie l’élément ou le sous-élément d’intérêt. Utilisez la structure LVITEM pour retourner les informations demandées au contrôle. Si votre gestionnaire de messages définit l' _ indicateur LVIF di _ SETITEM dans le membre Mask de la structure LVITEM , le contrôle List-View stocke les informations demandées et ne le redemande pas.

Valeur retournée

Pas de valeur de retour.

Remarques

Le récepteur de notification convertit lParam pour récupérer la structure NMLVDISPINFO . Le paramètre wParam contient le code de notification.

Un contrôle List-View envoie le code de notification LVN _ GETDISPINFO pour récupérer des informations d’élément stockées par l’application plutôt que par le contrôle. Les informations peuvent être du texte ou des icônes pour un élément. Il peut également s’agir d’informations sur l’état de l’élément. Consultez le message _ SETCALLBACKMASK LVM pour plus d’informations sur l’implémentation de l’état des éléments sur la base d’un rappel.

Pour plus d’informations sur les rappels de vue de liste, consultez éléments de rappel et masque de rappel.

Exemples

L’exemple suivant montre comment ce code de notification peut être géré pour définir le texte dans les colonnes d’un affichage de liste. Les données de chaque élément sont stockées dans la structure suivante.

 typedef struct tagPETINFO
{
    TCHAR szName[50];
    TCHAR szBreed[50];
    TCHAR szGender[7];
    TCHAR szPrice[20];
    GroupIds iGroup;
} PETINFO;
            

Les éléments suivants proviennent du _ Gestionnaire de notification WM dans la procédure de dialogue.

    case WM_NOTIFY:
        switch (((LPNMHDR) lParam)->code)
        {
        case LVN_GETDISPINFO:
            {
                NMLVDISPINFO* plvdi = (NMLVDISPINFO*)lParam;    
                switch (plvdi->item.iSubItem)
                {
                case 0:
                    // rgPetInfo is an array of PETINFO structures.
                    plvdi->item.pszText = rgPetInfo[plvdi->item.iItem].szName;
                    break;

                case 1:
                    plvdi->item.pszText = rgPetInfo[plvdi->item.iItem].szBreed;
                    break;

                case 2:
                    plvdi->item.pszText = rgPetInfo[plvdi->item.iItem].szGender;
                    break;

                case 3:
                    plvdi->item.pszText = rgPetInfo[plvdi->item.iItem].szPrice;
                    break;

                default:
                    break;
                }
                return TRUE;
            }
      // More notifications...
      }

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
Noms Unicode et ANSI
LVN _ GETDISPINFOW (Unicode) et LVN _ GETDISPINFOA (ANSI)

Voir aussi

LVN _ SETDISPINFO