CToolBar Class

Artículo
06/10/2015

Barras de controles que tienen un rango de botones de mapas de bits y separadores opcionales.

class CToolBar : public CControlBar

Miembros

Constructores públicos

Name	Descripción
CToolBar::CToolBar	Crea un objeto CToolBar.

Métodos públicos

Name	Descripción
CToolBar::CommandToIndex	Devuelve el índice de un botón con la identificación especificada de comando
CToolBar::Create	Crea la barra de herramientas de Windows y la agrega al objeto de CToolBar .
CToolBar::CreateEx	Crea un objeto de CToolBar con estilos adicionales para el objeto incrustado de CToolBarCtrl .
CToolBar::GetButtonInfo	recupera el identificador, el estilo, y el número de la imagen de un botón.
CToolBar::GetButtonStyle	recupera el estilo para un botón.
CToolBar::GetButtonText	recupera el texto que aparecerá en un botón.
CToolBar::GetItemID	Devuelve el identificador de comando de un botón o un separador en el índice especificado.
CToolBar::GetItemRect	Recupera el rectángulo de presentación para el elemento en el índice especificado.
CToolBar::GetToolBarCtrl	Permite el acceso directo al control común subyacente.
CToolBar::LoadBitmap	Carga el mapa de bits que contiene imágenes de mapa de bits-botón.
CToolBar::LoadToolBar	Carga un recurso de la barra de herramientas creado con el editor de recursos.
CToolBar::SetBitmap	Establece una imagen de mapa de bits.
CToolBar::SetButtonInfo	establece el identificador, el estilo, y el número de la imagen de un botón.
CToolBar::SetButtons	Establece estilos button y un índice de imágenes de botón dentro del mapa de bits.
CToolBar::SetButtonStyle	Establece el estilo de un botón.
CToolBar::SetButtonText	establece el texto que aparecerá en un botón.
CToolBar::SetHeight	establece el alto de la barra de herramientas.
CToolBar::SetSizes	Establece los tamaños de botones y de los mapas de bits.

Comentarios

Los botones pueden actuar como los pulsadores, botones de casilla, o los botones de radio. los objetos deCToolBar suelen ser miembros insertados de los objetos de la ventana de marco derivados de la clase CFrameWnd o CMDIFrameWnd.

CToolBar:: GetToolBarCtrl, una función miembro nueva a MFC 4,0, permite aprovechar las ventajas de la compatibilidad de controles comunes de Windows para la personalización y la funcionalidad adicional de la barra de herramientas. las funciones miembro deCToolBar ofrecen la mayor parte de la funcionalidad de los controles comunes de Windows; sin embargo, cuando se llama a GetToolBarCtrl, puede proporcionar a barras de herramientas aún más de las características de Windows 95 /98 barra de herramientas. Cuando se llama a GetToolBarCtrl, devolverá una referencia a un objeto de CToolBarCtrl . Vea CToolBarCtrl para obtener más información sobre el diseño de las barras de herramientas mediante controles comunes de Windows. Para obtener más información general sobre los controles comunes, vea Controles comunes en Windows SDK.

Visual C++ proporciona dos métodos para crear una barra de herramientas. Para crear un recurso de la barra de herramientas mediante el editor de recursos, siga estos pasos:

Cree un recurso de la barra de herramientas.
Cree el objeto de CToolBar .
Llame a la función de Crear (o CreateEx) para crear la barra de herramientas de Windows y para adjuntarla al objeto de CToolBar .
Llamada LoadToolBar para cargar el recurso de la barra de herramientas.

De lo contrario, siga estos pasos:

Cree el objeto de CToolBar .
Llame a la función de Crear (o CreateEx) para crear la barra de herramientas de Windows y para adjuntarla al objeto de CToolBar .
Llame a LoadBitmap para cargar el mapa de bits que contiene imágenes de botón de la barra de herramientas.
Llame a SetButtons para establecer el estilo de botón y asociar cada botón con una imagen en el mapa de bits.

