Estructura NMTBDISPINFOA (commctrl.h)

Contiene y recibe información para mostrar de un elemento de barra de herramientas. Esta estructura se usa con el código de notificación de TBN_GETDISPINFO.

Sintaxis

typedef struct {
  NMHDR     hdr;
  DWORD     dwMask;
  int       idCommand;
  DWORD_PTR lParam;
  int       iImage;
  LPSTR     pszText;
  int       cchText;
} NMTBDISPINFOA, *LPNMTBDISPINFOA;

Miembros

hdr

Tipo: NMHDR

estructura de NMHDR que contiene información adicional sobre la notificación.

dwMask

Tipo: DWORD de

Conjunto de marcas que indican qué miembros de esta estructura se solicitan. Puede ser uno o varios de los siguientes valores.

Valor	Significado
TBNF_IMAGE	Se solicita el índice de imagen del elemento. El índice de imagen debe colocarse en el miembro iImage.
TBNF_TEXT	Actualmente no se ha implementado.
TBNF_DI_SETITEM	Establezca esta marca al procesar TBN_GETDISPINFO; el control de la barra de herramientas conservará la información proporcionada y no la solicitará de nuevo.

idCommand

Tipo: int

Identificador de comando del elemento para el que se solicita información para mostrar. El control rellena este miembro antes de enviar el código de notificación.

lParam

Tipo: DWORD_PTR

Valor definido por la aplicación asociado al elemento para el que se solicita información para mostrar. El control rellena este miembro antes de enviar el código de notificación.

iImage

Tipo: int

Índice de imagen del elemento.

pszText

Tipo: LPTSTR de

Puntero a un búfer de caracteres que recibe el texto del elemento.

cchText

Tipo: int

Tamaño del búfer de pszText, en caracteres.

Observaciones

Nota

El encabezado commctrl.h define NMTBDISPINFO 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