Clase de CMFCToolBar

Artículo
04/10/2013

La clase de CMFCToolBar se parece a Clase CToolBar, pero proporciona compatibilidad adicional para las características de la interfaz de usuario.Se incluyen las barras de herramientas planas, barras de herramientas con imágenes activo, iconos grandes, los botones de buscapersonas, barras de herramientas bloquean, los controles rebar, el texto en imágenes, imágenes de fondo, y las barras de herramientas con fichas.La clase de CMFCToolBar también contiene compatibilidad integrada para la personalización de usuario de barras de herramientas y menús, arrastrar y colocar entre las barras de herramientas y menús, botones del cuadro combinado, los botones del cuadro de edición, los selectores de colores, y los botones de consolidación.

class CMFCToolBar : public CMFCBaseToolBar

Members

Constructores públicos

Name	Descripción
CMFCToolBar::CMFCToolBar	Constructor predeterminado.
CMFCToolBar::~CMFCToolBar	Un destructor.

Métodos públicos

Name	Descripción
CMFCToolBar::AddBasicCommand	Agrega un comando de menú a la lista de comandos que se muestra cuando un usuario abre un menú.
CMFCToolBar::AddCommandUsage	Incrementa en uno el contador que está asociado al comando especificado.
CMFCToolBar::AddToolBarForImageCollection	Agregar imágenes de los recursos de interfaz de usuario a la colección de imágenes en la aplicación.
CMFCToolBar::AdjustLayout	Actualiza el tamaño y la posición de una barra de herramientas.(Reemplaza CBasePane::AdjustLayout).
CMFCToolBar::AdjustSize	Actualiza el tamaño de la barra de herramientas.
CMFCToolBar::AllowChangeTextLabels	Especifica si las etiquetas de texto se pueden mostrar en imágenes de los botones de la barra de herramientas.
CMFCToolBar::AreTextLabels	Especifica si las etiquetas de texto en imágenes se muestran actualmente en los botones de la barra de herramientas.
CMFCToolBar::AutoGrayInactiveImages	Habilita o deshabilita la generación automática de imágenes de botón inactivas.
CMFCToolBar::ButtonToIndex	devuelve el índice de un objeto especificado de Clase de CMFCToolBarButton en esta barra de herramientas.
CMFCToolBar::CalcFixedLayout	calcula el tamaño horizontal de la barra de herramientas.(Reemplaza CBasePane::CalcFixedLayout.)
CMFCToolBar::CalcSize	Llamado por el marco como parte del proceso de cálculo de diseño.(Reemplaza CPane::CalcSize.)
CMFCToolBar::CanHandleSiblings	Determina si colocan la barra de herramientas y su elemento relacionado en el mismo panel.
CMFCToolBar::CleanUpImages	Libera los recursos del sistema asignados para las imágenes de la barra de herramientas.
CMFCToolBar::CleanUpLockedImages	Libera los recursos del sistema asignados para las imágenes compilaciones de la barra de herramientas.
CMFCToolBar::CanBeClosed	especifica si un usuario puede cerrar la barra de herramientas.(Reemplaza CBasePane::CanBeClosed.)
CMFCToolBar::CanBeRestored	Determina si el sistema puede restaurar una barra de herramientas a su estado original después de la personalización.
CMFCToolBar::CanFocus	Especifica si el panel puede recibir el foco.(Reemplaza CBasePane::CanFocus.)
CMFCToolBar::CanHandleSiblings	Determina si colocan la barra de herramientas y su elemento relacionado en el mismo panel.
CMFCToolBar::CommandToIndex	Devuelve el índice del botón en la barra de herramientas con un identificador especificada de comando
CMFCToolBar::Create	Crea un objeto CMFCToolBar.
CMFCToolBar::CreateEx	Crea un objeto de CMFCToolBar que utilice más opciones de estilo, como iconos grandes.
CMFCToolBar::Deactivate	desactiva la barra de herramientas.
CMFCToolBar::EnableCustomizeButton	Habilita o deshabilita el botón de agregue o quite los botones que aparece al final de la barra de herramientas.
CMFCToolBar::EnableDocking	Habilita el acoplamiento del panel al cuadro principal.(Reemplaza CBasePane::EnableDocking.)
CMFCToolBar::EnableLargeIcons	Habilita o deshabilita iconos grandes en los botones de la barra de herramientas.
CMFCToolBar::EnableQuickCustomization	Habilita o deshabilita la personalización rápida de barras de herramientas para que el usuario puede presionar la tecla de Alt y arrastrar un botón a una nueva ubicación.
CMFCToolBar::EnableReflections	Habilita o deshabilita la reflexión del comando.
CMFCToolBar::EnableTextLabels	Habilita o deshabilita las etiquetas de texto en imágenes de botón de la barra de herramientas.
CMFCToolBar::FromHandlePermanent	Recupera un puntero al objeto de CMFCToolBar que contiene el identificador de ventana especificado.
CMFCToolBar::GetAllButtons	Devuelve una lista de solo lectura de botones de una barra de herramientas.
CMFCToolBar::GetAllToolbars	Devuelve una lista de solo lectura de todas las barras de herramientas en la aplicación.
CMFCToolBar::GetBasicCommands	Devuelve una lista de solo lectura de los comandos básicos definido en la aplicación.
CMFCToolBar::GetButton	Devuelve un puntero al objeto de CMFCToolBarButton que tiene un índice especificado del botón de la barra de herramientas.
CMFCToolBar::GetButtonInfo	Devuelve el identificador de comando, el estilo, y el índice del botón en el índice especificado.
CMFCToolBar::GetButtonSize	Devuelve las dimensiones de cada botón de la barra de herramientas.
CMFCToolBar::GetButtonStyle	Devuelve el estilo actual del botón de la barra de herramientas que se encuentra en el índice especificado.
CMFCToolBar::GetButtonText	Devuelve la etiqueta de texto de un botón que tiene el índice especificado.
CMFCToolBar::GetColdImages	Devuelve un puntero a la colección de imágenes en frío del botón de la barra de herramientas en la aplicación.
CMFCToolBar::GetColumnWidth	devuelve el ancho de los botones de la barra de herramientas.
CMFCToolBar::GetCommandButtons	Devuelve una lista de botones que tiene el identificador especificado de comando de todas las barras de herramientas en la aplicación.
CMFCToolBar::GetCount	Devuelve el número de botones y separadores en la barra de herramientas.
CMFCToolBar::GetCustomizeButton	Recupera un puntero al objeto de CMFCCustomizeButton que está asociado a la barra de herramientas.
CMFCToolBar::GetDefaultImage	Devuelve el índice de la imagen predeterminada para un botón de la barra de herramientas con un identificador especificada de comando
CMFCToolBar::GetDisabledImages	Devuelve un puntero a la colección de imágenes que se utilizan para los botones de la barra de herramientas deshabilitados en la aplicación.
CMFCToolBar::GetDisabledMenuImages	Devuelve un puntero a la colección de imágenes que se utilizan para los botones de menú deshabilitados en la aplicación.
CMFCToolBar::GetDroppedDownMenu	Recupera un puntero al objeto de botón de menú que muestra actualmente el submenú.
CMFCToolBar::GetGrayDisabledButtons	Especifica si las imágenes de botones deshabilitados son versiones atenuadas de las imágenes de botón estándar, o tomado de la colección de imágenes de botón deshabilitadas.
CMFCToolBar::GetHighlightedButton	Devuelve un puntero al botón de la barra de herramientas que está actualmente resaltado.
CMFCToolBar::GetHotBorder	determina si los botones de la barra de herramientas caluroso-están seguidos.
CMFCToolBar::GetHotTextColor	Devuelve el color del texto de los botones de la barra de herramientas resaltado.
CMFCToolBar::GetHwndLastFocus	Devuelve un identificador a la ventana que tiene el foco de entrada justo antes de que realizó la barra de herramientas.
CMFCToolBar::GetIgnoreSetText	Especifica si las llamadas a las etiquetas específicas de botón se omitirán.
CMFCToolBar::GetImageSize	Devuelve el tamaño actual de las imágenes de botón de la barra de herramientas.
CMFCToolBar::GetImages	Devuelve un puntero a la colección de imágenes de botón predeterminado en la aplicación.
CMFCToolBar::GetImagesOffset	Devuelve la diferencia de índice utilizado para buscar las imágenes de los botones de la barra de herramientas de esta barra de herramientas de la lista global de imágenes de botón de la barra de herramientas.
CMFCToolBar::GetInvalidateItemRect	Recupera la región del área de cliente que se debe volver a dibujar para el botón en el índice especificado.
CMFCToolBar::GetItemID	Devuelve el identificador de comando del botón de la barra de herramientas en el índice especificado.
CMFCToolBar::GetItemRect	Devuelve el rectángulo delimitador del botón en el índice especificado.
CMFCToolBar::GetLargeColdImages	Devuelve un puntero a la colección de imágenes en frío del botón de la barra de herramientas en la aplicación.
CMFCToolBar::GetLargeDisabledImages	Devuelve un puntero a la colección de imágenes deshabilitadas del botón de la barra de herramientas en la aplicación.
CMFCToolBar::GetLargeImages	Devuelve un puntero a la colección de imágenes del botón de la barra de herramientas en la aplicación.
CMFCToolBar::GetLockedColdImages	Devuelve un puntero a la colección de imágenes en frío bloqueadas en la barra de herramientas.
CMFCToolBar::GetLockedDisabledImages	Devuelve un puntero a la colección de imágenes deshabilitadas bloqueadas en la barra de herramientas.
CMFCToolBar::GetLockedImages	Devuelve un puntero a la colección de imágenes de botón bloqueadas en la barra de herramientas.
CMFCToolBar::GetLockedImageSize	Devuelve el tamaño predeterminado de imágenes compilaciones de la barra de herramientas.
CMFCToolBar::GetLockedMenuImages	Devuelve un puntero a la colección de imágenes bloqueadas en el menú de barras de herramientas en la barra de herramientas.
CMFCToolBar::GetMenuButtonSize	Devuelve el tamaño de botones de menú en la aplicación.
CMFCToolBar::GetMenuImageSize	Devuelve el tamaño de las imágenes de botón de menú en la aplicación.
CMFCToolBar::GetMenuImages	Devuelve un puntero a la colección de imágenes de botón de menú de la aplicación.
CMFCToolBar::GetOrigButtons	recupera la colección de botones no-personalizados de la barra de herramientas.
CMFCToolBar::GetOrigResetButtons	recupera la colección de botones de reinicio no-personalizados de la barra de herramientas.
CMFCToolBar::GetResourceID	recupera el Id. de recurso de la barra de herramientas.
CMFCToolBar::GetRouteCommandsViaFrame	determina que el objeto, el cuadro primario o el propietario, envía los comandos a la barra de herramientas.
CMFCToolBar::GetRowHeight	devuelve el alto de botones de la barra de herramientas.
CMFCToolBar::GetShowTooltips	Especifica si la información sobre herramientas se muestran para los botones de la barra de herramientas.
CMFCToolBar::GetSiblingToolBar	Recupera el elemento relacionado de la barra de herramientas.
CMFCToolBar::GetUserImages	Devuelve un puntero a la colección de imágenes definido por el usuario del botón de la barra de herramientas en la aplicación.
CMFCToolBar::HitTest	Devuelve el índice del botón de la barra de herramientas que se encuentra en la posición especificada.
CMFCToolBar::InsertButton	inserta un botón en la barra de herramientas.
CMFCToolBar::InsertSeparator	Inserta un separador de la barra de herramientas.
CMFCToolBar::InvalidateButton	Reemplaza el área cliente del botón de la barra de herramientas que existe en el índice especificado.
CMFCToolBar::IsAddRemoveQuickCustomize	Determina si un usuario puede agregar o quitar botones de la barra de herramientas mediante la opción de menú de Personalizar .
CMFCToolBar::IsAltCustomizeMode	Especifica si la personalización rápida se utiliza para agregar un botón.
CMFCToolBar::IsAutoGrayInactiveImages	Especifica si la generación automática de imágenes de botón (no resaltado) inactivas está habilitada.
CMFCToolBar::IsBasicCommand	determina si un comando está en la lista de comandos básicos.
CMFCToolBar::IsButtonExtraSizeAvailable	Determina si la barra de herramientas puede mostrar botones que tienen bordes extendidos.
CMFCToolBar::IsButtonHighlighted	Determina si un botón en la barra de herramientas está resaltado.
CMFCToolBar::IsCommandPermitted	determina si permiten a un comando.
CMFCToolBar::IsCommandRarelyUsed	Determina si se utiliza un comando raramente (vea CMFCToolBar::SetCommandUsageOptions).
CMFCToolBar::IsCustomizeMode	Especifica si el marco de la barra de herramientas está en modo de personalización.
CMFCToolBar::IsDragButton	Determina si se arrastra un botón de la barra de herramientas.
CMFCToolBar::IsExistCustomizeButton	determina si la barra de herramientas contiene el botón de Personalizar .
CMFCToolBar::IsFloating	Determina si la barra de herramientas flota.
CMFCToolBar::IsLargeIcons	Especifica si las barras de herramientas en la aplicación muestran actualmente iconos grandes.
CMFCToolBar::IsLastCommandFromButton	Determina si se suministra el comando recientemente ejecutado el botón de la barra de herramientas especificado.
CMFCToolBar::IsLocked	determina si la barra de herramientas está bloqueada.
CMFCToolBar::IsOneRowWithSibling	Determina si la barra de herramientas y la barra de herramientas relacionado están colocados en la misma fila.
CMFCToolBar::IsUserDefined	Especifica si la barra de herramientas está definido por el usuario.
CMFCToolBar::LoadBitmap	Carga las imágenes de la barra de herramientas de recursos de la aplicación.
CMFCToolBar::LoadBitmapEx	Carga las imágenes de la barra de herramientas de recursos de la aplicación.incluye imágenes grandes.
CMFCToolBar::LoadParameters	Carga opciones de barras de herramientas globales del Registro de Windows.
CMFCToolBar::LoadState	Carga información de estado de la barra de herramientas del Registro de Windows.(Reemplaza CPane::LoadState.)
CMFCToolBar::LoadToolBar	carga la barra de herramientas de recursos de la aplicación.
CMFCToolBar::LoadToolBarEx	Carga la barra de herramientas de recursos de la aplicación mediante la clase de CMFCToolBarInfo para que la aplicación para utilizar imágenes grandes.
CMFCToolBar::OnChangeHot	Llamado por el marco cuando un usuario selecciona un botón de la barra de herramientas.
CMFCToolBar::OnFillBackground	Llamado por el marco de CBasePane::DoPaint para rellenar el fondo de la barra de herramientas.
CMFCToolBar::OnReset	restablece la barra de herramientas a su estado original.
CMFCToolBar::OnSetAccData	(Reemplaza CBasePane::OnSetAccData.)
CMFCToolBar::OnSetDefaultButtonText	Restablece el texto de un botón de la barra de herramientas a su estado predeterminado.
CMFCToolBar::OnUpdateCmdUI	Utilizado de forma interna.
CMFCToolBar::RemoveAllButtons	quita todos los botones de la barra de herramientas.
CMFCToolBar::RemoveButton	quita el botón con el índice especificado de la barra de herramientas.
CMFCToolBar::RemoveStateFromRegistry	Elimina la información de estado de la barra de herramientas del Registro de Windows.
CMFCToolBar::ReplaceButton	reemplaza un botón de la barra de herramientas con otro botón de la barra de herramientas.
CMFCToolBar::ResetAll	restablece todas las barras de herramientas a sus estados originales.
CMFCToolBar::ResetAllImages	borra todas las colecciones de la imagen de la barra de herramientas en la aplicación.
CMFCToolBar::RestoreOriginalstate	Restaura el estado original de una barra de herramientas.
CMFCToolBar::SaveState	Guarda información de estado para la barra de herramientas en el Registro de Windows.(Reemplaza CPane::SaveState.)
CMFCToolBar::Serialize	(Reemplaza CBasePane::Serialize.)
CMFCToolBar::SetBasicCommands	Establece la lista de comandos que se muestra cuando un usuario abre un menú.
CMFCToolBar::SetButtonInfo	Establece el identificador de comando, el estilo, y el identificador de la imagen de un botón de la barra de herramientas.
CMFCToolBar::SetButtonStyle	Establece el estilo de botón de la barra de herramientas en el índice especificado.
CMFCToolBar::SetButtonText	Establece el etiqueta de texto de un botón de la barra de herramientas.
CMFCToolBar::SetButtons	Establece los botones de la barra de herramientas.
CMFCToolBar::SetCommandUsageOptions	Especifica cuándo los comandos raramente utilizados no aparecen en el menú de la aplicación.
CMFCToolBar::SetCustomizeMode	Habilita o deshabilita el modo de personalización para todas las barras de herramientas en la aplicación.
CMFCToolBar::SetGrayDisabledButtons	Especifica si los botones deshabilitados en la barra de herramientas están deshabilitados o si las imágenes deshabilitadas se utilizan para los botones deshabilitados.
CMFCToolBar::SetHeight	establece el alto de la barra de herramientas.
CMFCToolBar::SetHotBorder	especifica si los botones de la barra de herramientas caluroso-están seguidos.
CMFCToolBar::SetHotTextColor	Establece el color del texto para los botones de la barra de herramientas activo.
CMFCToolBar::SetLargeIcons	Especifica si los botones de la barra de herramientas muestra iconos grandes.
CMFCToolBar::SetLockedSizes	Establece los tamaños de botones bloqueados y las imágenes bloqueadas en la barra de herramientas.
CMFCToolBar::SetMenuSizes	Establece el tamaño de los botones de menú de barras de herramientas y de las imágenes.
CMFCToolBar::SetNonPermittedCommands	establece la lista de comandos que no se puede ejecutar por el usuario.
CMFCToolBar::SetOneRowWithSibling	posiciones la barra de herramientas y su elemento relacionado respecto a la misma fila.
CMFCToolBar::SetPermament	especifica si un usuario puede cerrar la barra de herramientas.
CMFCToolBar::SetRouteCommandsViaFrame	Especifica si el marco primario o el propietario envía comandos a la barra de herramientas.
CMFCToolBar::SetShowTooltips	Especifica si el marco muestra información sobre herramientas.
CMFCToolBar::SetSiblingToolBar	Especifica el elemento relacionado de la barra de herramientas.
CMFCToolBar::SetSizes	Especifica los tamaños de botones y las imágenes en todas las barras de herramientas.
CMFCToolBar::SetToolBarBtnText	Especifica las propiedades de un botón en la barra de herramientas.
CMFCToolBar::SetTwoRowsWithSibling	Posiciones la barra de herramientas y su elemento relacionado respecto a filas independientes.
CMFCToolBar::SetUserImages	establece la colección de imágenes definido por el usuario en la aplicación.
CMFCToolBar::StretchPane	Expande la barra de herramientas vertical u horizontalmente. (Reemplaza CBasePane::StretchPane.)
CMFCToolBar::TranslateChar	Ejecuta un comando del botón si la clave especificada corresponde a un método abreviado de teclado válido.
CMFCToolBar::UpdateButton	Actualiza el estado del botón especificado.
CMFCToolBar::WrapToolBar	Coloca los botones de la barra de herramientas de nuevo dentro de las dimensiones especificadas.

