Estilos de botón y control de barra de herramientas

Los siguientes estilos de ventana son específicos de las barras de herramientas. Se combinan con otros estilos de ventana cuando se crea la barra de herramientas.

Nota Para Common Controls versión 6.00, si se usa un estilo visual con la barra de herramientas, los botones siempre son transparentes independientemente de la configuración de estilo. De lo contrario, el comportamiento de transparencia es normal según lo indicado por el uso del estilo TBSTYLE_FLAT o TBSTYLE_TRANSPARENT.

Nota

Comctl32.dll versión 6 no se puede redistribuir, pero se incluye en Windows. Para usar Comctl32.dll versión 6, especifíquelo en un manifiesto. Para obtener más información sobre los manifiestos, consulte Habilitación de estilos visuales.

Constante	Descripción
TBSTYLE_ALTDRAG	Permite a los usuarios cambiar la posición de un botón de barra de herramientas arrastrándolo mientras mantiene presionada la tecla ALT. Si no se especifica este estilo, el usuario debe mantener presionada la tecla MAYÚS mientras arrastra un botón. Tenga en cuenta que se debe especificar el estilo CCS_ADJUSTABLE para permitir que se arrastren los botones de la barra de herramientas.
TBSTYLE_CUSTOMERASE	Versión 4.70. Genera NM_CUSTOMDRAW códigos de notificación cuando la barra de herramientas procesa WM_ERASEBKGND mensajes.
TBSTYLE_FLAT	Versión 4.70. Crea una barra de herramientas plana. En una barra de herramientas plana, tanto la barra de herramientas como los botones son transparentes y el seguimiento activo está habilitado. El texto del botón aparece debajo de los mapas de bits del botón. Para evitar problemas de reintentos, este estilo debe establecerse antes de que el control de la barra de herramientas sea visible.
TBSTYLE_LIST	Versión 4.70. Crea una barra de herramientas plana con texto de botón a la derecha del mapa de bits. De lo contrario, este estilo es idéntico a TBSTYLE_FLAT. Para evitar problemas de reintentos, este estilo debe establecerse antes de que el control de la barra de herramientas sea visible.
TBSTYLE_REGISTERDROP	Versión 4.71. Genera TBN_GETOBJECT códigos de notificación para solicitar la eliminación de objetos de destino cuando el cursor pasa sobre los botones de la barra de herramientas.
TBSTYLE_TOOLTIPS	Crea un control de información sobre herramientas que una aplicación puede usar para mostrar texto descriptivo para los botones de la barra de herramientas.
TBSTYLE_TRANSPARENT	Versión 4.71. Crea una barra de herramientas transparente. En una barra de herramientas transparente, esta es transparente, pero los botones no. El texto del botón aparece debajo de los mapas de bits del botón. Para evitar problemas de reintentos, este estilo debe establecerse antes de que el control de la barra de herramientas sea visible.
TBSTYLE_WRAPABLE	Crea una barra de herramientas que puede tener varias líneas de botones. Los botones de la barra de herramientas pueden "ajustarse" a la línea siguiente cuando la barra de herramientas se vuelve demasiado reducida para incluir todos los botones en la misma línea. Cuando se ajusta la barra de herramientas, la interrupción se producirá en el separador más a la derecha o en el botón situado más a la derecha si no hay separadores en la barra. Este estilo debe establecerse para mostrar un control de barra de herramientas vertical cuando la barra de herramientas forma parte de un control de barra de rebar vertical. Este estilo no se puede combinar con CCS_VERT.

Nota: Un botón de barra de herramientas puede tener una combinación de los estilos siguientes. Para especificar un estilo de botón, establezca las marcas adecuadas en el miembro fsStyle de la estructura TBBUTTON del botón. No todos los estilos se pueden combinar.

Para shell versión 4.72 y anteriores, las marcas de estilo de ventana y botón tenían el formulario TBSTYLE_XXX. Si va a compilar una aplicación con la versión 4.72 o anterior de Commctrl.h, debe usar las marcas de estilo de botón de TBSTYLE_XXX. Para la versión 5.80 y posteriores, todos los estilos de botón tienen el formulario BTNS_XXX. Todos los valores de TBSTYLE_XXX tienen valores equivalentes BTNS_XXX, con el mismo significado y valor numérico. Para mayor comodidad, ambos formularios se proporcionan en la tabla siguiente.

