Estructura TBBUTTON (commctrl.h)

Contiene información sobre un botón de una barra de herramientas.

Sintaxis

typedef struct _TBBUTTON {
  int       iBitmap;
  int       idCommand;
  BYTE      fsState;
  BYTE      fsStyle;
#if ...
  BYTE      bReserved[6];
#else
  BYTE      bReserved[2];
#endif
  DWORD_PTR dwData;
  INT_PTR   iString;
} TBBUTTON, *PTBBUTTON, *LPTBBUTTON;

Miembros

iBitmap

Tipo: int

Índice de base cero de la 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.

Si el botón es un separador, es decir, si fsStyle se establece en BTNS_SEP, iBitmap determina el ancho del separador, en píxeles. Para obtener información sobre cómo seleccionar imágenes de botón de listas de imágenes, consulte TB_SETIMAGELIST mensaje.

idCommand

Tipo: int

Identificador de comando asociado al botón. Este identificador se usa en un mensaje de WM_COMMAND cuando se elige el botón.

fsState

Tipo: BYTE

Marcas de estado del botón. Este miembro puede ser una combinación de los valores enumerados en Estados del botón de la barra de herramientas.

fsStyle

Tipo: BYTE

Estilo de botón. Este miembro puede ser una combinación de los valores de estilo de botón enumerados en Control de barra de herramientas y Estilos de botón.

bReserved[6]

Tipo: BYTE

Reservado.

bReserved[2]

Tipo: BYTE

Reservado.

dwData

Tipo: DWORD_PTR

Valor definido por la aplicación.

iString

Tipo: INT_PTR

Índice de base cero de la cadena de botón o un puntero a un búfer de cadenas que contiene texto para el botón.

Comentarios

El miembro iString puede devolver un puntero de cadena o un índice. Puede usar la macro IS_INTRESOURCE para determinar cuál se devuelve.

Requisitos

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