Métodos protegidos

Name	Descripción
CMFCToolBar::AllowShowOnList	Determina si la barra de herramientas se muestra en la lista del panel de barras de herramientas del cuadro de diálogo de Personalizar .
CMFCToolBar::CalcMaxButtonHeight	calcula el alto máximo de un botón en la barra de herramientas.
CMFCToolBar::DoPaint	Redibuja una barra de herramientas.
CMFCToolBar::DrawButton	Redibuja un botón de la barra de herramientas.
CMFCToolBar::DrawSeparator	Redibuja un separador de una barra de herramientas.
CMFCToolBar::OnUserToolTip	Llamado por el marco cuando la información sobre herramientas de un botón está a punto de ser mostrada.

miembros de datos

Name	Descripción
CMFCToolBar::m_bDontScaleImages	Especifica si escalar o no las imágenes de la barra de herramientas de alto modo de PPP.
CMFCToolBar::m_dblLargeImageRatio	Especifica la relación entre la dimensión (alto o ancho) de imágenes grandes y la dimensión de las imágenes normales.

Comentarios

Para especificar un objeto de CMFCToolBar en la aplicación, siga estos pasos:

Agregue un objeto de CMFCToolBar a la ventana de marco principal.
Cuando se procesa el mensaje de WM_CREATE para la ventana de marco principal, llame a CMFCToolBar::Create o CMFCToolBar::CreateEx para crear la barra de herramientas y especificar su estilo.
Llamada CBasePane::EnableDocking para especificar el estilo de acoplamiento.

