Leer en inglés

Compartir a través de


CMFCToolBar Class

La clase de CMFCToolBar se parece a CToolBar (Clase), 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 CMFCToolBarButton Class 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:

  1. Agregue un objeto de CMFCToolBar a la ventana de marco principal.

  2. 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.

  3. 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: Poner controles en las barras de herramientas.

CMFCToolBar es la clase base para las clases CMFCMenuBar Class, CMFCPopupMenuBar Class, y CMFCDropDownToolBar Classde 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..."));

Requisitos

encabezado: afxtoolbar.h

Jerarquía de herencia

CObject

   CCmdTarget

      CWnd

         CBasePane

            CPane

               CMFCBaseToolBar

                  CMFCToolBar

Vea también

Tareas

Tutorial: Poner controles en las barras de herramientas

Referencia

Gráfico de jerarquías

CMFCMenuBar Class

CMFCPopupMenuBar Class

CMFCDropDownToolBar Class

Otros recursos

Clases de MFC