Compartir a través de

Estructura NMHDDISPINFOA (commctrl.h)

  • Artículo

Contiene información que se usa para controlar HDN_GETDISPINFO códigos de notificación.

Sintaxis

typedef struct tagNMHDDISPINFOA {
  NMHDR  hdr;
  int    iItem;
  UINT   mask;
  LPSTR  pszText;
  int    cchTextMax;
  int    iImage;
  LPARAM lParam;
} NMHDDISPINFOA, *LPNMHDDISPINFOA;

Miembros

hdr

Tipo: NMHDR

estructura de NMHDR que contiene información sobre este código de notificación.

iItem

Tipo: int

Índice de base cero del elemento en el control de encabezado.

mask

Tipo: UINT de

Conjunto de marcas de bits que especifican qué miembros de la estructura deben rellenar el propietario del control de encabezado. Este valor puede ser una combinación de los siguientes valores:

Valor Significado
HDI_TEXT
 El campo pszText debe rellenarse.
HDI_IMAGE

versión 4.70. El campo iImage debe rellenarse.
HDI_LPARAM
 El campo lParam debe rellenarse.
HDI_DI_SETITEM

versión 4.70. Valor devuelto. Indica que el control de encabezado debe almacenar la información del elemento y no volver a solicitarla.

pszText

Tipo: LPTSTR de

Puntero a una cadena terminada en null que contiene el texto que se mostrará para el elemento de encabezado.

cchTextMax

Tipo: int

Tamaño del búfer al que pszText apunta.

iImage

Tipo: int

Índice de base cero de una imagen dentro de la lista de imágenes. La imagen especificada se mostrará con el elemento de encabezado, pero no tiene lugar el mapa de bits del elemento. Si iImage se establece en I_IMAGECALLBACK, el control solicita información de imagen para este elemento mediante un código de notificación HDN_GETDISPINFO.

lParam

Tipo: LPARAM de

Valor definido por la aplicación que se va a asociar al elemento.

Observaciones

Nota

El encabezado commctrl.h define NMHDDISPINFO como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
encabezado de commctrl.h