estructura BUTTON_SPLITINFO (commctrl.h)

  • Artículo

Contiene información que define un botón de división (BS_SPLITBUTTON y estilos de BS_DEFSPLITBUTTON ). Se usa con los mensajes BCM_GETSPLITINFO y BCM_SETSPLITINFO .

Sintaxis

typedef struct tagBUTTON_SPLITINFO {
  UINT       mask;
  HIMAGELIST himlGlyph;
  UINT       uSplitStyle;
  SIZE       size;
} BUTTON_SPLITINFO, *PBUTTON_SPLITINFO;

Miembros

mask

Tipo: UINT

Conjunto de marcas que especifican qué miembros de esta estructura contienen datos que se van a establecer o qué miembros se solicitan. Establezca este miembro en una o varias de las marcas siguientes.

Valor Significado
BCSIF_GLYPH
 himlGlyph es válido.
BCSIF_IMAGE
 himlGlyph es válido. Use cuando uSplitStyle esté establecido en BCSS_IMAGE.
BCSIF_SIZE
 size es válido.
BCSIF_STYLE
 uSplitStyle es válido.

himlGlyph

Tipo: HIMAGELIST

Identificador de la lista de imágenes. El proveedor conserva la propiedad de la lista de imágenes y, en última instancia, es responsable de su eliminación.

uSplitStyle

Tipo: UINT

Estilo de botón de división. El valor debe ser uno o varios de los siguientes marcadores.

Valor Significado
BCSS_ALIGNLEFT
 Alinee la imagen o glifo horizontalmente con el margen izquierdo.
BCSS_IMAGE
 Dibuje una imagen de icono como glifo.
BCSS_NOSPLIT
 Sin división.
BCSS_STRETCH
 Glifo extendido, pero intenta conservar la relación de aspecto.

size

Tipo: SIZE

Estructura SIZE que especifica el tamaño del glifo en himlGlyph.

Comentarios

El glifo es la imagen que aparece en la parte del botón que activa la lista desplegable. De forma predeterminada, se trata de un triángulo invertido. Se pueden agregar varias imágenes a la lista de imágenes para proporcionar diferentes glifos para diferentes estados del botón, como frecuente y presionado.

Requisitos

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

Consulte también

Información general sobre botones