Estructura TBBUTTONINFOA (commctrl.h)

  • Artículo

Contiene o recibe información de un botón específico de 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

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

dwMask

Tipo: DWORD

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 valores siguientes.

Valor Significado
TBIF_BYINDEX

Versión 5.80. WParam enviado con un TB_GETBUTTONINFO o TB_SETBUTTONINFO mensaje 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

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

fsStyle

Tipo: BYTE

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

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.

Comentarios

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 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