Estructura TBBUTTONINFOA (commctrl.h)

Contiene o recibe información de un botón específico en una barra de herramientas.

Sintaxis

typedef struct {
  UINT      cbSize;
  DWORD     dwMask;
  int       idCommand;
  int       iImage;
  BYTE      fsState;
  BYTE      fsStyle;
  WORD      cx;
  DWORD_PTR lParam;
  LPSTR     pszText;
  int       cchText;
} TBBUTTONINFOA, *LPTBBUTTONINFOA;

Miembros

cbSize

Tipo: UINT de

Tamaño de la estructura, en bytes. Este miembro debe rellenarse antes de enviar el mensaje asociado.

dwMask

Tipo: DWORD de

Conjunto de marcas que indican qué miembros contienen información válida. Este miembro debe rellenarse antes de enviar el mensaje asociado. Puede ser uno o varios de los siguientes valores.

Valor	Significado
TBIF_BYINDEX	Versión 5.80. El wParam enviado con un mensaje de TB_GETBUTTONINFO o TB_SETBUTTONINFO es un índice, no un identificador.
TBIF_COMMAND	El miembro idCommand contiene información válida o se solicita.
TBIF_IMAGE	El miembro iImage contiene información válida o se solicita.
TBIF_LPARAM	El miembro lParam contiene información válida o se solicita.
TBIF_SIZE	El miembro cx contiene información válida o se solicita.
TBIF_STATE	El miembro fsState contiene información válida o se solicita.
TBIF_STYLE	El miembro fsStyle contiene información válida o se solicita.
TBIF_TEXT	El miembro pszText contiene información válida o se solicita.

idCommand

Tipo: int

Identificador de comando del botón.

iImage

Tipo: int

Índice de imagen del botón. Establezca este miembro en I_IMAGECALLBACK y la barra de herramientas enviará el código de notificación TBN_GETDISPINFO para recuperar el índice de imagen cuando sea necesario.

versión 5.81. Establezca este miembro en I_IMAGENONE para indicar que el botón no tiene una imagen. El diseño del botón no incluirá ningún espacio para un mapa de bits, solo texto.

fsState

Tipo: byte de

Marcas de estado del botón. Puede ser uno o varios de los valores enumerados en Estados del botón de barra de herramientas.

fsStyle

Tipo: byte de

Marcas de estilo del botón. Puede ser uno o varios de los valores enumerados en Control de barra de herramientas y Estilos de botón.

cx

Tipo: word

Ancho del botón, en píxeles.

lParam

Tipo: DWORD_PTR

Valor definido por la aplicación asociado al botón.

pszText

Tipo: LPTSTR de

Dirección de un búfer de caracteres que contiene o recibe el texto del botón.

cchText

Tipo: int

Tamaño del búfer en pszText. Si se establece la información del botón, se omite este miembro.

Observaciones

Nota

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