commctrl.h

Estructura NMLVDISPINFO

Definición

typedef struct tagNMLVDISPINFO {
  NMHDR   hdr;
  LVITEM item;
} NMLVDISPINFO, *PNMLVDISPINFO;

Contiene información sobre un código de notificación LVN_GETDISPINFO o LVN_SETDISPINFO. Esta estructura es la misma estructura que LV_DISPINFO, pero ha sido renombrada para ajustarse a las convenciones de nombres estándar.

Descripción

hdr
Estructura NMHDR que contiene información sobre este código de notificación.
item
Estructura LVITEM que identifica el ítem o subítem. La estructura contiene o recibe información sobre el ítem. El miembro mask contiene un conjunto de banderas de bits que especifican qué atributos de ítem son relevantes. Para más información sobre las banderas de bits disponibles, ver LVITEM.

Observaciones

Si la estructura LVITEM está recibiendo texto del ítem, los miembros pszText y cchTextMax especifican la dirección y tamaño del buffer. Se puede tanto copiar el texto al buffer como asignar la dirección de una cadena al miembro pszText. En el segundo caso, no se debe cambiar o borrar la cadena hasta que el correspondiente texto del ítem sea borrado o dos mensajes LVN_GETDISPINFO adicionales sean enviados.

Si se manipula el mensaje LVN_GETDISPINFO, se puede asignar la bandera LVIF_DI_SETITEM en el miembro mask de la estructura LVITEM. Esto indica al sistema operativo que almacene la información requerida del ítem de la lista y no volver a pedirla. Para controles list-view con el estilo LVS_REPORT, esta bandera solo se aplica a la información de la primera columna (subítem 0). El control no almacena información de subítems.

Nota: El fichero de cabecera commctrl.h define NMLVDISPINFO como un alias que selecciona automáticamente la versión ANSI o Unicode de esta estructura basándose en la constante del preprocesador UNICODE. Mezclar el uso de alias de codificación neutral con código que no use esa codificación puede producir desajustes que resulten en errores de compilación o de ejecución.