Compartir vía


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.