LVN_GETDISPINFO Benachrichtigungscode

Artikel
06/13/2023

Wird von einem Listenansichtssteuerelement an das übergeordnete Fenster gesendet. Es ist eine Anforderung an das übergeordnete Fenster, Informationen bereitzustellen, die zum Anzeigen oder Sortieren eines Listenansichtselements erforderlich sind. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.

LVN_GETDISPINFO
        
    pdi = (NMLVDISPINFO*) lParam

Parameter

lParam: Zeiger auf eine NMLVDISPINFO-Struktur . Bei der Eingabe gibt die in dieser Struktur enthaltene LVITEM-Struktur den Typ der erforderlichen Informationen an und identifiziert das interessante Element oder Unterelement. Verwenden Sie die LVITEM-Struktur , um die angeforderten Informationen an das Steuerelement zurückzugeben. Wenn Ihr Nachrichtenhandler das LVIF_DI_SETITEM-Flag im Maskenelement der LVITEM-Struktur festlegt, speichert das Listenansicht-Steuerelement die angeforderten Informationen und fordert sie nicht erneut an.

Rückgabewert

Kein Rückgabewert.

Bemerkungen

Der Benachrichtigungsempfänger wandelt lParam um, um die NMLVDISPINFO-Struktur abzurufen. Der wParam-Parameter enthält den Benachrichtigungscode.

Ein Listenansichtssteuerelement sendet den LVN_GETDISPINFO Benachrichtigungscode, um Elementinformationen abzurufen, die von der Anwendung und nicht vom Steuerelement gespeichert werden. Die Informationen können Text- oder Symbolinformationen für ein Element sein. Es können auch Elementstatusinformationen sein. Weitere Informationen zum Implementieren des Elementzustands auf Rückrufbasis finden Sie in der LVM_SETCALLBACKMASK Meldung.

Weitere Informationen zu Rückrufen in der Listenansicht finden Sie unter Rückrufelemente und Rückrufmaske.

Beispiele

Das folgende Beispiel zeigt, wie dieser Benachrichtigungscode behandelt werden kann, um den Text in den Spalten einer Listenansicht festzulegen. Die Daten für jedes Element werden in der folgenden Struktur gespeichert.

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

Es folgt der WM_NOTIFY-Handler in der Dialogprozedur.

    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...
      }

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Commctrl.h
Unicode- und ANSI-Name	LVN_GETDISPINFOW (Unicode) und LVN_GETDISPINFOA (ANSI)

Siehe auch

LVN_SETDISPINFO

Freigeben über