CToolBarCtrl

CToolBarCtrl (clase) proporciona la funcionalidad de control común de barra de herramientas de Windows. Este control (y por lo tanto, la clase de CToolBarCtrl ) está disponible sólo para los programas que se ejecutan bajo Windows 95 y Windows NT versión 3.51 y posteriores.

Un control común de barra de herramientas de Windows es una ventana secundaria rectangular que contiene uno o más botones. Estos botones pueden mostrar una imagen de mapa de bits, una cadena o ambos. Cuando el usuario elige un botón, envía un mensaje de comando a ventana propietaria de la barra de herramientas. Normalmente, los botones en una barra de herramientas corresponden a elementos de menú de la aplicación; proporcionan una forma más directa para el usuario para acceder a los comandos de una aplicación.

CToolBarCtrl objetos contienen varias estructuras de datos internas importantes: una lista de mapas de bits de imagen de botón o una lista de imágenes, una lista de picaduras de etiqueta del botón y una lista de estructuras TBBUTTON que asociar una imagen o cadena con la posición, estilo, Estado y ID del botón de comando. Cada uno de los elementos de estas estructuras de datos es referido por un índice de base cero. Antes de utilizar un objeto CToolBarCtrl , debe configurar estas estructuras de datos. Sólo se puede utilizar la lista de cadenas para etiquetas de botones; no se puede recuperar cadenas desde la barra de herramientas.

Para utilizar un objeto CToolBarCtrl , normalmente se siga estos pasos:

1. Construir el objeto CToolBarCtrl.
   
   
2. Llame a crear para crear el control común de barra de herramientas de Windows y asociarlo al objeto CToolBarCtrl . Indicar el estilo de la barra de herramientas utilizando estilos, tales como TBSTYLE_TRANSPARENT para una barra de herramientas transparente o TBSTYLE_DROPDOWN para una barra de herramientas que soporta botones de estilo de lista desplegable.
   
   
3. Identificar cómo desea que los botones de la barra de herramientas muestra:
   • Para utilizar imágenes de mapa de bits para botones, añadir los mapas de bits de botón a la barra de herramientas llamando AddBitmap.
     
     
   • Para utilizar imágenes que se muestran en una lista de imágenes para los botones, especifique la lista de imágenes llamando al SetImageList, SetHotImageListo SetDisabledImageList.
     
     
   • Para utilizar etiquetas de cadena para botones, añadir las cadenas a la barra de herramientas llamando a AddString o AddStrings.
4. Agregar estructuras de botón a la barra de herramientas llamando AddButtons.
   
   
5. Si desea información sobre herramientas para un botón de barra de herramientas en una ventana de propietario que no es un CFrameWnd, que necesita para administrar los mensajes TTN_NEEDTEXT en la ventana propietaria de la barra de herramientas, como se describe en CToolBarCtrl: manejo de notificaciones de la punta de herramienta. Si la ventana principal de la barra de herramientas se deriva de CFrameWnd, información sobre herramientas se muestra sin ningún esfuerzo adicional de usted porque CFrameWnd proporciona un controlador predeterminado.
   
   
6. Si desea que el usuario pueda personalizar la barra de herramientas, controlar mensajes de notificación de personalización de la ventana propietaria como se describe en CToolBarCtrl: manejo de notificaciones de personalización.

Puede utilizar SaveState para guardar el estado actual de un control de barra de herramientas en el registro y RestoreState para restaurar el Estado basado en la información previamente almacenada en el registro. Además de guardar el estado de la barra de herramientas entre los usos de la aplicación, las aplicaciones suelen almacenan el estado antes de que el usuario comienza a personalizar la barra de herramientas en caso de que el usuario desea posteriormente restaurar la barra de herramientas a su estado original.

Soporte para Internet Explorer versión 4.0 o posterior

Para admitir la funcionalidad introducida en Internet Explorer, versión 4.0 o posterior, MFC proporciona compatibilidad con listas de imágenes y estilos transparentes y planos para controles de barra de herramientas.

Una barra de herramientas transparente permite al cliente bajo la barra de herramientas mostrar a través de. Para crear una barra de herramientas transparente, utilice estilos de TBSTYLE_FLAT y TBSTYLE_TRANSPARENT . Barras de herramientas transparentes característica caliente de seguimiento; es decir, cuando el puntero del ratón sobre un botón caliente en la barra de herramientas, cambia la apariencia del botón. Creado con sólo el estilo TBSTYLE_FLAT de barras de herramientas contiene botones que no son transparentes.

Compatibilidad con listas de imagen permite una mayor flexibilidad de control de comportamiento predeterminado, imágenes calientes y discapacitados. Utilizar GetImageList, GetHotImageListy GetDisabledImageList con la barra de herramientas transparente para manipular la imagen según su estado:

Para obtener más información sobre el uso de CToolBarCtrl, consulte Temas de Control y CToolBarCtrl usando en la Guía del programador de Visual C++.

# include lt;afxcmn.h>

Miembros de la clase |  Clase base | Diagrama de jerarquía

Muestrasnbsp; MFC muestra CMNCTRL1 | Ejemplo de MFC MFCIE

Vea tambié&nnbsp;CToolBar