Barra de herramientas

Esta sección contiene información sobre los elementos de programación usados con controles de barra de herramientas.

Descripciones

Tema	Contenido
Acerca de los controles de barra de herramientas	Una barra de herramientas es un control que contiene uno o varios botones. Cada botón, cuando un usuario hace clic en ellos, envía un mensaje de comando a la ventana primaria. Normalmente, los botones de una barra de herramientas corresponden a elementos del menú de la aplicación, lo que proporciona una forma adicional y más directa para que el usuario acceda a los comandos de una aplicación.
usar controles de barra de herramientas	Este tema contiene detalles de implementación y código de ejemplo para usar controles de barra de herramientas en las aplicaciones.

Funciones

Tema	Contenido
CreateMappedBitmap	Crea un mapa de bits para usarlo en una barra de herramientas.
CreateToolbarEx	Crea una ventana de barra de herramientas y agrega los botones especificados a la barra de herramientas. Nota: Esta función está en desuso, ya que no admite todas las características de las barras de herramientas. En su lugar, useCreateWindowEx. Para obtener ejemplos, consulte Using Toolbar Controls.

Mensajes

Tema	Contenido
TB_ADDBITMAP	Agrega una o varias imágenes a la lista de imágenes de botón disponibles para una barra de herramientas.
TB_ADDBUTTONS	Agrega uno o varios botones a una barra de herramientas.
TB_ADDSTRING	Agrega una nueva cadena al grupo de cadenas de la barra de herramientas.
TB_AUTOSIZE	Hace que se cambie el tamaño de una barra de herramientas.
TB_BUTTONCOUNT	Recupera un recuento de los botones que se encuentran actualmente en la barra de herramientas.
TB_BUTTONSTRUCTSIZE	Especifica el tamaño de la estructuraTBBUTTON.
TB_CHANGEBITMAP	Cambia el mapa de bits de un botón de una barra de herramientas.
TB_CHECKBUTTON	Comprueba o desactiva un botón determinado en una barra de herramientas.
TB_COMMANDTOINDEX	Recupera el índice de base cero del botón asociado al identificador de comando especificado.
TB_CUSTOMIZE	Muestra el cuadro de diálogo Personalizar barra de herramientas.
TB_DELETEBUTTON	Elimina un botón de la barra de herramientas.
TB_ENABLEBUTTON	Habilita o deshabilita el botón especificado en una barra de herramientas.
TB_GETANCHORHIGHLIGHT	Recupera la configuración de resaltado de anclaje para una barra de herramientas.
TB_GETBITMAP	Recupera el índice del mapa de bits asociado a un botón de una barra de herramientas.
TB_GETBITMAPFLAGS	Recupera las marcas que describen el tipo de mapa de bits que se va a usar.
TB_GETBUTTON	Recupera información sobre el botón especificado en una barra de herramientas.
TB_GETBUTTONINFO	Recupera información extendida de un botón en una barra de herramientas.
TB_GETBUTTONSIZE	Recupera el ancho actual y el alto de los botones de la barra de herramientas, en píxeles.
TB_GETBUTTONTEXT	Recupera el texto para mostrar de un botón en una barra de herramientas.
TB_GETCOLORSCHEME	Recupera la información de combinación de colores del control de la barra de herramientas.
TB_GETDISABLEDIMAGELIST	Recupera la lista de imágenes que usa un control de barra de herramientas para mostrar botones inactivos.
TB_GETEXTENDEDSTYLE	Recupera los estilos extendidos de un control de barra de herramientas.
TB_GETHOTIMAGELIST	Recupera la lista de imágenes que usa un control de barra de herramientas para mostrar botones activos.
TB_GETHOTITEM	Recupera el índice del elemento activo en una barra de herramientas.
TB_GETIDEALSIZE	Obtiene el tamaño ideal de la barra de herramientas.
TB_GETIMAGELIST	Recupera la lista de imágenes que usa un control de barra de herramientas para mostrar botones en su estado predeterminado. Un control de barra de herramientas usa esta lista de imágenes para mostrar botones cuando no están activos o deshabilitados.
TB_GETIMAGELISTCOUNT	Obtiene el número de listas de imágenes asociadas a la barra de herramientas.
TB_GETINSERTMARK	Recupera la marca de inserción actual de la barra de herramientas.
TB_GETINSERTMARKCOLOR	Recupera el color usado para dibujar la marca de inserción de la barra de herramientas.
TB_GETITEMDROPDOWNRECT	Obtiene el rectángulo delimitador de la ventana desplegable de un elemento de barra de herramientas con estilo BTNS_DROPDOWN.
TB_GETITEMRECT	Recupera el rectángulo delimitador de un botón de una barra de herramientas.
TB_GETMAXSIZE	Recupera el tamaño total de todos los botones y separadores visibles de la barra de herramientas.
TB_GETMETRICS	Recupera las métricas de un control de barra de herramientas.
TB_GETOBJECT	Recupera el IDropTarget para un control de barra de herramientas.
TB_GETPADDING	Recupera el relleno de un control de barra de herramientas.
TB_GETPRESSEDIMAGELIST	Obtiene la lista de imágenes que usa un control de barra de herramientas para mostrar botones en un estado presionado.
TB_GETRECT	Recupera el rectángulo delimitador de un botón de barra de herramientas especificado.
TB_GETROWS	Recupera el número de filas de botones de una barra de herramientas con el estilo TBSTYLE_WRAPABLE.
TB_GETSTATE	Recupera información sobre el estado del botón especificado en una barra de herramientas, como si está habilitado, presionado o activado.
TB_GETSTRING	Recupera una cadena del grupo de cadenas de una barra de herramientas.
TB_GETSTYLE	Recupera los estilos actualmente en uso para un control de barra de herramientas.
TB_GETTEXTROWS	Recupera el número máximo de filas de texto que se pueden mostrar en un botón de barra de herramientas.
TB_GETTOOLTIPS	Recupera el identificador del control de información sobre herramientas, si existe, asociado a la barra de herramientas.
TB_GETUNICODEFORMAT	Recupera la marca de formato de caracteres Unicode para el control .
TB_HASACCELERATOR	Diseñado para uso interno; no se recomienda para su uso en aplicaciones. Recupera un recuento de botones de barra de herramientas que tienen el carácter de acelerador especificado.
TB_HIDEBUTTON	Oculta o muestra el botón especificado en una barra de herramientas.
TB_HITTEST	Determina dónde se encuentra un punto en un control de barra de herramientas.
TB_INDETERMINATE	Establece o borra el estado indeterminado del botón especificado en una barra de herramientas.
TB_INSERTBUTTON	Inserta un botón en una barra de herramientas.
TB_INSERTMARKHITTEST	Recupera la información de la marca de inserción de un punto de una barra de herramientas.
TB_ISBUTTONCHECKED	Determina si el botón especificado de una barra de herramientas está activado.
TB_ISBUTTONENABLED	Determina si el botón especificado de una barra de herramientas está habilitado.
TB_ISBUTTONHIDDEN	Determina si el botón especificado de una barra de herramientas está oculto.
TB_ISBUTTONHIGHLIGHTED	Comprueba el estado de resaltado de un botón de barra de herramientas.
TB_ISBUTTONINDETERMINATE	Determina si el botón especificado de una barra de herramientas está indeterminado.
TB_ISBUTTONPRESSED	Determina si se presiona el botón especificado en una barra de herramientas.
TB_LOADIMAGES	Carga imágenes de botón definidas por el sistema en la lista de imágenes de un control de barra de herramientas.
TB_MAPACCELERATOR	Determina el identificador del botón que corresponde al carácter de acelerador especificado.
TB_MARKBUTTON	Establece el estado de resaltado de un botón determinado en un control de barra de herramientas.
TB_MOVEBUTTON	Mueve un botón de un índice a otro.
TB_PRESSBUTTON	Presiona o suelta el botón especificado en una barra de herramientas.
TB_REPLACEBITMAP	Reemplaza un mapa de bits existente por un nuevo mapa de bits.
TB_SAVERESTORE	Envíe este mensaje para comenzar a guardar o restaurar un estado de barra de herramientas.
TB_SETANCHORHIGHLIGHT	Establece la configuración de resaltado de anclaje para una barra de herramientas.
TB_SETBITMAPSIZE	Establece el tamaño de las imágenes de mapa de bits que se van a agregar a una barra de herramientas.
TB_SETBOUNDINGSIZE	Diseñado para uso interno; no se recomienda para su uso en aplicaciones. Establece el tamaño de límite de un control de barra de herramientas de varias columnas.
TB_SETBUTTONINFO	Establece la información de un botón existente en una barra de herramientas.
TB_SETBUTTONSIZE	Establece el tamaño de los botones de una barra de herramientas.
TB_SETBUTTONWIDTH	Establece los anchos de botón mínimo y máximo en el control de la barra de herramientas.
TB_SETCMDID	Establece el identificador de comando de un botón de barra de herramientas.
TB_SETCOLORSCHEME	Establece la información de la combinación de colores para el control de barra de herramientas.
TB_SETDISABLEDIMAGELIST	Establece la lista de imágenes que usará el control de barra de herramientas para mostrar botones deshabilitados.
TB_SETDRAWTEXTFLAGS	Establece las marcas de dibujo de texto para la barra de herramientas.
TB_SETEXTENDEDSTYLE	Establece los estilos extendidos para un control de barra de herramientas.
TB_SETHOTIMAGELIST	Establece la lista de imágenes que usará el control de barra de herramientas para mostrar botones activos.
TB_SETHOTITEM	Establece el elemento activo en una barra de herramientas.
TB_SETHOTITEM2	Establece el elemento activo en una barra de herramientas.
TB_SETIMAGELIST	Establece la lista de imágenes que usa la barra de herramientas para mostrar los botones que están en su estado predeterminado.
TB_SETINDENT	Establece la sangría del primer botón de un control de barra de herramientas.
TB_SETINSERTMARK	Establece la marca de inserción actual de la barra de herramientas.
TB_SETINSERTMARKCOLOR	Establece el color usado para dibujar la marca de inserción de la barra de herramientas.
TB_SETLISTGAP	Establece la distancia entre los botones de la barra de herramientas de una barra de herramientas específica.
TB_SETMAXTEXTROWS	Establece el número máximo de filas de texto mostradas en un botón de barra de herramientas.
TB_SETMETRICS	Establece las métricas de un control de barra de herramientas.
TB_SETPADDING	Establece el relleno para un control de barra de herramientas.
TB_SETPARENT	Establece la ventana en la que el control de barra de herramientas envía códigos de notificación.
TB_SETPRESSEDIMAGELIST	Establece la lista de imágenes que usa la barra de herramientas para mostrar botones que están en estado presionado.
TB_SETROWS	Establece el número de filas de botones de una barra de herramientas.
TB_SETSTATE	Establece el estado del botón especificado en una barra de herramientas.
TB_SETSTYLE	Establece el estilo de un control de barra de herramientas.
TB_SETTOOLTIPS	Asocia un control de información sobre herramientas a una barra de herramientas.
TB_SETUNICODEFORMAT	Establece la marca de formato de caracteres Unicode para el control. Este mensaje permite cambiar el juego de caracteres usado por el control en tiempo de ejecución en lugar de tener que volver a crear el control.
TB_SETWINDOWTHEME	Establece el estilo visual de un control de barra de herramientas.
TB_TRANSLATEACCELERATOR	Pasa un mensaje de teclado a la barra de herramientas.