Para insertar un botón especial, como un cuadro combinado o una barra de herramientas desplegable, reserva un botón ficticio en el recurso primario, y reemplace el botón ficticio en tiempo de ejecución mediante CMFCToolBar::ReplaceButton.Para obtener más información, vea Tutorial: Colocar Controles en las barras de herramientas.

CMFCToolBar es la clase base para las clases Clase de CMFCMenuBar, Clase de CMFCPopupMenuBar, y Clase de CMFCDropDownToolBarde la biblioteca MFC.

Ejemplo

El ejemplo siguiente se muestra cómo utilizar varios métodos en la clase de CMFCToolBar .El ejemplo muestra cómo establecer el texto de la etiqueta de ventana de la barra de herramientas, establecer los bordes, establecer el estilo del panel, y habilitar el botón de agregue o quite los botones que aparece al final de la barra de herramientas.Este fragmento de código es parte de Ejemplo de demostración de IE.

    CMFCToolBar     m_wndToolBar;


...


    m_wndToolBar.SetWindowText (_T("Standard"));
    m_wndToolBar.SetBorders ();

    //------------------------------------
    // Remove toolbar gripper and borders:
    //------------------------------------
    m_wndToolBar.SetPaneStyle (m_wndToolBar.GetPaneStyle() &
        ~(CBRS_GRIPPER | CBRS_BORDER_TOP | CBRS_BORDER_BOTTOM | CBRS_BORDER_LEFT | CBRS_BORDER_RIGHT));

    m_wndToolBar.EnableCustomizeButton (TRUE, ID_VIEW_CUSTOMIZE, _T("Customize..."));