Todas las imágenes de botón en la barra de herramientas se toman en un mapa de bits, que debe contener una imagen de cada botón. Todas las imágenes deben tener el mismo tamaño; el valor predeterminado es 16 píxeles de ancho y 15 píxeles de alto. Las imágenes deben estar en paralelo en el mapa de bits.

La función de SetButtons contiene un puntero a una matriz de id. del control y un entero que especifica el número de elementos de la matriz. La función asigna el identificador de cada botón al valor del elemento correspondiente de la matriz y asigna a cada botón un índice de la imagen, que especifica la posición de la imagen del botón en el mapa de bits. si un elemento de matriz tiene el valor ID_SEPARATOR, no se asigna ningún índice de la imagen.

El orden de las imágenes en el mapa de bits es normalmente el orden en el que se dibujan en la pantalla, pero puede utilizar la función de SetButtonInfo para cambiar la relación entre el orden de la imagen y el orden de dibujo.

Todos los botones de una barra de herramientas son el mismo tamaño. El valor predeterminado es de 24 x 22 píxeles, de acuerdo con las instrucciones de la interfaz de Windows para el diseño de software. Cualquier espacio adicional entre la imagen y las dimensiones del botón se utiliza para formar un borde alrededor de la imagen.

Cada botón con una imagen. Se representan las diferentes estados y estilos de botón (normal, arriba, siguiente, de deshabilitado, deshabilitado siguiente, e indeterminado) de ese una imagen. Aunque los mapas de bits pueden ser cualquier color, puede lograr los mejores resultados con imágenes negro y tonos de gris.

Precaución
CToolBar admite mapas de bits con un máximo de 16 colores.Cuando se carga una imagen en un editor de barras de herramientas, Visual Studio convierte automáticamente la imagen a 16 colores bitmap en caso necesario, y muestra un mensaje de advertencia si la imagen se ha convertido.Si utiliza una imagen con más de 16 colores (mediante un editor externo para editar la imagen), la aplicación podría comportarse inesperado.

CToolBar admite mapas de bits con un máximo de 16 colores.Cuando se carga una imagen en un editor de barras de herramientas, Visual Studio convierte automáticamente la imagen a 16 colores bitmap en caso necesario, y muestra un mensaje de advertencia si la imagen se ha convertido.Si utiliza una imagen con más de 16 colores (mediante un editor externo para editar la imagen), la aplicación podría comportarse inesperado.

los botones de la barra de herramientas imitan los pulsadores de forma predeterminada. Sin embargo, los botones de la barra de herramientas también pueden imitar botones o los botones de radio de la casilla. Botones de casilla tienen tres estados: activada, desactivada, e indeterminado. Los botones de radio sólo tienen dos estados: comprobado y borrado.

Para establecer un estilo de botón individual o de separador sin que señale a una matriz, llame a GetButtonStyle para recuperar el estilo, y llame a SetButtonStyle en lugar de SetButtons. SetButtonStyle es muy útil cuando se desea cambiar el estilo de un botón en tiempo de ejecución.

Para asignar texto aparezca en un botón, llame a GetButtonText para recuperar el texto que aparezca en el botón, y llame a SetButtonText para establecer el texto.

Para crear un botón, una asignación de casilla el estilo TBBS_CHECKBOX o utilizar la función miembro de SetCheck de un objeto de CCmdUI en un controlador de ON_UPDATE_COMMAND_UI . La llamada SetCheck gira un mismo botón en un botón de la casilla. Pase SetCheck un argumento de 0 para desactivado, 1 para activa, o 2 para indeterminado.

Para crear un botón de radio, llame a la función miembro de SetRadio de un objeto de CCmdUI de un controlador de ON_UPDATE_COMMAND_UI . Pase SetRadio un argumento de 0 para desactivado o cero para activarla. Para proporcionar un grupo de radio mutuamente comportamiento exclusivo, debe tener los controladores de ON_UPDATE_COMMAND_UI para todos los botones en el grupo.

Para obtener más información sobre cómo utilizar CToolBar, vea el artículo implementación de la barra de herramientas de MFC y nota técnica 31: Barras de controles.