Notificaciones

Tema	Contenido
NM_CHAR (barra de herramientas)	Enviado por la barra de herramientas cuando recibe un mensaje de WM_CHAR. Este código de notificación se envía en forma de mensaje WM_NOTIFY.
NM_CLICK (barra de herramientas)	Enviado por un control de barra de herramientas cuando el usuario hace clic en un elemento con el botón izquierdo del mouse. Este código de notificación se envía en forma de mensaje WM_NOTIFY.
NM_CUSTOMDRAW (barra de herramientas)	Enviado por la barra de herramientas para notificar a su ventana primaria sobre las operaciones de dibujo. Este código de notificación se envía en forma de mensaje WM_NOTIFY.
NM_DBLCLK (barra de herramientas)	Notifica a la ventana primaria de un control de barra de herramientas que el usuario ha haciendo doble clic en el botón izquierdo del mouse dentro del control. Este código de notificación se envía en forma de mensaje WM_NOTIFY.
NM_KEYDOWN (barra de herramientas)	Enviado por un control cuando el control tiene el foco del teclado y el usuario presiona una tecla. Este código de notificación se envía en forma de mensaje WM_NOTIFY.
NM_LDOWN	Notifica a la ventana primaria de una barra de herramientas que se ha presionado el botón izquierdo del mouse. Este código de notificación se envía en forma de mensaje WM_NOTIFY.
NM_RCLICK (barra de herramientas)	Enviado por un control de barra de herramientas cuando el usuario hace clic en la barra de herramientas con el botón derecho del mouse. Este código de notificación se envía en forma de mensaje WM_NOTIFY.
NM_RDBLCLK (barra de herramientas)	Notifica a la ventana primaria de un control que el usuario ha haciendo doble clic en el botón derecho del mouse dentro del control. Este código de notificación se envía en forma de mensaje WM_NOTIFY.
NM_RELEASEDCAPTURE (barra de herramientas)	Notifica a la ventana primaria de un control de barra de herramientas que el control está liberando la captura del mouse. Este código de notificación se envía en forma de mensaje WM_NOTIFY.
NM_TOOLTIPSCREATED (barra de herramientas)	Notifica a la ventana primaria de una barra de herramientas que la barra de herramientas ha creado un control de información sobre herramientas. Este código de notificación se envía en forma de mensaje WM_NOTIFY.
TBN_BEGINADJUST	Notifica a la ventana primaria de una barra de herramientas que el usuario ha empezado a personalizar una barra de herramientas. Este código de mensaje se envía en forma de mensaje WM_NOTIFY.
TBN_BEGINDRAG	Notifica a la ventana primaria de una barra de herramientas que el usuario ha empezado a arrastrar un botón en una barra de herramientas. Este código de notificación se envía en forma de mensaje WM_NOTIFY.
TBN_CUSTHELP	Notifica a la ventana primaria de una barra de herramientas que el usuario ha elegido el botón Ayuda en el cuadro de diálogo Personalizar barra de herramientas. Este código de notificación se envía en forma de mensaje WM_NOTIFY.
TBN_DELETINGBUTTON	Enviado por un control de barra de herramientas cuando un botón está a punto de eliminarse.
TBN_DRAGOUT	Enviado por un control de barra de herramientas cuando el usuario hace clic en un botón y luego mueve el cursor fuera del botón. Este código de notificación se envía en forma de mensaje WM_NOTIFY.
TBN_DRAGOVER	Determina si se debe enviar un mensaje de TB_MARKBUTTON para un botón que se está arrastrando. Este código de notificación se envía en forma de mensaje WM_NOTIFY.
TBN_DROPDOWN	Enviado por un control de barra de herramientas cuando el usuario hace clic en un botón desplegable. Este código de notificación se envía en forma de mensaje WM_NOTIFY.
TBN_DUPACCELERATOR	Determina si se puede usar una tecla de aceleración en dos o más barras de herramientas activas. Este código de notificación se envía en forma de mensaje WM_NOTIFY.
TBN_ENDADJUST	Notifica a la ventana primaria de una barra de herramientas que el usuario ha dejado de personalizar una barra de herramientas. Este código de notificación se envía en forma de mensaje WM_NOTIFY.
TBN_ENDDRAG	Notifica a la ventana primaria de la barra de herramientas que el usuario ha dejado de arrastrar un botón en una barra de herramientas. Este código de notificación se envía en forma de mensaje WM_NOTIFY.
TBN_GETBUTTONINFO	Recupera la información de personalización de la barra de herramientas y notifica a la ventana primaria de la barra de herramientas los cambios realizados en la barra de herramientas. Este código de notificación se envía en forma de mensaje WM_NOTIFY.
TBN_GETDISPINFO	Recupera información para mostrar de un elemento de barra de herramientas. Esta notificación se envía en forma de mensaje de WM_NOTIFY.
TBN_GETINFOTIP	Recupera información sobre información de un elemento de barra de herramientas. Este código de notificación se envía en forma de mensaje WM_NOTIFY.
TBN_GETOBJECT	Enviado por un control de barra de herramientas que usa el estilo TBSTYLE_REGISTERDROP para solicitar un objeto de destino de colocación cuando el puntero pasa sobre uno de sus botones. Este código de notificación se envía en forma de mensaje WM_NOTIFY.
TBN_HOTITEMCHANGE	Enviado por un control de barra de herramientas cuando cambia el elemento activo (resaltado). Este código de notificación se envía en forma de mensaje WM_NOTIFY.
TBN_INITCUSTOMIZE	Notifica a la ventana primaria de una barra de herramientas que se ha iniciado la personalización. Este código de notificación se envía en forma de mensaje WM_NOTIFY.
TBN_MAPACCELERATOR	Solicita el índice del botón de la barra de herramientas correspondiente al carácter de acelerador especificado. Este código de notificación se envía en forma de mensaje WM_NOTIFY.
TBN_QUERYDELETE	Notifica a la ventana primaria de la barra de herramientas si se puede eliminar un botón de una barra de herramientas mientras el usuario personaliza la barra de herramientas. Este código de notificación se envía en forma de mensaje WM_NOTIFY.
TBN_QUERYINSERT	Notifica a la ventana primaria de la barra de herramientas si se puede insertar un botón a la izquierda del botón especificado mientras el usuario personaliza una barra de herramientas. Este código de notificación se envía en forma de mensaje WM_NOTIFY.
TBN_RESET	Notifica a la ventana primaria de la barra de herramientas que el usuario ha restablecido el contenido del cuadro de diálogo Personalizar barra de herramientas. Este código de notificación se envía en forma de mensaje WM_NOTIFY.
TBN_RESTORE	Notifica a la ventana primaria de una barra de herramientas que una barra de herramientas está en proceso de restauración. Este código de notificación se envía en forma de mensaje WM_NOTIFY.
TBN_SAVE	Notifica a la ventana primaria de una barra de herramientas que una barra de herramientas está en proceso de guardarse. Este código de notificación se envía en forma de mensaje WM_NOTIFY.
TBN_TOOLBARCHANGE	Notifica a la ventana primaria de la barra de herramientas que el usuario ha personalizado una barra de herramientas. Este código de notificación se envía en forma de mensaje WM_NOTIFY.
TBN_WRAPACCELERATOR	Solicita el índice del botón en una o varias barras de herramientas correspondientes al carácter de acelerador especificado. Este código de notificación se envía en forma de mensaje WM_NOTIFY.
TBN_WRAPHOTITEM	Notifica a una aplicación con dos o más barras de herramientas que el elemento activo está a punto de cambiar. Este código de notificación se envía en forma de mensaje WM_NOTIFY.

