LVN_GETDISPINFO código de notificación

Enviado por un control de vista de lista a su ventana primaria. Se trata de una solicitud para que la ventana primaria proporcione información necesaria para mostrar o ordenar un elemento de vista de lista. Este código de notificación se envía en forma de mensaje de WM_NOTIFY .

LVN_GETDISPINFO
        
    pdi = (NMLVDISPINFO*) lParam

Parámetros

lParam

Puntero a una estructura NMLVDISPINFO . En la entrada, la estructura LVITEM contenida en esta estructura especifica el tipo de información necesaria e identifica el elemento o subelemento de interés. Utilice la estructura LVITEM para devolver la información solicitada al control. Si el controlador de mensajes establece la marca LVIF_DI_SETITEM en el miembro mask de la estructura LVITEM , el control de vista de lista almacena la información solicitada y no volverá a solicitarla.

Valor devuelto

No de devuelve ningún valor.

Comentarios

El receptor de notificaciones convierte lParam para recuperar la estructura NMLVDISPINFO . El parámetro wParam contiene el código de notificación.

Un control de vista de lista envía el código de notificación de LVN_GETDISPINFO para recuperar la información de elemento almacenada por la aplicación en lugar del control. La información puede ser texto o información de icono para un elemento. También puede ser información de estado del elemento. Consulte el mensaje LVM_SETCALLBACKMASK para obtener más información sobre la implementación del estado del elemento en una devolución de llamada.

Para obtener más información sobre las devoluciones de llamada de vista de lista, vea Elementos de devolución de llamada y máscara de devolución de llamada.

Ejemplos

En el ejemplo siguiente se muestra cómo se puede controlar este código de notificación para establecer el texto en las columnas de una vista de lista. Los datos de cada elemento se mantienen en la estructura siguiente.

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

Lo siguiente es del controlador de WM_NOTIFY en el procedimiento de diálogo.

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

Requisitos

Requisito Value
Cliente mínimo compatible
Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible
Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado
Commctrl.h
Nombres Unicode y ANSI
LVN_GETDISPINFOW (Unicode) y LVN_GETDISPINFOA (ANSI)

Consulte también

LVN_SETDISPINFO