Los objetos de la clase CToolBar son barras de control que tienen una fila de botones de mapa de bits y separadores opcionales. Los botones pueden actuar como pulsadores, botones de casilla de verificación o botones de opción. CToolBar objetos son miembros normalmente incrustados de los objetos de ventana de marco derivados de la clase CFrameWnd o CMDIFrameWnd.
CToolBar::GetToolBarCtrl, una función miembro nueva a MFC 4.0, le permite aprovechar compatibilidad del control común de Windows para la personalización de la barra de herramientas y funcionalidad adicional. Las funciones miembro CToolBar dan la mayor parte de la funcionalidad de los controles comunes de Windows; Sin embargo, al llamar a GetToolBarCtrl, puede dar las barras de herramientas aún más de las características de las barras de herramientas de Windows 95. Cuando se llama GetToolBarCtrl, se le devolverá una referencia a un objeto CToolBarCtrl . Consulte CToolBarCtrl para obtener más información acerca de cómo diseñar barras de herramientas mediante controles comunes de Windows. Para obtener más información general acerca de los controles comunes, consulte Controles comunes en la referencia del programador del SDK de Windows 95.
Visual C++ proporciona dos métodos para crear una barra de herramientas. Para crear un recurso de barra de herramientas utilizando el Editor de recursos, siga estos pasos:
De lo contrario, siga estos pasos:
Todas las imágenes de botón en la barra de herramientas son tomadas de un mapa de bits, que debe contener una imagen para cada botón. Todas las imágenes deben ser del mismo tamaño; el valor predeterminado es 16 píxeles de ancho y 15 píxeles de alto. Las imágenes deben tener al lado en el mapa de bits.
La función SetButtons toma un puntero a una matriz de control IDs y un entero que especifica el número de elementos de la matriz. La función de ID cada botón establece en el valor del elemento correspondiente de la matriz y asigna a cada botón de un índice de imágenes, que especifica la posición de la imagen del botón en el mapa de bits. Si un elemento de la matriz tiene el valor ID_SEPARATOR, no se le asigna ningún índice de imagen.
El orden de las imágenes de mapa de bits es normalmente el orden en que se dibujan en la pantalla, pero puede utilizar la función SetButtonInfo para cambiar la relación entre la imagen y pedido de dibujo.
Todos los botones en una barra de herramientas son del mismo tamaño. El valor predeterminado es 24 x 22 píxeles, de conformidad con las Directrices de la interfaz de Windows para el diseño de Software. Ningún espacio adicional entre las dimensiones de la imagen y el botón se utiliza para formar un borde alrededor de la imagen.
Cada botón tiene una imagen. Los distintos botón Estados y estilos (presionado, arriba, abajo, discapacitado, discapacitado abajo e indeterminado) se generan desde una imagen. Aunque los mapas de bits pueden ser de cualquier color, puede conseguir los mejores resultados con imágenes en blanco y tonos de gris.
Botones de la barra de herramientas de imitan pulsadores de forma predeterminada. Sin embargo, los botones de barra de herramientas también pueden imitar botones de casilla de verificación o botones de opción. Botones de casilla de verificación tienen tres Estados: activada, desactivada e indeterminado. Botones de radio tienen sólo dos Estados: activada y desactivada.
Para definir un botón individual o separador estilo sin apuntando a una matriz, llame a GetButtonStyle para recuperar el estilo y, a continuación, llame a SetButtonStyle en lugar de SetButtons. SetButtonStyle es más útil cuando desea cambiar el estilo de un botón en tiempo de ejecución.
Para asignar texto que aparezca en un botón, llame a GetButtonText para recuperar el texto que aparecerá en el botón y, a continuación, llame a SetButtonText para establecer el texto.
Para crear un botón de la casilla de verificación, se asigna el estilo TBBS_CHECKBOX o utilizar la función de miembro de un objeto CCmdUI SetCheck en un controlador ON_UPDATE_COMMAND_UI . Llamar a SetCheck , un pulsador convierte en un botón de la casilla de verificación. Pasar un argumento de 0 a SetCheck para 1 está desactivado, activado, o 2 para indeterminado.
Para crear un botón de radio, llamada función de miembro de un objeto CCmdUI SetRadio desde un controlador de ON_UPDATE_COMMAND_UI . Pasar SetRadio un argumento de 0 para distinto de cero para activada o desactivada. A fin de proporcionar un comportamiento mutuamente excluyentes de un grupo de radio, debe tener ON_UPDATE_COMMAND_UI controladores para todos los botones del grupo.
Para obtener más información sobre el uso de CToolBar, consulte el artículo las barras de herramientas en la Guía del programador de Visual C++ y técnica Nota 31, barras de Control.
# include lt;afxext.h>
Miembros de la clase | Clase base | Diagrama de jerarquía
Muestras Ejemplo de MFC CTRLBARS | MFC ejemplo DLGCBR32 | Ejemplo MFC DOCKTOOL
Vea tambié&nnbsp;CToolBarCtrl, CControlBar, CToolBar::Create, CToolBar::LoadBitmap, CToolBar::SetButtons, CCmdUI::SetCheck, CCmdUI::SetRadio