Estructuras

Tema	Contenido
COLORMAP	Contiene información que usa la función CreateMappedBitmap para asignar los colores del mapa de bits.
NMTBCUSTOMDRAW	Contiene información específica de un código de notificación de NM_CUSTOMDRAW enviado por un control de barra de herramientas.
NMTBDISPINFO	Contiene y recibe información para mostrar de un elemento de barra de herramientas. Esta estructura se usa con el código de notificación de TBN_GETDISPINFO.
NMTBGETINFOTIP	Contiene y recibe información sobre información de un elemento de barra de herramientas. Esta estructura se usa con el código de notificación TBN_GETINFOTIP.
NMTBHOTITEM	Contiene información usada con el código de notificación de TBN_HOTITEMCHANGE.
NMTBRESTORE	Permite a las aplicaciones extraer la información que se ha colocado en nmTBSAVE cuando se guardó el estado de la barra de herramientas. Esta estructura se pasa a las aplicaciones cuando reciben un código de notificación TBN_RESTORE.
NMTBSAVE	Esta estructura se pasa a las aplicaciones cuando reciben un código de notificación de TBN_SAVE. Contiene información sobre el botón que se está guardando actualmente. Las aplicaciones pueden modificar los valores de los miembros para guardar información adicional.
NMTOOLBAR	Contiene información usada para procesar códigos de notificación de la barra de herramientas. Esta estructura reemplaza a la estructura de TBNOTIFY.
TBADDBITMAP de	Agrega un mapa de bits que contiene imágenes de botón a una barra de herramientas.
TBBUTTON	Contiene información sobre un botón de una barra de herramientas.
TBBUTTONINFO	Contiene o recibe información de un botón específico en una barra de herramientas.
TBINSERTMARK de	Contiene información sobre la marca de inserción en un control de barra de herramientas.
TBMETRICS	Define las métricas de una barra de herramientas que se usan para reducir o expandir elementos de la barra de herramientas.
TBREPLACEBITMAP	Se usa con el mensaje TB_REPLACEBITMAP para reemplazar un mapa de bits de barra de herramientas por otro.
TBSAVEPARAMS	Especifica la ubicación del Registro donde el TB_SAVERESTORE mensaje almacena y recupera información sobre el estado de una barra de herramientas.

Constantes

Tema	Contenido
estado del botón de la barra de herramientas	En esta sección se enumeran los estados que puede tener un botón de barra de herramientas.
control de barra de herramientas y estilos de botón	Los estilos de ventana siguientes son específicos de las barras de herramientas. Se combinan con otros estilos de ventana cuando se crea la barra de herramientas. Nota Para controles comunes 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 o versiones posteriores. Para usar Comctl32.dll versión 6, especifíquelo en un manifiesto. Para obtener más información sobre los manifiestos, vea Habilitación de estilos visuales.
barra de herramientas estilos extendidos	En esta sección se enumeran los estilos extendidos admitidos por los controles de la barra de herramientas.
valores de índice de imagen de botón estándar de la barra de herramientas	En esta sección se especifican valores de índice de imágenes dentro de mapas de bits estándar.