Compartir a través de


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.