Estructura NMTBDISPINFOA (commctrl.h)

  • Artículo

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 NMHDR que contiene información adicional sobre la notificación.

dwMask

Tipo: DWORD

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

Valor Significado
TBNF_IMAGE
 Se solicita el índice de imagen del elemento. El índice de imagen debe colocarse en el miembro iImage .
TBNF_TEXT
 No implementado actualmente.
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

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

cchText

Tipo: int

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

Comentarios

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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado commctrl.h