Constante	Descripción
BTNS_AUTOSIZE	Versión 5.80. Especifica que el control de la barra de herramientas no debe asignar el ancho estándar al botón. En su lugar, el ancho del botón se calculará en función del ancho del texto más la imagen del botón. Use la marca de estilo equivalente, TBSTYLE_AUTOSIZE, para la versión 4.72 y versiones anteriores.
BTNS_BUTTON	Versión 5.80. Crea un botón estándar. Use la marca de estilo equivalente, TBSTYLE_BUTTON, para la versión 4.72 y versiones anteriores. Esta marca se define como 0 y se debe usar para indicar que no se establecen otras marcas.
BTNS_CHECK	Versión 5.80. Crea un botón de inserción de doble estado que alterna entre los estados presionados y no presionados cada vez que el usuario hace clic en él. El botón tiene un color de fondo diferente cuando está en estado presionado. Use la marca de estilo equivalente, TBSTYLE_CHECK, para la versión 4.72 y versiones anteriores.
BTNS_CHECKGROUP	Versión 5.80. Crea un botón que permanece presionado hasta que se presiona otro botón del grupo, similar a los botones de opción (también conocidos como botones de radio). Equivale a combinar BTNS_CHECK y BTNS_GROUP. Use la marca de estilo equivalente, TBSTYLE_CHECKGROUP, para la versión 4.72 y versiones anteriores.
BTNS_DROPDOWN	Versión 5.80. Crea un botón de estilo desplegable que puede mostrar una lista cuando se hace clic en el botón. En lugar del mensaje de WM_COMMAND usado para los botones normales, los botones desplegables envían un código de notificación de TBN_DROPDOWN . Después, una aplicación puede hacer que el controlador de notificaciones muestre una lista de opciones. Use la marca de estilo equivalente, TBSTYLE_DROPDOWN, para la versión 4.72 y versiones anteriores. Si la barra de herramientas tiene el estilo extendido TBSTYLE_EX_DRAWDDARROWS , los botones desplegables tendrán una flecha desplegable que se muestra en una sección independiente a su derecha. Si se hace clic en la flecha, se enviará un código de notificación TBN_DROPDOWN. Si se hace clic en el botón asociado, se enviará un mensaje de WM_COMMAND.
BTNS_GROUP	Versión 5.80. Cuando se combina con BTNS_CHECK, crea un botón que permanece presionado hasta que se presiona otro botón del grupo. Use la marca de estilo equivalente, TBSTYLE_GROUP, para la versión 4.72 y versiones anteriores.
BTNS_NOPREFIX	Versión 5.80. Especifica que el texto del botón no tendrá asociado un prefijo de acelerador. Use la marca de estilo equivalente, TBSTYLE_NOPREFIX, para la versión 4.72 y versiones anteriores.
BTNS_SEP	Versión 5.80. Crea un separador, creando un pequeño espacio entre los grupos de botones. Un botón que tiene este estilo no recibe la entrada del usuario. Use la marca de estilo equivalente, TBSTYLE_SEP, para la versión 4.72 y versiones anteriores.
BTNS_SHOWTEXT	Versión 5.81. Especifica que se debe mostrar el texto del botón. Todos los botones pueden tener texto, pero solo los botones con el estilo de botón BTNS_SHOWTEXT lo mostrarán. Este estilo de botón debe usarse con el estilo TBSTYLE_LIST y el estilo extendido TBSTYLE_EX_MIXEDBUTTONS . Si establece texto para botones que no tienen el estilo BTNS_SHOWTEXT, el control de barra de herramientas lo mostrará automáticamente como información sobre herramientas cuando el cursor mantenga el puntero sobre el botón. Esta característica permite que la aplicación evite controlar el código de notificación de TBN_GETINFOTIP o TTN_GETDISPINFO de la barra de herramientas.
BTNS_WHOLEDROPDOWN	Versión 5.80. Especifica que el botón tendrá una flecha desplegable, pero no como una sección independiente. Los botones con este estilo se comportan igual, independientemente de si se establece el estilo extendido TBSTYLE_EX_DRAWDDARROWS .
TBSTYLE_AUTOSIZE	Equivalente a BTNS_AUTOSIZE. Use TBSTYLE_AUTOSIZE para la versión 4.72 y anteriores.
TBSTYLE_BUTTON	Equivalente a BTNS_BUTTON. Use TBSTYLE_BUTTON para la versión 4.72 y anteriores.
TBSTYLE_CHECK	Equivalente a BTNS_CHECK. Use TBSTYLE_CHECK para la versión 4.72 y anteriores.
TBSTYLE_CHECKGROUP	Equivalente a BTNS_CHECKGROUP. Use TBSTYLE_CHECKGROUP para la versión 4.72 y anteriores.
TBSTYLE_DROPDOWN	Equivalente a BTNS_DROPDOWN. Use TBSTYLE_DROPDOWN para la versión 4.72 y anteriores.
TBSTYLE_GROUP	Equivalente a BTNS_GROUP. Use TBSTYLE_GROUP para la versión 4.72 y anteriores.
TBSTYLE_NOPREFIX	Equivalente a BTNS_NOPREFIX. Use TBSTYLE_NOPREFIX para la versión 4.72 y anteriores.
TBSTYLE_SEP	Equivalente a BTNS_SEP. Use TBSTYLE_SEP para la versión 4.72 y anteriores.

Requisitos

Requisito	Value
Encabezado	CommCtrl.h