Barra de herramientas

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

Temas de introducción

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 los elementos del menú de la aplicación, lo que proporciona una manera adicional y más directa de 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.

Functions

Tema	Contenido
CreateMappedBitmap	Crea un mapa de bits para su uso 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, use CreateWindowEx . Para obtener ejemplos, vea Uso de controles de barra de herramientas.

error de Hadoop

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 actualmente en la barra de herramientas.
TB_BUTTONSTRUCTSIZE	Especifica el tamaño de la estructura TBBUTTON .
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 para el 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 del delimitador de 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 para un botón de una barra de herramientas.
TB_GETBUTTONSIZE	Recupera el ancho y alto actuales 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 la combinación de colores del control de 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 rápido 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 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 de delimitación para 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 la 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 la barra de herramientas.
TB_ISBUTTONINDETERMINATE	Determina si el botón especificado de una barra de herramientas es 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 la barra de herramientas.
TB_SETANCHORHIGHLIGHT	Establece la configuración de resaltado del delimitador de 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 para 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 el ancho mínimo y máximo del botón en el control de 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 combinación de colores para el control de la 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 de la barra de herramientas.
TB_SETEXTENDEDSTYLE	Establece los estilos extendidos de un control de barra de herramientas.
TB_SETHOTIMAGELIST	Establece la lista de imágenes que usará el control de barra de herramientas para mostrar los botones de acceso rápido.
TB_SETHOTITEM	Establece el elemento rápido en una barra de herramientas.
TB_SETHOTITEM2	Establece el elemento rápido en una barra de herramientas.
TB_SETIMAGELIST	Establece la lista de imágenes que la barra de herramientas usa 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	Recupera las métricas de un control de barra de herramientas.
TB_SETPADDING	Establece el relleno de un control de barra de herramientas.
TB_SETPARENT	Establece la ventana a 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 de 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 de WM_NOTIFY .
NM_CUSTOMDRAW (barra de herramientas)	Enviado por la barra de herramientas para notificar a su ventana primaria las operaciones de dibujo. Este código de notificación se envía en forma de mensaje de WM_NOTIFY .
NM_DBLCLK (barra de herramientas)	Notifica a la ventana primaria de un control de barra de herramientas que el usuario ha hecho 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 de 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 de 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 de 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 de WM_NOTIFY .
NM_RDBLCLK (barra de herramientas)	Notifica a la ventana primaria de un control que el usuario ha hecho 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 de 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 de 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 de 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 de 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 de 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, a continuación, mueve el cursor fuera del botón. Este código de notificación se envía en forma de mensaje de 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 de 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 de 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 de 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 de 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 de 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 de 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 sobre un elemento de barra de herramientas. Este código de notificación se envía en forma de mensaje de 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 de 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 de 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 de 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 está personalizando 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 está personalizando 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 utilizada por 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 sobre información de un elemento de barra de herramientas. Esta estructura se usa con el código de notificación de TBN_GETINFOTIP .
NMTBHOTITEM	Contiene información utilizada con el código de notificación de TBN_HOTITEMCHANGE .
NMTBRESTORE	Permite a las aplicaciones extraer la información que se colocó 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 de 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 utilizada para procesar los códigos de notificación de la barra de herramientas. Esta estructura sustituye a la estructura TBNOTIFY .
TBADDBITMAP	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 de una barra de herramientas.
TBINSERTMARK	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 la barra de herramientas por otro.
TBSAVEPARAMS	Especifica la ubicación del registro donde almacena el mensaje TB_SAVERESTORE y recupera información sobre el estado de una barra de herramientas.

Constantes

Tema	Contenido
Estados 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.
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 o versiones posteriores. 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.
Estilos extendidos de la barra de herramientas	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 los valores de índice de las imágenes dentro de los mapas de bits estándar.