LVN_GETDISPINFO kode pemberitahuan

Dikirim oleh kontrol tampilan daftar ke jendela induknya. Ini adalah permintaan untuk jendela induk untuk memberikan informasi yang diperlukan untuk menampilkan atau mengurutkan item tampilan daftar. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY .

LVN_GETDISPINFO
        
    pdi = (NMLVDISPINFO*) lParam

Parameter

lParam

Arahkan ke struktur NMLVDISPINFO . Pada input, struktur LVITEM yang terkandung dalam struktur ini menentukan jenis informasi yang diperlukan dan mengidentifikasi item atau subitem yang diminati. Gunakan struktur LVITEM untuk mengembalikan informasi yang diminta ke kontrol. Jika penangan pesan Anda menetapkan bendera LVIF_DI_SETITEM di anggota masker struktur LVITEM , kontrol tampilan daftar menyimpan informasi yang diminta dan tidak akan memintanya lagi.

Nilai kembali

Tidak ada nilai yang ditampilkan.

Keterangan

Penerima pemberitahuan melemparkan lParam untuk mengambil struktur NMLVDISPINFO . Parameter wParam berisi kode pemberitahuan.

Kontrol tampilan daftar mengirimkan kode pemberitahuan LVN_GETDISPINFO untuk mengambil informasi item yang disimpan oleh aplikasi daripada kontrol. Informasi dapat berupa teks atau informasi ikon untuk item. Ini juga bisa menjadi informasi status item. Lihat pesan LVM_SETCALLBACKMASK untuk informasi selengkapnya tentang menerapkan status item berdasarkan panggilan balik.

Untuk informasi selengkapnya tentang panggilan balik tampilan daftar, lihat Item Panggilan Balik dan Masker Panggilan Balik.

Contoh

Contoh berikut menunjukkan bagaimana kode pemberitahuan ini mungkin ditangani untuk mengatur teks dalam kolom tampilan daftar. Data untuk setiap item disimpan dalam struktur berikut.

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

Berikut ini berasal dari handler WM_NOTIFY dalam prosedur dialog.

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

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung
Windows Server 2003 [hanya aplikasi desktop]
Header
Commctrl.h
Nama Unicode dan ANSI
LVN_GETDISPINFOW (Unicode) dan LVN_GETDISPINFOA (ANSI)

Lihat juga

LVN_SETDISPINFO