Clase `CMFCToolBar`

Artículo
06/16/2023

La clase CMFCToolBar es similar a CToolBar Class, pero proporciona compatibilidad adicional con las características de la interfaz de usuario. Se incluyen las barras de herramientas planas, las barras de herramientas con imágenes activas, los iconos grandes, los botones de buscapersonas, las barras de herramientas bloqueadas, los controles rebar, el texto en imágenes, las imágenes de fondo y las barras de herramientas con pestañas. La clase 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, botones del cuadro de edición, selectores de colores y botones acumulados.

Para más información, consulta el código fuente ubicado en la instalación de Visual Studio, por ejemplo, %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Sintaxis

class CMFCToolBar : public CMFCBaseToolBar

Miembros

Constructores públicos

Nombre	Descripción
`CMFCToolBar::CMFCToolBar`	Constructor predeterminado.
`CMFCToolBar::~CMFCToolBar`	Destructor.

Métodos públicos

Nombre	Descripción
`CMFCToolBar::AddBasicCommand`	Agrega un comando de menú a la lista de comandos que siempre se muestran cuando un usuario abre un menú.
`CMFCToolBar::AddCommandUsage`	Incrementa en uno el contador asociado al comando especificado.
`CMFCToolBar::AddToolBarForImageCollection`	Agrega imágenes de los recursos de la interfaz de usuario a la colección de imágenes de la aplicación.
`CMFCToolBar::AdjustLayout`	Recalcula el tamaño y la posición de una barra de herramientas. (Invalida `CBasePane::AdjustLayout`).
`CMFCToolBar::AdjustSize`	Recalcula 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 de las 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 `CMFCToolBarButton` Class especificado en esta barra de herramientas.
`CMFCToolBar::CalcFixedLayout`	Calcula el tamaño horizontal de la barra de herramientas. (Invalida `CBasePane::CalcFixedLayout`).
`CMFCToolBar::CalcSize`	Lo llama el marco como parte del proceso de cálculo de diseño. (Invalida `CPane::CalcSize`).
`CMFCToolBar::CanHandleSiblings`	Determina si la barra de herramientas y sus elementos relacionados están colocados 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 de la barra de herramientas bloqueadas.
`CMFCToolBar::CanBeClosed`	Especifica si un usuario puede cerrar la barra de herramientas. (Invalida `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. (Invalida `CBasePane::CanFocus`).
`CMFCToolBar::CanHandleSiblings`	Determina si la barra de herramientas y sus elementos relacionados están colocados en el mismo panel.
`CMFCToolBar::CommandToIndex`	Devuelve el índice del botón de la barra de herramientas con un identificador de comando especificado.
`CMFCToolBar::Create`	Crea un objeto `CMFCToolBar`.
`CMFCToolBar::CreateEx`	Crea un objeto `CMFCToolBar` que usa opciones de estilo adicionales, como iconos grandes.
`CMFCToolBar::Deactivate`	Desactiva la barra de herramientas.
`CMFCToolBar::EnableCustomizeButton`	Habilita o deshabilita el botón Agregar o quitar botones que aparece al final de la barra de herramientas.
`CMFCToolBar::EnableDocking`	Habilita el acoplamiento del panel al marco principal. (Invalida `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 las barras de herramientas para que el usuario pueda presionar la tecla Alt y arrastrar un botón a una nueva ubicación.
`CMFCToolBar::EnableReflections`	Habilita o deshabilita la reflexión de comandos.
`CMFCToolBar::EnableTextLabels`	Habilita o deshabilita las etiquetas de texto en las imágenes de botón de la barra de herramientas.
`CMFCToolBar::FromHandlePermanent`	Recupera un puntero al objeto `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 de la aplicación.
`CMFCToolBar::GetBasicCommands`	Devuelve una lista de solo lectura de los comandos básicos definidos en la aplicación.
`CMFCToolBar::GetButton`	Devuelve un puntero al objeto `CMFCToolBarButton` que tiene un índice de botón de barra de herramientas especificado.
`CMFCToolBar::GetButtonInfo`	Devuelve el identificador de comando, el estilo y el índice de imagen del botón en un í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 un índice especificado.
`CMFCToolBar::GetColdImages`	Devuelve un puntero a la colección de imágenes de botón de barra de herramientas inactivas de la aplicación.
`CMFCToolBar::GetColumnWidth`	Devuelve el ancho de los botones de la barra de herramientas.
`CMFCToolBar::GetCommandButtons`	Devuelve una lista de botones que tienen un identificador de comando especificado de todas las barras de herramientas de la aplicación.
`CMFCToolBar::GetCount`	Devuelve el número de botones y separadores de la barra de herramientas.
`CMFCToolBar::GetCustomizeButton`	Recupera un puntero al objeto `CMFCCustomizeButton` asociado a la barra de herramientas.
`CMFCToolBar::GetDefaultImage`	Devuelve el índice de la imagen predeterminada de un botón de la barra de herramientas con un identificador de comando especificado.
`CMFCToolBar::GetDisabledImages`	Devuelve un puntero a la colección de imágenes que se usan 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 usan 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 su submenú.
`CMFCToolBar::GetGrayDisabledButtons`	Especifica si las imágenes de botones deshabilitados son versiones atenuadas de las imágenes de botón normales o se han tomado de la colección de imágenes de botón deshabilitado.
`CMFCToolBar::GetHighlightedButton`	Devuelve un puntero al botón de la barra de herramientas que está resaltado actualmente.
`CMFCToolBar::GetHotBorder`	Determina si los botones de la barra de herramientas son de seguimiento activo.
`CMFCToolBar::GetHotTextColor`	Devuelve el color de texto de los botones de la barra de herramientas resaltados.
`CMFCToolBar::GetHwndLastFocus`	Devuelve un identificador de la ventana que tenía el foco de entrada justo antes de que la barra de herramientas lo tuviera.
`CMFCToolBar::GetIgnoreSetText`	Especifica si se omiten las llamadas para establecer etiquetas de botó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 predeterminadas en la aplicación.
`CMFCToolBar::GetImagesOffset`	Devuelve el desplazamiento de índice usado para buscar las imágenes de botón de la barra de herramientas de esta barra de herramientas en la lista global de imágenes de botón de barra de herramientas.
`CMFCToolBar::GetInvalidateItemRect`	Recupera la región del área 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 un índice especificado.
`CMFCToolBar::GetItemRect`	Devuelve el rectángulo delimitador del botón en un índice especificado.
`CMFCToolBar::GetLargeColdImages`	Devuelve un puntero a la colección de imágenes de botón de barra de herramientas inactivas grandes en la aplicación.
`CMFCToolBar::GetLargeDisabledImages`	Devuelve un puntero a la colección de imágenes de botón de barra de herramientas deshabilitadas grandes de la aplicación.
`CMFCToolBar::GetLargeImages`	Devuelve un puntero a la colección de imágenes de botón de barra de herramientas grande de la aplicación.
`CMFCToolBar::GetLockedColdImages`	Devuelve un puntero a la colección de imágenes inactivas bloqueadas de la barra de herramientas.
`CMFCToolBar::GetLockedDisabledImages`	Devuelve un puntero a la colección de imágenes deshabilitadas bloqueadas de la barra de herramientas.
`CMFCToolBar::GetLockedImages`	Devuelve un puntero a la colección de imágenes de botón bloqueadas de la barra de herramientas.
`CMFCToolBar::GetLockedImageSize`	Devuelve el tamaño predeterminado de las imágenes de barra de herramientas bloqueada.
`CMFCToolBar::GetLockedMenuImages`	Devuelve un puntero a la colección de imágenes de menú de la barra de herramientas bloqueadas de la barra de herramientas.
`CMFCToolBar::GetMenuButtonSize`	Devuelve el tamaño de los botones de menú de la aplicación.
`CMFCToolBar::GetMenuImageSize`	Devuelve el tamaño de las imágenes de botón de menú de 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 restablecimiento no personalizados de la barra de herramientas.
`CMFCToolBar::GetResourceID`	Recupera el identificador de recurso de la barra de herramientas.
`CMFCToolBar::GetRouteCommandsViaFrame`	Determina qué objeto, el marco principal o el propietario, envía comandos a la barra de herramientas.
`CMFCToolBar::GetRowHeight`	Devuelve el alto de los botones de la barra de herramientas.
`CMFCToolBar::GetShowTooltips`	Especifica si se mostrarán sugerencias de herramientas para los botones de la barra de herramientas.
`CMFCToolBar::GetSiblingToolBar`	Recupera el elemento del mismo nivel de la barra de herramientas.
`CMFCToolBar::GetUserImages`	Devuelve un puntero a la colección de imágenes de botón de barra de herramientas definidas por el usuario de 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 en la barra de herramientas.
`CMFCToolBar::InvalidateButton`	Invalida el área cliente del botón de la barra de herramientas que existe en el índice proporcionado.
`CMFCToolBar::IsAddRemoveQuickCustomize`	Determina si un usuario puede agregar o quitar botones de la barra de herramientas mediante la opción de menú Personalizar.
`CMFCToolBar::IsAltCustomizeMode`	Especifica si se usa la personalización rápida para arrastrar un botón.
`CMFCToolBar::IsAutoGrayInactiveImages`	Especifica si la generación automática de imágenes de botón inactivas (no resaltadas) 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 de la barra de herramientas está resaltado.
`CMFCToolBar::IsCommandPermitted`	Determina si se permite un comando.
`CMFCToolBar::IsCommandRarelyUsed`	Determina si rara vez se usa un comando (consulte `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 Personalizar.
`CMFCToolBar::IsFloating`	Determina si la barra de herramientas es flotante.
`CMFCToolBar::IsLargeIcons`	Especifica si las barras de herramientas de la aplicación muestran actualmente iconos grandes.
`CMFCToolBar::IsLastCommandFromButton`	Determina si el comando ejecutado más recientemente se envió desde 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 su barra de herramientas del mismo nivel están colocados en la misma fila.
`CMFCToolBar::IsUserDefined`	Especifica si la barra de herramientas está definida por el usuario.
`CMFCToolBar::LoadBitmap`	Carga las imágenes de la barra de herramientas desde los recursos de la aplicación.
`CMFCToolBar::LoadBitmapEx`	Carga las imágenes de la barra de herramientas desde los recursos de la aplicación. Incluye imágenes grandes.
`CMFCToolBar::LoadParameters`	Carga las opciones globales de la barra de herramientas desde el Registro de Windows.
`CMFCToolBar::LoadState`	Carga la información de estado de la barra de herramientas desde el Registro de Windows. (Invalida `CPane::LoadState`).
`CMFCToolBar::LoadToolBar`	Carga la barra de herramientas desde los recursos de la aplicación.
`CMFCToolBar::LoadToolBarEx`	Carga la barra de herramientas desde los recursos de la aplicación mediante la clase auxiliar `CMFCToolBarInfo` para permitir que la aplicación use imágenes grandes.
`CMFCToolBar::OnChangeHot`	Lo llama el marco cuando un usuario selecciona un botón en la barra de herramientas.
`CMFCToolBar::OnFillBackground`	Lo llama el marco desde `CBasePane::DoPaint` para rellenar el fondo de la barra de herramientas.
`CMFCToolBar::OnReset`	Restaura la barra de herramientas a su estado original.
`CMFCToolBar::OnSetAccData`	(Invalida `CBasePane::OnSetAccData`).
`CMFCToolBar::OnSetDefaultButtonText`	Restaura el texto de un botón de 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 barra de herramientas por otro botón de barra de herramientas.
`CMFCToolBar::ResetAll`	Restaura todas las barras de herramientas a sus estados originales.
`CMFCToolBar::ResetAllImages`	Borra todas las colecciones de imágenes de barra de herramientas de la aplicación.
`CMFCToolBar::RestoreOriginalState`	Restaura el estado original de una barra de herramientas.
`CMFCToolBar::SaveState`	Guarda la información de estado de la barra de herramientas en el Registro de Windows. (Invalida `CPane::SaveState`).
`CMFCToolBar::Serialize`	(Invalida `CBasePane::Serialize`).
`CMFCToolBar::SetBasicCommands`	Establece la lista de comandos que siempre se muestran cuando un usuario abre un menú.
`CMFCToolBar::SetButtonInfo`	Establece el identificador de comando, el estilo y el identificador de imagen de un botón de la barra de herramientas.
`CMFCToolBar::SetButtonStyle`	Establece el estilo del botón de la barra de herramientas en el índice especificado.
`CMFCToolBar::SetButtonText`	Establece la 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 usados raramente 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 de la aplicación.
`CMFCToolBar::SetGrayDisabledButtons`	Especifica si los botones deshabilitados de la barra de herramientas están atenuados o si se usan imágenes deshabilitadas 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 tienen un seguimiento activo.
`CMFCToolBar::SetHotTextColor`	Establece el color del texto para los botones de la barra de herramientas activos.
`CMFCToolBar::SetLargeIcons`	Especifica si los botones de la barra de herramientas muestran iconos grandes.
`CMFCToolBar::SetLockedSizes`	Establece los tamaños de los botones bloqueados y las imágenes bloqueadas en la barra de herramientas.
`CMFCToolBar::SetMenuSizes`	Establece el tamaño de los botones de menú de la barra de herramientas y sus imágenes.
`CMFCToolBar::SetNonPermittedCommands`	Establece la lista de comandos que el usuario no puede ejecutar.
`CMFCToolBar::SetOneRowWithSibling`	Coloca la barra de herramientas y sus elementos del mismo nivel en la misma fila.
`CMFCToolBar::SetPermament`	Especifica si un usuario puede cerrar la barra de herramientas.
`CMFCToolBar::SetRouteCommandsViaFrame`	Especifica si el marco principal o el propietario envían comandos a la barra de herramientas.
`CMFCToolBar::SetShowTooltips`	Especifica si el marco muestra información sobre herramientas.
`CMFCToolBar::SetSiblingToolBar`	Especifica el elemento del mismo nivel de la barra de herramientas.
`CMFCToolBar::SetSizes`	Especifica los tamaños de los botones y las imágenes de todas las barras de herramientas.
`CMFCToolBar::SetToolBarBtnText`	Especifica las propiedades de un botón de la barra de herramientas.
`CMFCToolBar::SetTwoRowsWithSibling`	Coloca la barra de herramientas y su elemento del mismo nivel en distintas filas.
`CMFCToolBar::SetUserImages`	Establece la colección de imágenes definidas por el usuario en la aplicación.
`CMFCToolBar::StretchPane`	Estira la barra de herramientas vertical u horizontalmente. (Invalida `CBasePane::StretchPane`).
`CMFCToolBar::TranslateChar`	Ejecuta un comando de botón si el código de tecla especificado corresponde a un método abreviado de teclado válido.
`CMFCToolBar::UpdateButton`	Actualiza el estado del botón especificado.
`CMFCToolBar::WrapToolBar`	Cambia la posición de los botones de la barra de herramientas dentro de las dimensiones especificadas.

Métodos protegidos

Nombre	Descripción
`CMFCToolBar::AllowShowOnList`	Determina si la barra de herramientas se muestra en la lista del panel Barras de herramientas del cuadro de diálogo Personalizar.
`CMFCToolBar::CalcMaxButtonHeight`	Calcula el alto máximo de un botón de la barra de herramientas.
`CMFCToolBar::DoPaint`	Vuelve a pintar una barra de herramientas.
`CMFCToolBar::DrawButton`	Vuelve a pintar un botón de la barra de herramientas.
`CMFCToolBar::DrawSeparator`	Vuelve a pintar un separador en una barra de herramientas.
`CMFCToolBar::OnUserToolTip`	Lo llama el marco antes de que aparezca la información sobre herramientas de un botón.

Miembros de datos

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

Comentarios

Para incorporar un objeto CMFCToolBar a la aplicación, siga estos pasos:

Agregue un objeto CMFCToolBar a la ventana de marco principal.
Cuando procese el mensaje 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.
Llame a CBasePane::EnableDocking para especificar el estilo de acoplamiento.

Para insertar un botón especial, como un cuadro combinado o una barra de herramientas desplegable, reserve un botón ficticio en el recurso principal y reemplace el botón ficticio en tiempo de ejecución mediante CMFCToolBar::ReplaceButton. Para más información, consulte Tutorial: Colocación de controles en las barras de herramientas.

CMFCToolBar es la clase base de las clases de la biblioteca de MFC CMFCMenuBar Class, CMFCPopupMenuBar Class y CMFCDropDownToolBar Class.

Ejemplo

En el siguiente ejemplo se muestra cómo usar los distintos métodos en la clase CMFCToolBar . En el ejemplo se 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 Agregar o quitar botones que aparece al final de la barra de herramientas. Este fragmento de código forma parte del 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

Encabezadoafxtoolbar.h:

Jerarquía de herencia

CMFCToolBar

`CMFCToolBar::AddBasicCommand`

Agrega un comando de menú a la lista de comandos que siempre se muestran cuando un usuario abre un menú.

static void __stdcall AddBasicCommand(UINT uiCmd);

Parámetros

uiCmd
[in] Especifica el comando que se va a agregar.

Comentarios

Siempre se muestra un comando básico cuando se abre el menú. Este método es significativo cuando el usuario elige ver los comandos usados recientemente.

Use el método CMFCToolBar::SetBasicCommands para establecer la lista de comandos que siempre se muestran cuando un usuario abre un menú. Use el método CMFCToolBar::GetBasicCommands para recuperar la lista de comandos básicos que usa la aplicación.

`CMFCToolBar::AddCommandUsage`

Incrementa en uno el contador asociado al comando especificado.

static void __stdcall AddCommandUsage(UINT uiCommand);

Parámetros

uiCommand
[in] Especifica el contador de comandos que se va a incrementar.

Comentarios

El marco llama a este método cuando el usuario selecciona un elemento de menú.

El marco usa contadores de comandos para mostrar elementos de menú usados recientemente.

Este método incrementa el contador de comandos mediante el método CMFCCmdUsageCount::AddCmd.

`CMFCToolBar::AddToolBarForImageCollection`

Agrega imágenes de los recursos de la interfaz de usuario a la colección de imágenes de la aplicación.

static BOOL __stdcall AddToolBarForImageCollection(
    UINT uiResID,
    UINT uiBmpResID=0,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0);

Parámetros

uiResID
[in] Identificador de recurso de una barra de herramientas con imágenes que se van a cargar.

uiBmpResID
[in] Identificador de recurso de un mapa de bits con imágenes de barra de herramientas.

uiColdResID
[in] Identificador de recurso de un mapa de bits con imágenes de barra de herramientas "inactivas".

uiMenuResID
[in] Identificador de recurso de un mapa de bits con imágenes de menú.

uiDisabledResID
[in] Identificador de recurso de un mapa de bits con imágenes de barra de herramientas deshabilitadas.

uiMenuDisabledResID
[in] Identificador de recurso de un mapa de bits con imágenes de menú deshabilitadas.

Valor devuelto

TRUE si el método se ejecuta correctamente; FALSE si uiResID o uiBmpResID no especifican recursos válidos o se produce otro error.

Comentarios

Llame a este método para cargar un mapa de bits con imágenes de la barra de herramientas y agregarlo a la colección de imágenes de la barra de herramientas. Este método crea un objeto de barra de herramientas temporal y llama a CMFCToolBar::LoadToolBar.

`CMFCToolBar::AdjustLayout`

Recalcula el tamaño y la posición de una barra de herramientas.

virtual void AdjustLayout();

Comentarios

Llame a este método cuando se haya creado la barra de herramientas para recalcular su tamaño y posición.

El marco llama a este método cada vez que se debe cambiar el diseño de la barra de herramientas. Por ejemplo, el diseño debe cambiar cuando el usuario mueve otra barra de control, cambia el tamaño de una ventana de la aplicación o personaliza la barra de herramientas.

Invalide este método para proporcionar su propio diseño dinámico en las clases derivadas de CMFCToolbar.

`CMFCToolBar::AdjustSize`

Recalcula el tamaño de la barra de herramientas.

void AdjustSize();

Comentarios

Este método garantiza que la barra de herramientas se ajuste a los límites del marco principal. Este método no hace nada si la barra de herramientas no tiene ningún marco principal.

El método CMFCToolBar::AdjustLayout llama a este método para recalcular el tamaño si el elemento principal de la barra de herramientas no es un objeto CMFCReBar.

`CMFCToolBar::AllowChangeTextLabels`

Especifica si las etiquetas de texto se pueden mostrar en imágenes de los botones de la barra de herramientas.

virtual BOOL AllowChangeTextLabels() const;

Valor devuelto

TRUE si se permite mostrar etiquetas de texto debajo de imágenes; de lo contrario FALSE.

Comentarios

El cuadro de diálogo de personalización llama a este método para determinar si quiere habilitar una casilla Mostrar etiquetas de texto en la página Barras de herramientas de la barra de herramientas seleccionada.

La implementación predeterminada devuelve TRUE.

Invalide este método en un objeto derivado de CMFCToolBar y devuelva FALSE cuando no quiera que el usuario decida si las etiquetas de texto se muestran en los botones de la barra de herramientas de las imágenes.

`CMFCToolBar::AllowShowOnList`

Determina si la barra de herramientas se muestra en la lista de barras de herramientas del panel Barras de herramientas del cuadro de diálogo Personalizar.

virtual BOOL AllowShowOnList() const;

Valor devuelto

TRUE si el objeto de la barra de herramientas se puede mostrar en el cuadro de lista de la página de personalización de la barra de herramientas; de lo contrario, FALSE.

Comentarios

El marco llama a este método para determinar si la lista de la página de personalización de la barra de herramientas debe incluir un objeto determinado derivado de CMFCToolBar.

La implementación predeterminada siempre devuelve TRUE. Invalide este método cuando no quiera que una barra de herramientas aparezca en la lista de barras de herramientas del cuadro de diálogo de personalización.

`CMFCToolBar::AreTextLabels`

Especifica si las etiquetas de texto de las imágenes se muestran actualmente en los botones de la barra de herramientas.

BOOL AreTextLabels() const;

Valor devuelto

TRUE si los botones de la barra de herramientas muestran etiquetas de texto debajo de las imágenes; de lo contrario, FALSE.

Comentarios

Use CMFCToolBar::EnableTextLabels para especificar si se muestra el texto. El valor predeterminado es FALSE. Llame a CMFCToolBar::AllowChangeTextLabels para especificar si el usuario puede cambiar esta configuración en el cuadro de diálogo de personalización.

`CMFCToolBar::AutoGrayInactiveImages`

Habilita o deshabilita la generación automática de imágenes de botón inactivas.

static void AutoGrayInactiveImages(
    BOOL bEnable=TRUE,
    int nGrayImagePercentage=0,
    BOOL bRedrawAllToolbars=TRUE);

Parámetros

bEnable
[in] Valor booleano que especifica si se deben atenuar las imágenes inactivas. Si este parámetro es TRUE, las imágenes inactivas se atenúan. De lo contrario, las imágenes inactivas no se atenúan.

nGrayImagePercentage
[in] Especifica el porcentaje de luminancia para las imágenes inactivas. Si bEnable es FALSE, este valor se omite.

bRedrawAllToolbars
[in] Valor booleano que especifica si se deben volver a dibujar todas las barras de herramientas de la aplicación. Si este parámetro es TRUE, este método vuelve a dibujar todas las barras de herramientas.

Comentarios

Si bEnable es TRUE, el marco usa nGrayImagePercentage para generar imágenes inactivas a partir de las imágenes normales. De lo contrario, debe proporcionar el conjunto de imágenes inactivas mediante el método CMFCToolBar::GetColdImages. Esta opción está deshabilitada de forma predeterminada.

Para obtener más información acerca del parámetro nGrayImagePercentage, vea CMFCToolBarImages::GrayImages.

`CMFCToolBar::ButtonToIndex`

Devuelve el índice de un objeto CMFCToolBarButton Class especificado en esta barra de herramientas.

int ButtonToIndex(const CMFCToolBarButton* pButton) const;

Parámetros

pButton
[in] Puntero al objeto de botón de la barra de herramientas.

Valor devuelto

Índice de pButton en la lista interna de botones de la barra de herramientas; o -1 si el botón especificado no está en esta barra de herramientas.

`CMFCToolBar::CalcFixedLayout`

Calcula el tamaño horizontal de la barra de herramientas.

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Parámetros

bStretch
[in] TRUE para ajustar la barra de herramientas al tamaño del marco principal.

bHorz
[in] TRUE para orientar la barra de herramientas horizontalmente; FALSE para orientar la barra de herramientas verticalmente.

Valor devuelto

Objeto CSize que especifica el tamaño de la barra de herramientas.

Comentarios

Este método calcula el tamaño de la barra de herramientas mediante el método CMFCToolBar::CalcLayout. Pasa la marca LM_STRETCH del parámetro dwMode si bStretch es TRUE. Pasa la marca LM_HORZ si bHorz es TRUE.

Consulte el ejemplo de VisualStudioDemo para ver cómo se usa este método.

`CMFCToolBar::CalcMaxButtonHeight`

Calcula el alto máximo de los botones de la barra de herramientas.

virtual int CalcMaxButtonHeight();

Valor devuelto

Alto máximo de los botones.

Comentarios

Este método calcula el alto máximo entre todos los botones de la barra de herramientas. El alto puede variar en función de factores como el estado actual de acoplamiento de la barra de herramientas.

Invalide este método en una clase derivada de CMFCToolBar para proporcionar su propio cálculo de alto.

`CMFCToolBar::CalcSize`

Lo llama el marco como parte del proceso de cálculo de diseño.

virtual CSize CalcSize(BOOL bVertDock);

Parámetros

bVertDock
[in] TRUE para especificar que la barra de herramientas se acople verticalmente; FALSE para especificar que la barra de herramientas se acople horizontalmente.

Valor devuelto

Objeto CSize que especifica el tamaño general de la barra de herramientas.

Comentarios

Este método considera los atributos que afectan al tamaño de cada botón, como el área de la etiqueta de texto y el tamaño del borde.

Si la barra de herramientas no contiene botones, este método devuelve el tamaño reservado de un solo botón mediante el método CMFCToolBar::GetButtonSize.

`CMFCToolBar::CanBeClosed`

Especifica si un usuario puede cerrar la barra de herramientas.

virtual BOOL CanBeClosed() const;

Valor devuelto

TRUE si el usuario puede cerrar la barra de herramientas; de lo contrario, FALSE.

Comentarios

El marco llama a este método para determinar si el usuario puede cerrar una barra de herramientas. Si el método devuelve TRUE, el marco habilita el comando SC_CLOSE en el menú del sistema de la barra de herramientas y el usuario puede cerrar la barra de herramientas usando una casilla de la lista de barras de herramientas del cuadro de diálogo de personalización.

La implementación predeterminada devuelve TRUE. Invalide este método en una clase derivada de CMFCToolBar para crear objetos de barra de herramientas que el usuario no pueda cerrar.

`CMFCToolBar::CanBeRestored`

Determina si el sistema puede restaurar una barra de herramientas a su estado original después de la personalización.

virtual BOOL CanBeRestored() const;

Valor devuelto

TRUE si la barra de herramientas se puede restaurar desde los recursos de la aplicación; de lo contrario, FALSE.

Comentarios

El marco llama a este método para determinar si se puede devolver una barra de herramientas a su estado original después de la personalización. El estado original se carga desde los recursos de la aplicación.

Si CanBeRestored devuelve TRUE, la página Barras de herramientas del cuadro de diálogo de personalización habilita el botón Restablecer para la barra de herramientas seleccionada.

La implementación predeterminada devuelve TRUE si el identificador de recurso original de la barra de herramientas cuando se cargó es distinto de cero. Normalmente, las únicas barras de herramientas que no se pueden restaurar son las definidas por el usuario.

Puede invalidar el método CanBeRestored para personalizar este comportamiento en clases derivadas.

`CMFCToolBar::CanFocus`

Especifica si el panel puede recibir el foco.

virtual BOOL CanFocus() const;

Valor devuelto

Este método devuelve FALSE.

Comentarios

Este método invalida la implementación de la clase base, CBasePane::CanFocus, porque los objetos de la barra de herramientas no pueden recibir el foco.

`CMFCToolBar::CanHandleSiblings`

Determina si la barra de herramientas y sus elementos relacionados están colocados en el mismo panel.

BOOL CanHandleSiblings();

Valor devuelto

TRUE si la barra de herramientas tiene un elemento del mismo nivel y la barra de herramientas y su elemento del mismo nivel están colocados en el mismo panel; en caso contrario, FALSE.

Comentarios

El método interno CMFCCustomizeButton::CreatePopupMenu llama a este método para determinar cómo mostrar el menú emergente Personalizar. Si este método devuelve TRUE, el marco muestra los botones Mostrar botones en una fila o Mostrar botones en dos filas.

Normalmente no tiene que utilizar este método. Para habilitar el botón Personalizar que aparece en la barra de herramientas, llame al método CMFCToolBar::EnableCustomizeButton. Para habilitar los botones Mostrar botones en una fila o Mostrar botones en dos filas, llame a CMFCToolBar::SetSiblingToolBar.

`CMFCToolBar::CleanUpImages`

Libera los recursos del sistema asignados para las imágenes de la barra de herramientas.

static void CMFCToolBar::CleanUpImages();

Comentarios

El marco llama a este método cuando se cierra una aplicación.

`CMFCToolBar::CleanUpLockedImages`

Libera los recursos del sistema asignados para las imágenes de la barra de herramientas bloqueadas.

void CleanUpLockedImages();

Comentarios

Llame a este método cuando cambie el estilo visual de la aplicación. Consulte el ejemplo de VisualStudioDemo para ver cómo se usa este método.

`CMFCToolBar::CommandToIndex`

Devuelve el índice del botón de la barra de herramientas con un identificador de comando especificado.

int CommandToIndex(
    UINT nIDFind,
    int iIndexFirst=0) const;

Parámetros

nIDFind
[in] Especifica el identificador de comando.

iIndexFirst
[in] Especifica el índice inicial desde el que comenzar.

Valor devuelto

Índice de base cero del botón de la barra de herramientas si el método se ejecutó correctamente; -1 si no hay ningún botón con el identificador especificado.

Comentarios

Un objeto CMFCToolBar mantiene una lista interna de los botones de la barra de herramientas. Llame a esta función para recuperar el índice de un botón de la lista según el identificador de comando del botón.

Si iIndex es mayor que 0, este método omite cualquier botón de la barra de herramientas que tenga un índice menor que iIndex.

`CMFCToolBar::Create`

Crea un objeto CMFCToolBar.

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle=AFX_DEFAULT_TOOLBAR_STYLE,
    UINT nID=AFX_IDW_TOOLBAR);

Parámetros

pParentWnd
[in] Puntero a la ventana principal de la barra de herramientas.

dwStyle
[in] Estilo de la barra de herramientas. Consulte Estilos de botón y control de barra de herramientas en Windows SDK para ver la lista de estilos.

nID
[in] Identificador de la ventana secundaria de la barra de herramientas.

Valor devuelto

TRUE si este método se ejecuta correctamente; en caso contrario, es FALSE.

Comentarios

Este método crea una barra de control y la asocia a la barra de herramientas. Crea la barra de control con el estilo TBSTYLE_FLAT. Llame a CMFCToolBar::CreateEx si quiere un estilo de barra de control diferente.

`CMFCToolBar::CreateEx`

Crea un objeto CMFCToolBar que usa opciones de estilo adicionales, como iconos grandes.

virtual BOOL CreateEx(
    CWnd* pParentWnd,
    DWORD dwCtrlStyle=TBSTYLE_FLAT,
    DWORD dwStyle=AFX_DEFAULT_TOOLBAR_STYLE,
    CRect rcBorders=CRect(1,
    1,
    1,
    1),
    UINT nID=AFX_IDW_TOOLBAR);

Parámetros

pParentWnd
[in] Puntero a la ventana principal de la barra de herramientas.

dwCtrlStyle
[in] Estilos adicionales para crear el objeto de barra de control insertado.

dwStyle
[in] Estilo de la barra de herramientas. Consulte Estilos de botón y control de barra de herramientas para ver una lista de los estilos adecuados.

rcBorders
[in] Objeto CRect que especifica los anchos de los bordes de la ventana de la barra de herramientas.

nID
[in] Identificador de la ventana secundaria de la barra de herramientas.

Valor devuelto

Distinto de cero si el método se ejecuta correctamente; de lo contrario, 0.

Comentarios

Este método crea una barra de control y la asocia a la barra de herramientas.

Llame a este método en lugar de CMFCToolBar::Create cuando quiera proporcionar estilos específicos. Por ejemplo, establezca dwCtrlStyle en TBSTYLE_FLAT | TBSTYLE_TRANSPARENT para crear una barra de herramientas similar a las barras de herramientas que se usan en Internet Explorer 4.

Ejemplo

En el siguiente ejemplo se muestra cómo se utiliza el método CreateEx de la clase CMFCToolBar. Este fragmento de código forma parte del ejemplo de demostración de IE.

CMFCToolBar m_wndToolBar;

// The this pointer points to CMainFrame class which extends the CFrameWnd class.
if (!m_wndToolBar.CreateEx(this, TBSTYLE_TRANSPARENT) ||
    !m_wndToolBar.LoadToolBar(IDR_MAINFRAME, uiToolbarColdID, uiMenuID,
                              FALSE /* Not locked */, 0, 0, uiToolbarHotID))
{
   TRACE0("Failed to create toolbar\n");
   return -1; // fail to create
}

`CMFCToolBar::Deactivate`

Desactiva la barra de herramientas.

virtual void Deactivate();

Comentarios

Este método desactiva la barra de herramientas quitando el foco del botón de la barra de herramientas resaltado. El marco llama a este método cuando la barra de herramientas pierde el foco o se destruye.

`CMFCToolBar::DoPaint`

Vuelve a pintar una barra de herramientas.

virtual void DoPaint(CDC* pDC);

Parámetros

pDC
[in] Puntero a un contexto de dispositivo.

Comentarios

El marco llama a este método cuando se debe volver a pintar una parte de la barra de herramientas.

Invalide este método para personalizar la apariencia de un objeto derivado de CMFCToolBar.

`CMFCToolBar::DrawButton`

Vuelve a pintar un botón de la barra de herramientas.

virtual BOOL DrawButton(
    CDC* pDC,
    CMFCToolBarButton* pButton,
    CMFCToolBarImages* pImages,
    BOOL bHighlighted,
    BOOL bDrawDisabledImages);

Parámetros

pDC
[in] Puntero a un contexto de dispositivo.

pButton
[in] Puntero a un botón que se va a dibujar.

pImages
[in] Puntero a las imágenes de la barra de herramientas.

bHighlighted
[in] TRUE si el botón está resaltado; de lo contrario, FALSE.

bDrawDisabledImages
[in] TRUE si los botones deshabilitados están atenuados; de lo contrario, FALSE.

Valor devuelto

TRUE si se ha vuelto a pintar el botón; FALSE si el botón está oculto.

Comentarios

El método CMFCToolBar::DrawButton llama a este método cuando se debe volver a pintar un botón de la barra de herramientas.

Invalide este método si quiere personalizar la apariencia de los botones de la barra de herramientas.

`CMFCToolBar::DrawSeparator`

Vuelve a pintar un separador en una barra de herramientas.

virtual void DrawSeparator(
    CDC* pDC,
    const CRect& rect,
    BOOL bHorz);

Parámetros

pDC
[in] Puntero a un contexto de dispositivo.

rect
[in] Rectángulo delimitador de la ubicación donde se dibuja el separador, en píxeles.

bHorz
[in] TRUE si el separador es horizontal, FALSE si el separador es vertical.

Comentarios

CMFCToolBar::DoPaint llama a este método para cada objeto CMFCToolBar::DrawSeparator que tiene el estilo TBBS_SEPARATOR, en lugar de llamar a CMFCToolBar::DrawButton para esos botones.

Invalide este método en una clase derivada de CMFCToolBar para personalizar la apariencia de los separadores de la barra de herramientas. La implementación predeterminada llama a CMFCVisualManager::OnDrawSeparator para dibujar un separador cuya apariencia viene determinada por el administrador visual actual.

`CMFCToolBar::EnableCustomizeButton`

Habilita o deshabilita el botón Personalizar que aparece en la barra de herramientas.

void EnableCustomizeButton(
    BOOL bEnable,
    int iCustomizeCmd,
    const CString& strCustomizeText,
    BOOL bQuickCustomize=TRUE);

void EnableCustomizeButton(
    BOOL bEnable,
    int iCustomizeCmd,
    UINT uiCustomizeTextResId,
    BOOL bQuickCustomize=TRUE);

Parámetros

bEnable
[in] Habilita o deshabilita el botón Personalizar.

iCustomizeCmd
[in] Identificador de comando del botón Personalizar.

strCustomizeText
[in] Etiqueta de texto del botón Personalizar.

uiCustomizeTextResId
[in] Identificador de cadena de recursos de la etiqueta del botón Personalizar.

bQuickCustomize
[in] Habilita o deshabilita la opción Agregar o quitar botones en el menú que se despliega del botón.

Comentarios

Si iCustomizeCmd es -1, el marco muestra el botón Personalizar cuando varios botones de la barra de herramientas no caben en el área de la barra de herramientas. El botón muestra una flecha doble hacia la izquierda o un botón de contenido adicional, que indica que hay más botones.

Si iCustomizeCmd especifica un identificador de comando válido y bEnable es TRUE, siempre se muestra el botón Personalizar. El botón tiene una pequeña flecha hacia abajo y abre un menú que contiene un comando. Este comando usa la etiqueta de texto especificada por strCustomizeText. Si bQuickCustomize también es TRUE, el menú muestra la opción Agregar o quitar botones.

El marco agrega dinámicamente al menú los botones que no caben en el área de la barra de herramientas delante del elemento especificado por iCustomizeCmd. El botón de contenido adicional se muestra junto a la flecha hacia abajo.

`CMFCToolBar::EnableDocking`

Habilita el acoplamiento del panel al marco principal.

virtual void EnableDocking(DWORD dwAlignment);

Parámetros

dwAlignment
[in] Especifica la alineación de acoplamiento que se va a habilitar.

Comentarios

Este método extiende la implementación de la clase base, CBasePane::EnableDocking, estableciendo el miembro de datos CBasePane::m_dwControlBarStyle en AFX_CBRS_FLOAT. A continuación, este método pasa dwAlignment a la implementación de la clase base.

`CMFCToolBar::EnableLargeIcons`

Habilita o deshabilita iconos grandes en los botones de la barra de herramientas.

void EnableLargeIcons(BOOL bEnable);

Parámetros

bEnable
[in] TRUE para habilitar iconos grandes, FALSE para deshabilitar iconos grandes.

Comentarios

De forma predeterminada, los iconos grandes están habilitados.

`CMFCToolBar::EnableQuickCustomization`

Habilita o deshabilita la personalización rápida de las barras de herramientas para que el usuario pueda presionar la tecla Alt y arrastrar un botón a una nueva ubicación.

static void EnableQuickCustomization(BOOL bEnable=TRUE);

Parámetros

bEnable
[in] TRUE para habilitar la personalización rápida; FALSE para deshabilitar la personalización rápida.

`CMFCToolBar::EnableReflections`

Habilita o deshabilita la reflexión de comandos.

void EnableReflections(BOOL bEnable = TRUE);

Parámetros

bEnable
[in] TRUE para habilitar la reflexión de comandos; FALSE para deshabilitar la reflexión de comandos.

Comentarios

Llame a este método para habilitar la reflexión de comandos para los botones de la barra de herramientas que contienen controles insertados, como cuadros combinados.

Para más información sobre la reflexión de comandos, consulte TN062: Reflexión de mensajes para controles de Windows.

`CMFCToolBar::EnableTextLabels`

Habilita o deshabilita las etiquetas de texto en las imágenes de botón de la barra de herramientas.

void EnableTextLabels(BOOL bEnable=TRUE);

Parámetros

bEnable
TRUE si las etiquetas de texto aparecen en las imágenes del botón de la barra de herramientas; de lo contrario, FALSE.

Comentarios

Si las etiquetas de texto están habilitadas, todos los botones de la barra de herramientas se amplían para proporcionar espacio y que las etiquetas se muestren en debajo de las imágenes. El cuadro de diálogo de personalización tiene una casilla Mostrar etiqueta de texto en la página Barras de herramientas. Cuando el usuario selecciona una barra de herramientas y marca esta opción, el marco llama a EnableTextLabels para la barra de herramientas seleccionada. Puede deshabilitar la casilla de un objeto derivado de CMFCToolBar devolviendo FALSE desde CMFCToolBar::AllowChangeTextLabels.

`CMFCToolBar::FromHandlePermanent`

Recupera un puntero al objeto CMFCToolBar que contiene el identificador de ventana especificado.

static CMFCToolBar* __stdcall FromHandlePermanent(HWND hwnd);

Parámetros

hwnd
[in] Identificador de ventana que se va a buscar.

Valor devuelto

Puntero al objeto CMFCToolBar que contiene el identificador de ventana especificado o NULL si no existe ningún objeto CMFCToolBar correspondiente.

Comentarios

Este método compartido examina cada barra de herramientas de la aplicación del objeto CMFCToolBar que contiene el identificador de ventana especificado.

`CMFCToolBar::GetAllButtons`

Devuelve una lista de solo lectura de botones de una barra de herramientas.

const CObList& GetAllButtons() const;

Valor devuelto

Referencia constante a un objeto CObList Class, que contiene una colección de objetos CMFCToolBarButton Class.

`CMFCToolBar::GetAllToolbars`

Devuelve una lista de solo lectura de todas las barras de herramientas de la aplicación.

static const CObList& GetAllToolbars();

Valor devuelto

Referencia constante a un objeto CObList Class que contiene una colección de objetos CMFCToolBar.

`CMFCToolBar::GetBasicCommands`

Devuelve una lista de solo lectura de los comandos básicos definidos en la aplicación.

static const CList<UINT,UINT>& GetBasicCommands();

Valor devuelto

Referencia constante a un objeto CList Class que contiene una colección de comandos básicos.

Comentarios

Agregue comandos básicos mediante una llamada a CMFCToolBar::AddBasicCommand o CMFCToolBar::SetBasicCommands.

`CMFCToolBar::GetButton`

Devuelve un puntero al objeto CMFCToolBarButton Class en un índice especificado.

CMFCToolBarButton* GetButton(int iIndex) const;

Parámetros

iIndex
[in] Especifica el índice del botón que se va a devolver.

Valor devuelto

Puntero al botón de la barra de herramientas si existe; o NULL si no existe tal botón.

`CMFCToolBar::GetButtonInfo`

Devuelve el identificador de comando, el estilo y el índice de imagen del botón en un índice especificado.

void GetButtonInfo(
    int nIndex,
    UINT& nID,
    UINT& nStyle,
    int& iImage) const;

Parámetros

nIndex
[in] Especifica el índice del botón en la lista de botones de la barra de herramientas.

nID
[out] Identificador de comando de un botón.

nStyle
[out] Estilo del botón.

iImage
[out] Índice de la imagen del botón.

Comentarios

El método GetButtonInfo busca un botón de barra de herramientas en el índice especificado y recupera el identificador de comando, el estilo y el índice de imagen del botón.

Si el botón del índice especificado no existe, el marco establece nID y nStyle en 0 y iImage en -1 cuando el método devuelve resultados.

`CMFCToolBar::GetButtonSize`

Devuelve las dimensiones de cada botón de la barra de herramientas.

CSize GetButtonSize() const;

Valor devuelto

Objeto CSize Class que especifica las dimensiones de cada botón de la barra de herramientas.

Comentarios

Llame a CMFCToolBar::SetSizes o CMFCToolBar::SetLockedSizes para establecer 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.

UINT GetButtonStyle(int nIndex) const;

Parámetros

nIndex
[in] Especifica el índice de un botón de barra de herramientas.

Valor devuelto

Valor que especifica el estilo del botón de la barra de herramientas. . Consulte Estilos de control ToolBar para ver una lista de los posibles estilos.

Comentarios

Llame a CMFCToolBar::SetButtonStyle para establecer el estilo de un botón de la barra de herramientas

`CMFCToolBar::GetButtonText`

Devuelve la etiqueta de texto de un botón que tiene un índice especificado.

CString GetButtonText(int nIndex) const;

void GetButtonText(
    int nIndex,
    CString& rString) const;

`CMFCToolBar::GetCommandButtons`

Devuelve una lista de botones que tienen un identificador de comando especificado de todas las barras de herramientas de la aplicación.

static int GetCommandButtons(
    UINT uiCmd,
    CObList& listButtons);

Parámetros

uiCmd
[in] Identificador de comando de los botones.

listButtons
[out] Referencia a un objeto CObList Class que recibe la lista de botones de la barra de herramientas.

Valor devuelto

Número de botones que tienen el identificador de comando especificado.

`CMFCToolBar::GetCount`

Devuelve el número de botones y separadores de la barra de herramientas.

int GetCount() const;

Valor devuelto

Número de botones y separadores de la barra de herramientas.

`CMFCToolBar::GetCustomizeButton`

Recupera un puntero al objeto CMFCCustomizeButton asociado a la barra de herramientas.

CMFCCustomizeButton* GetCustomizeButton();

Valor devuelto

Puntero al objeto CMFCCustomizeButton asociado a la barra de herramientas.

Comentarios

Este método recupera el botón Personalizar que aparece al final de la barra de herramientas. Use el método CMFCToolBar::EnableCustomizeButton para agregar el botón Personalizar a la barra de herramientas.

Puede llamar al método CMFCToolBar::IsExistCustomizeButton para determinar si la barra de herramientas contiene un objeto CMFCCustomizeButton válido.

`CMFCToolBar::GetDefaultImage`

Devuelve el índice de la imagen predeterminada de un botón de la barra de herramientas con un identificador de comando especificado.

static int GetDefaultImage(UINT uiID);

Parámetros

BOOL GetIgnoreSetText() const;

Valor devuelto

TRUE si se omiten las llamadas para establecer etiquetas de botón; de lo contrario, FALSE.

Comentarios

`CMFCToolBar::GetImages`

Devuelve un puntero a la colección de imágenes de botón predeterminadas en la aplicación.

static CMFCToolBarImages* GetImages();

Valor devuelto

Puntero al objeto CMFCToolBarImages Class que contiene la colección de imágenes predeterminadas para todas las barras de herramientas de la aplicación.

Comentarios

Este método compartido proporciona acceso a la colección de todas las imágenes de barra de herramientas predeterminadas para la aplicación. Llama al método CMFCToolBar::LoadBitmap para agregar imágenes a la colección.

`CMFCToolBar::GetImageSize`

Devuelve el tamaño actual de las imágenes de botón de la barra de herramientas.

CSize GetImageSize() const;

Valor devuelto

Objeto CSize Class que representa el tamaño actual de las imágenes de botón de la barra de herramientas.

`CMFCToolBar::GetImagesOffset`

Devuelve el desplazamiento de índice usado para buscar las imágenes de botón de la barra de herramientas de esta barra de herramientas en la lista global de imágenes de botón de barra de herramientas.

int GetImagesOffset() const;

Valor devuelto

Desplazamiento de índice de las imágenes de la barra de herramientas.

Comentarios

Todas las imágenes predeterminadas de la barra de herramientas se almacenan en la lista de CMFCToolBarImages Class global. Las imágenes de cada botón de la barra de herramientas se almacenan consecutivamente en esa lista. Para calcular el índice de la imagen, agregue el índice del botón de la barra de herramientas al desplazamiento del principio de la lista de imágenes para ese botón.

Llame a CMFCToolBar::ButtonToIndex para obtener el índice de un botón de barra de herramientas dado un puntero al botón.

Llame a CMFCToolBar::GetImages para obtener un puntero a la colección de imágenes de la barra de herramientas.

`CMFCToolBar::GetInvalidateItemRect`

Recupera la región del área cliente que se debe volver a dibujar para el botón en el índice especificado.

virtual void GetInvalidateItemRect(
    int nIndex,
    LPRECT lpRect) const;

Parámetros

nIndex
[in] Índice del botón para el que se va a recuperar el área cliente.

lpRect
[out] Puntero a un objeto RECT que recibe la región del área cliente.

Comentarios

El parámetro lpRect no debe ser NULL. Si no existe ningún botón en el índice proporcionado, lpRect recibe un objeto RECT que se inicializa en cero.

`CMFCToolBar::GetItemID`

Devuelve el identificador de comando del botón de la barra de herramientas en un índice especificado.

UINT GetItemID(int nIndex) const;

Parámetros

nIndex
[in] Especifica el índice del botón de la barra de herramientas.

Valor devuelto

Identificador de comando del botón de la barra de herramientas; o cero si el botón con el índice especificado no existe.

`CMFCToolBar::GetItemRect`

Devuelve el rectángulo delimitador del botón en un índice especificado.

virtual void GetItemRect(
    int nIndex,
    LPRECT lpRect) const;

Parámetros

nIndex
[in] Especifica el índice de un botón de barra de herramientas.

lpRect
[out] Puntero al objeto CRect que recibe las coordenadas del rectángulo delimitador de la imagen.

Comentarios

El objeto CRect al que apunta lpRect se establece en 0 si no existe un botón en el índice especificado.

Ejemplo

En el siguiente ejemplo se muestra cómo se utiliza el método GetItemRect de la clase CMFCToolBar. Este fragmento de código forma parte del ejemplo de demostración de IE.

CMFCToolBar m_wndToolBar;

CRect rectToolBar;
m_wndToolBar.GetItemRect(0, &rectToolBar);

`CMFCToolBar::GetLargeColdImages`

Devuelve un puntero a la colección de imágenes de botón de barra de herramientas inactivas grandes en la aplicación.

static CMFCToolBarImages* GetLargeColdImages();

Valor devuelto

Puntero a la colección de imágenes en inactivas grandes.

Comentarios

Las imágenes inactivas son las imágenes que se usan cuando el usuario no interactúa con los botones de la barra de herramientas. Llame a CMFCToolBar::LoadBitmapEx para cargar las imágenes inactivas grandes.

`CMFCToolBar::GetLargeDisabledImages`

Devuelve un puntero a la colección de imágenes de botón de barra de herramientas deshabilitadas grandes de la aplicación.

static CMFCToolBarImages* GetLargeDisabledImages();

Valor devuelto

Puntero a la colección de imágenes de botón de la barra de herramientas deshabilitadas grandes.

Comentarios

Las imágenes grandes son versiones grandes de las imágenes de botón de la barra de herramientas normales. Llame a CMFCToolBar::LoadBitmapEx o CMFCToolBar::LoadBitmap para cargar las imágenes grandes.

`CMFCToolBar::GetLargeImages`

Devuelve un puntero a la colección de imágenes de botón de barra de herramientas grande de la aplicación.

static CMFCToolBarImages* GetLargeImages();

Valor devuelto

Puntero a la colección de imágenes de botón de barra de herramientas grandes.

Comentarios

Las imágenes grandes son versiones grandes de las imágenes de botón de la barra de herramientas normales. Llame a CMFCToolBar::LoadBitmapEx para cargar las imágenes grandes.

`CMFCToolBar::GetLockedColdImages`

Devuelve un puntero a la colección de imágenes inactivas bloqueadas de la barra de herramientas.

CMFCToolBarImages* GetLockedColdImages();

Valor devuelto

Puntero a la colección de imágenes inactivas bloqueadas o NULL si la barra de herramientas no está bloqueada.

Comentarios

Las imágenes bloqueadas son versiones de las imágenes de botón de barra de herramientas normales que usa el marco cuando el usuario no puede personalizar la barra de herramientas. Las imágenes inactivas son las imágenes que se usan cuando el usuario no interactúa con los botones de la barra de herramientas.

Este método devuelve NULL si la barra de herramientas no está bloqueada. Este método también genera un error de aserción en compilaciones de depuración si la barra de herramientas no está bloqueada. Para más información sobre las barras de herramientas bloqueadas, consulte CMFCToolBar::IsLocked.

Llame al método CMFCToolBar::LoadBitmapEx para cargar las imágenes inactivas bloqueadas.

`CMFCToolBar::GetLockedDisabledImages`

Devuelve un puntero a la colección de imágenes deshabilitadas bloqueadas de la barra de herramientas.

CMFCToolBarImages* GetLockedDisabledImages();

Valor devuelto

Puntero a la colección de imágenes deshabilitadas bloqueadas o NULL si la barra de herramientas no está bloqueada.

Comentarios

Las imágenes bloqueadas son versiones de las imágenes de botón de barra de herramientas normales que usa el marco cuando el usuario no puede personalizar la barra de herramientas. Las imágenes deshabilitadas son las imágenes que usa el marco cuando un botón tiene el estilo TBBS_DISABLED.

Llame al método CMFCToolBar::LoadBitmapEx para cargar las imágenes deshabilitadas bloqueadas.

`CMFCToolBar::GetLockedImages`

Devuelve un puntero a la colección de imágenes de botón bloqueadas de la barra de herramientas.

CMFCToolBarImages* GetLockedImages();

Valor devuelto

Puntero a la colección de imágenes de botón de barra de herramientas bloqueadas o NULL si la barra de herramientas no está bloqueada.

Comentarios

Las imágenes bloqueadas son versiones de las imágenes de botón de barra de herramientas normales que usa el marco cuando el usuario no puede personalizar la barra de herramientas.

`CMFCToolBar::GetLockedImageSize`

Devuelve el tamaño predeterminado de las imágenes de barra de herramientas bloqueada.

CSize GetLockedImageSize() const;

Valor devuelto

Estructura CSize que especifica el tamaño de las imágenes de barra de herramientas bloqueadas o una estructura CSize vacía si la barra de herramientas no está bloqueada.

Comentarios

Las imágenes bloqueadas son versiones de las imágenes de botón de barra de herramientas normales que usa el marco cuando el usuario no puede personalizar la barra de herramientas.

Este método devuelve una estructura CSize con ancho cero y un alto cero si la barra de herramientas no está bloqueada. Este método también genera un error de aserción en compilaciones de depuración si la barra de herramientas no está bloqueada. Para más información sobre las barras de herramientas bloqueadas, consulte CMFCToolBar::IsLocked.

Llame al método CMFCToolBar::SetLockedSizes para especificar el tamaño de la imagen bloqueada.

`CMFCToolBar::GetLockedMenuImages`

Devuelve un puntero a la colección de imágenes de menú de la barra de herramientas bloqueadas de la barra de herramientas.

CMFCToolBarImages* GetLockedMenuImages();

Valor devuelto

Puntero a la colección de imágenes de menú de barra de herramientas bloqueadas o NULL si la barra de herramientas no está bloqueada.

Comentarios

Las imágenes bloqueadas son versiones de las imágenes de menú de barra de herramientas normales que usa el marco cuando el usuario no puede personalizar la barra de herramientas.

Llame al método CMFCToolBar::LoadBitmapEx para cargar las imágenes de menú bloqueadas.

`CMFCToolBar::GetMenuButtonSize`

Devuelve el tamaño de los botones de menú de la aplicación.

static CSize GetMenuButtonSize();

Valor devuelto

Objeto CSize que representa el tamaño de los botones de menú, en píxeles.

Comentarios

El tamaño de los botones de menú de las barras de herramientas se mantiene como una variable global y este método estático puede recuperarlo.

Llame a CMFCToolBar::SetMenuSizes para establecer esta variable global.

`CMFCToolBar::GetMenuImages`

Devuelve un puntero a la colección de imágenes de botón de menú de la aplicación.

static CMFCToolBarImages* GetMenuImages();

Valor devuelto

Puntero a la colección de imágenes de menú.

Comentarios

Llame al método CMFCToolBar::LoadBitmapEx para cargar las imágenes de menú.

Llame al método CMFCToolBar::SetMenuSizes para establecer el tamaño de los botones y sus imágenes.

`CMFCToolBar::GetMenuImageSize`

Devuelve el tamaño de las imágenes de botón de menú de la aplicación.

static CSize GetMenuImageSize();

Valor devuelto

Objeto CSize que representa el tamaño de las imágenes de menú.

Comentarios

Este método devuelve el tamaño de las imágenes de los botones de menú de la barra de herramientas que se mantienen como una variable global. Llame a CMFCToolBar::SetMenuSizes para establecer esta variable global.

`CMFCToolBar::GetOrigButtons`

Recupera la colección de botones no personalizados de la barra de herramientas.

const CObList& GetOrigButtons() const;

Valor devuelto

Referencia a la lista de botones no personalizados de la barra de herramientas.

Comentarios

El marco crea una copia de los botones de la barra de herramientas antes de personalizarlos el usuario. El método CMFCToolBar::SetButtons agrega una copia de cada botón de la matriz proporcionada a la lista de botones originales. El método CMFCToolBar::RestoreOriginalState restaura el estado original de la barra de herramientas cargándola desde el archivo de recursos.

Para establecer la lista de botones originales de la barra de herramientas, llame al método CMFCToolBar::SetOrigButtons.

`CMFCToolBar::GetOrigResetButtons`

Recupera la colección de botones de restablecimiento no personalizados de la barra de herramientas.

const CObList& GetOrigResetButtons() const;

Valor devuelto

Referencia a la lista de botones de restablecimiento no personalizados de la barra de herramientas.

Comentarios

Cuando el usuario selecciona el botón Restablecer durante el modo de personalización, el marco usa este método para restaurar botones que se quitaron de la barra de herramientas.

El método CMFCToolBar::SetButtons agrega una copia de cada botón de barra de herramientas a la lista de botones de restablecimiento originales después de llamar al método CMFCToolBar::OnReset. Puede invalidar el método CMFCToolBar::OnReset para personalizar la apariencia de los botones después de que el usuario presiona el botón Restablecer.

`CMFCToolBar::GetResourceID`

Recupera el identificador de recurso de la barra de herramientas.

UINT GetResourceID() const;

Valor devuelto

[in] Identificador de recurso de la barra de herramientas.

Comentarios

Llame al método CMFCToolBar::LoadToolBarEx para establecer el identificador de recurso de la barra de herramientas.

`CMFCToolBar::GetRouteCommandsViaFrame`

Determina qué objeto, el marco principal o el propietario, envía comandos a la barra de herramientas.

BOOL GetRouteCommandsViaFrame();

Valor devuelto

Distinto de cero si el marco principal envía comandos a la barra de herramientas; 0 si el propietario envía comandos a la barra de herramientas.

Comentarios

De forma predeterminada, el marco principal envía comandos a la barra de herramientas. Llame a CMFCToolBar::SetRouteCommandsViaFrame para cambiar este comportamiento.

Si este método devuelve un valor distinto de cero, puede recuperar un puntero al objeto de marco principal mediante el método CMFCToolBar::GetCommandTarget. Consulte el ejemplo de VisualStudioDemo para ver cómo se usa este método.

`CMFCToolBar::GetRowHeight`

Devuelve el alto de los botones de la barra de herramientas.

virtual int GetRowHeight() const;

Valor devuelto

Alto de los botones de la barra de herramientas, en píxeles.

Comentarios

El marco llama a este método para calcular el diseño de la barra de herramientas. Invalide este método en una clase derivada para especificar un alto diferente para la barra de herramientas.

`CMFCToolBar::GetShowTooltips`

Especifica si se mostrarán sugerencias de herramientas para los botones de la barra de herramientas.

static BOOL GetShowTooltips();

Valor devuelto

TRUE si se muestra información sobre herramientas para los botones de la barra de herramientas; de lo contrario, FALSE.

Comentarios

Se muestra información sobre herramientas de forma predeterminada. Puede cambiar esta marca estática llamando a CMFCToolBar::SetShowTooltips.

`CMFCToolBar::GetSiblingToolBar`

Recupera el elemento del mismo nivel de la barra de herramientas.

CMFCToolBar* GetSiblingToolBar();

Valor devuelto

Puntero a la barra de herramientas del mismo nivel.

Comentarios

Para más información sobre cómo habilitar los botones Mostrar botones en una fila y Mostrar botones en dos filas, consulte CMFCToolBar::SetSiblingToolBar.

`CMFCToolBar::GetUserImages`

Devuelve un puntero a la colección de imágenes de botón de barra de herramientas definidas por el usuario de la aplicación.

static CMFCToolBarImages* GetUserImages();

Valor devuelto

Puntero a la colección de imágenes de botón de barra de herramientas definidas por el usuario para todas las barras de herramientas de la aplicación.

Comentarios

Llame al método CMFCToolBar::SetUserImages para establecer la colección de imágenes definidas por el usuario de la aplicación.

`CMFCToolBar::HitTest`

Devuelve el índice del botón de la barra de herramientas que se encuentra en la posición especificada.

virtual int HitTest(CPoint point);

Parámetros

point
[in] Punto que se va a probar, en coordenadas de cliente.

Valor devuelto

Índice del botón que se encuentra en la posición especificada, o -1 si no hay ningún botón de este tipo o el botón es un separador.

`CMFCToolBar::InsertButton`

Inserta un botón en la barra de herramientas.

virtual int InsertButton(
    const CMFCToolBarButton& button,
    INT_PTR iInsertAt=-1);

virtual int InsertButton(
    CMFCToolBarButton* pButton,
    int iInsertAt=-1);

Parámetros

button
[in] Especifica el botón que se va a insertar.

iInsertAt
[in] Especifica la posición de base cero en la que se va a insertar el botón.

Valor devuelto

Posición en la que se insertó el botón o -1 si se produce un error.

Comentarios

Si iInsertAt es -1, este método agrega el botón al final de la lista de botones de la barra de herramientas.

Llame al método CMFCToolBar::InsertSeparator para insertar un separador en la barra de herramientas.

`CMFCToolBar::InsertSeparator`

Inserta un separador en la barra de herramientas.

virtual int InsertSeparator(INT_PTR iInsertAt=-1);

Parámetros

iInsertAt
[in] Especifica la posición de base cero en la que se va a insertar el separador. Este parámetro debe ser mayor que 0.

Valor devuelto

Posición en la que se insertó el separador o -1 si se produce un error.

Comentarios

Llame a este método para insertar un separador entre dos botones existentes. Si iInsertAt es -1, este método agrega el separador al final de la lista de botones de la barra de herramientas.

No puede usar este método para agregar un separador a una barra de herramientas vacía.

Llame al método CMFCToolBar::InsertButton para insertar un botón en la barra de herramientas.

`CMFCToolBar::InvalidateButton`

Invalida el área cliente del botón de la barra de herramientas que existe en el índice proporcionado.

CMFCToolBarButton* InvalidateButton(int nIndex);

Parámetros

nIndex
[in] Índice de base cero del botón de la barra de herramientas.

Valor devuelto

Puntero al objeto CMFCToolBarButton que existe en el índice proporcionado o NULL si no existe dicho objeto.

Comentarios

El marco llama a este método cuando actualiza el área cliente asociada a un botón de la barra de herramientas. Llama al método CWnd::InvalidateRect con el rectángulo de cliente del objeto CMFCToolBarButton que existe en el índice proporcionado.

`CMFCToolBar::IsAddRemoveQuickCustomize`

Determina si un usuario puede agregar o quitar botones de la barra de herramientas mediante la opción de menú Personalizar.

BOOL IsAddRemoveQuickCustomize();

Valor devuelto

TRUE si un usuario puede usar la opción de menú Personalizar para modificar la barra de herramientas; de lo contrario, FALSE.

Comentarios

`CMFCToolBar::IsAltCustomizeMode`

Especifica si se usa la personalización rápida para arrastrar un botón. Cuando se habilita la personalización rápida, un usuario puede presionar y mantener presionada la tecla Alt y arrastrar un botón a una nueva ubicación.

static BOOL __stdcall IsAltCustomizeMode();

Valor devuelto

TRUE si se usa la personalización rápida para arrastrar un botón; de lo contrario, FALSE.

Comentarios

`CMFCToolBar::IsAutoGrayInactiveImages`

Especifica si la generación automática de imágenes de botón inactivas (no resaltadas) está habilitada.

static BOOL IsAutoGrayInactiveImages();

Valor devuelto

TRUE si la opción para atenuar automáticamente las imágenes inactivas está habilitada; de lo contrario, FALSE.

Comentarios

Puede habilitar o deshabilitar la atenuación automática de imágenes inactivas mediante una llamada a CMFCToolBar::AutoGrayInactiveImages.

`CMFCToolBar::IsBasicCommand`

Determina si un comando está en la lista de comandos básicos.

static BOOL IsBasicCommand(UINT uiCmd);

Parámetros

uiCmd
[in] Especifica el comando que se va a comprobar.

Valor devuelto

TRUE si el comando especificado pertenece a la lista de comandos básicos; de lo contrario, FALSE.

Comentarios

Este método estático determina si el comando especificado por uiCmd pertenece a la lista global de comandos básicos. Puede cambiar la lista de comandos básicos llamando a CMFCToolBar::AddBasicCommand o CMFCToolBar::SetBasicCommands.

`CMFCToolBar::IsButtonExtraSizeAvailable`

Determina si la barra de herramientas puede mostrar botones que tienen bordes extendidos.

virtual BOOL IsButtonExtraSizeAvailable() const;

Valor devuelto

TRUE si la barra puede mostrar botones con el tamaño de borde adicional; de lo contrario, FALSE.

Comentarios

El objeto de barra de herramientas devuelve TRUE si puede mostrar botones que tienen bordes extendidos. Un botón de barra de herramientas llama a este método cuando controla la notificación CMFCToolBarButton::OnChangeParentWnd y establecerá su marca de tamaño de borde adicional interna en consecuencia. Esta marca interna se puede recuperar más adelante llamando a CMFCToolBarButton::IsExtraSize.

Invalide este método en una clase derivada de CMFCToolBar y devuelva TRUE si la barra puede mostrar los botones de la barra de herramientas con el tamaño de borde adicional; de lo contrario, devuelva FALSE. La implementación predeterminada devuelve TRUE.

`CMFCToolBar::IsButtonHighlighted`

Determina si el botón especificado está resaltado.

BOOL IsButtonHighlighted(int iButton) const;

Parámetros

iButton
[in] Especifica el índice de un botón de barra de herramientas.

Valor devuelto

TRUE si el botón está resaltado; de lo contrario, FALSE.

Comentarios

`CMFCToolBar::IsCommandPermitted`

Determina si se permite un comando.

static BOOL IsCommandPermitted(UINT uiCmd);

Parámetros

uiCmd
[in] Especifica el comando que se va a comprobar.

Valor devuelto

TRUE si se permite el comando especificado; de lo contrario, FALSE.

Comentarios

Este método estático determina si el comando especificado por uiCmd pertenece a la lista global de comandos no permitidos.

Puede cambiar la lista de comandos no permitidos llamando a CMFCToolBar::SetNonPermittedCommands.

`CMFCToolBar::IsCommandRarelyUsed`

Determina si un comando se usa con poca frecuencia.

static BOOL IsCommandRarelyUsed(UINT uiCmd);

Parámetros

uiCmd
[in] Especifica el comando que se va a comprobar.

Valor devuelto

TRUE si apenas se usa el comando especificado; de lo contrario, FALSE.

Comentarios

El método IsCommandRarelyUsed devuelve FALSE cuando se dan una o varias de las condiciones siguientes:

El comando especificado pertenece a la lista de comandos básicos.
El comando especificado es uno de los comandos estándar.
El marco está en modo de personalización.
La lista de comandos básicos está vacía.
Más del 20 % de las llamadas a comandos son llamadas al comando especificado.

`CMFCToolBar::IsCustomizeMode`

Especifica si el marco de la barra de herramientas está en modo de personalización.

static BOOL IsCustomizeMode();

Valor devuelto

TRUE si el marco está en modo de personalización; de lo contrario, FALSE.

Comentarios

Puede alternar el modo de personalización llamando a CMFCToolBar::SetCustomizeMode.

El marco cambia el modo cuando el usuario invoca el cuadro de diálogo de personalización ( CMFCToolBarsCustomizeDialog Class).

`CMFCToolBar::IsDragButton`

Determina si se arrastra un botón de la barra de herramientas.

BOOL IsDragButton(const CMFCToolBarButton* pButton) const;

Parámetros

pButton
[in] Puntero a un botón de la barra de herramientas.

Valor devuelto

TRUE si se arrastra el botón especificado; de lo contrario, FALSE.

Comentarios

`CMFCToolBar::IsExistCustomizeButton`

Determina si la barra de herramientas contiene el botón Personalizar.

BOOL IsExistCustomizeButton();

Valor devuelto

TRUE si la barra de herramientas contiene el botón Personalizar; de lo contrario, FALSE.

Comentarios

Si este método devuelve TRUE, el método CMFCToolBar::GetCustomizeButton devuelve un puntero al botón Personalizar que aparece al final de la barra de herramientas.

Use el método CMFCToolBar::EnableCustomizeButton para agregar el botón Personalizar a la barra de herramientas.

`CMFCToolBar::IsFloating`

Determina si la barra de herramientas es flotante.

virtual BOOL IsFloating() const;

Valor devuelto

TRUE si la barra de herramientas es flotante; de lo contrario, FALSE.

`CMFCToolBar::IsLargeIcons`

Especifica si las barras de herramientas de la aplicación muestran actualmente iconos grandes.

static BOOL IsLargeIcons();

Valor devuelto

TRUE si la aplicación usa iconos grandes; de lo contrario, FALSE.

Comentarios

Llame a CMFCToolBar::SetLargeIcons para alternar entre iconos grandes e iconos normales.

El marco cambia automáticamente el modo cuando el usuario alterna la casilla Iconos grandes de la página Opciones del cuadro de diálogo Personalización.

`CMFCToolBar::IsLastCommandFromButton`

Determina si el comando ejecutado más recientemente se envió desde el botón de la barra de herramientas especificado.

static BOOL IsLastCommandFromButton(CMFCToolBarButton* pButton);

Parámetros

pButton
[in] Puntero al botón.

Valor devuelto

TRUE si se envió el último comando desde el botón que especifica pButton; de lo contrario, FALSE.

Comentarios

Este método obtiene un puntero a una MSG estructura mediante una llamada a CWnd::GetCurrentMessage. A continuación, compara el valor HWND del botón con los miembros MSG::lParam y MSG::hwnd para determinar si el botón era el origen del comando.

`CMFCToolBar::IsLocked`

Determina si la barra de herramientas está bloqueada.

BOOL IsLocked() const;

Valor devuelto

TRUE si la barra de herramientas está bloqueada; de lo contrario, FALSE.

Comentarios

Este método devuelve TRUE cuando el usuario no puede realizar tareas de personalización, como cambiar la posición de los botones de la barra de herramientas.

Las barras de herramientas bloqueadas usan listas de imágenes distintas. Para más información sobre estas listas de imágenes, consulte CMFCToolBar::LoadBitmapEx.

`CMFCToolBar::IsOneRowWithSibling`

Determina si la barra de herramientas y su barra de herramientas del mismo nivel están colocados en la misma fila.

BOOL IsOneRowWithSibling();

Valor devuelto

TRUE si la barra de herramientas y sus elementos del mismo nivel están colocados en la misma fila; de lo contrario, FALSE.

Comentarios

El método CMFCCustomizeButton::CreatePopupMenu llama a este método para determinar cómo mostrar el menú emergente Personalizar. Si este método devuelve TRUE, el marco muestra el botón Mostrar botones en una fila. De lo contrario, el marco muestra el botón Mostrar botones en dos filas.

Normalmente no tiene que utilizar este método. Para habilitar los botones Mostrar botones en una fila o Mostrar botones en dos filas, llame a CMFCToolBar::SetSiblingToolBar.

`CMFCToolBar::IsResourceChanged`

virtual BOOL IsResourceChanged() const;

Valor devuelto

Comentarios

`CMFCToolBar::IsSibling`

BOOL IsSibling();

Valor devuelto

Comentarios

`CMFCToolBar::IsUserDefined`

Especifica si la barra de herramientas está definida por el usuario.

BOOL IsUserDefined() const;

Valor devuelto

TRUE es si el usuario ha creado la barra de herramientas; de lo contrario, FALSE.

`CMFCToolBar::LoadBitmap`

Carga las imágenes de la barra de herramientas desde los recursos de la aplicación.

virtual BOOL LoadBitmap(
    UINT uiResID,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    BOOL bLocked=FALSE,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0);

Parámetros

uiResID
[in] El identificador de recurso del mapa de bits que hace referencia a las imágenes de barra de herramientas activas.

uiColdResID
[in] El identificador de recurso del mapa de bits que hace referencia a las imágenes de barra de herramientas inactivas.

uiMenuResID
[in] Identificador de recurso del mapa de bits que hace referencia a las imágenes de menú normales.

bLocked
[in] TRUE para bloquear la barra de herramientas; en caso contrario, FALSE.

uiDisabledResID
[in] El identificador de recurso del mapa de bits que hace referencia a las imágenes de barra de herramientas deshabilitadas.

uiMenuDisabledResID
[in] El identificador de recurso del mapa de bits que hace referencia a las imágenes de menú deshabilitadas.

Valor devuelto

Distinto de cero si el método es correcto; de lo contrario, 0.

Comentarios

El método CMFCToolBar::LoadToolBarEx llama a este método para cargar las imágenes asociadas a la barra de herramientas. Invalide este método para realizar la carga personalizada de recursos de imagen.

Llame al método LoadBitmapEx para cargar imágenes adicionales después de crear la barra de herramientas.

`CMFCToolBar::LoadBitmapEx`

virtual BOOL LoadBitmapEx(
    CMFCToolBarInfo& params,
    BOOL bLocked = FALSE);

Parámetros

[in] params
[in] bLocked\

Valor devuelto

Comentarios

`CMFCToolBar::LoadLargeIconsState`

static BOOL __stdcall LoadLargeIconsState(LPCTSTR lpszProfileName = NULL);

Parámetros

[in] lpszProfileName\

Valor devuelto

Comentarios

`CMFCToolBar::LoadParameters`

Carga las opciones globales de la barra de herramientas desde el Registro de Windows.

static BOOL LoadParameters(LPCTSTR lpszProfileName=NULL);

Parámetros

lpszProfileName
[in] Especifica la ruta de acceso relativa de la clave del Registro de Windows.

Valor devuelto

Distinto de cero si el método es correcto; de lo contrario, 0.

Comentarios

Este método carga parámetros globales, como el tipo de animación del menú, el estilo de sombra del menú y si se mostrarán iconos grandes del Registro de Windows.

El método CWinAppEx::LoadState llama a este método como parte del proceso de inicialización de la aplicación.

`CMFCToolBar::LoadState`

Carga la información de estado de la barra de herramientas desde el Registro de Windows.

virtual BOOL LoadState(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

Parámetros

lpszProfileName
[in] Especifica la ruta de acceso relativa de la clave del Registro de Windows.

nIndex
[in] Especifica el identificador de control de la barra de herramientas.

uiID
[in] Especifica el identificador de recurso de la barra de herramientas.

Valor devuelto

Distinto de cero si el método es correcto; de lo contrario, 0.

Comentarios

El marco llama a este método como parte del proceso de inicialización de la aplicación. Para obtener más información, vea CWinAppEx::LoadState.

`CMFCToolBar::LoadToolBar`

Carga la barra de herramientas desde los recursos de la aplicación.

virtual BOOL LoadToolBar(
    UINT uiResID,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    BOOL bLocked=FALSE,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0,
    UINT uiHotResID=0);

Parámetros

uiResID
[in] Identificador de recurso de la barra de herramientas.

uiColdResID
[in] El identificador de recurso del mapa de bits que hace referencia a las imágenes de barra de herramientas inactivas.

uiMenuResID
[in] Identificador de recurso del mapa de bits que hace referencia a las imágenes de menú normales.

bLocked
[in] Valor booleano que especifica si la barra de herramientas está bloqueada o no. Si este parámetro es TRUE, la barra de herramientas está bloqueada. De lo contrario, la barra de herramientas no está bloqueada.

uiDisabledResID
[in] El identificador de recurso del mapa de bits que hace referencia a las imágenes de barra de herramientas deshabilitadas.

uiMenuDisabledResID
[in] El identificador de recurso del mapa de bits que hace referencia a las imágenes de menú deshabilitadas.

uiHotResID
[in] El identificador de recurso del mapa de bits que hace referencia a las imágenes de barra de herramientas activas.

Valor devuelto

Distinto de cero si el método es correcto; de lo contrario, 0.

Comentarios

El marco llama a este método durante la inicialización para cargar las imágenes asociadas a la barra de herramientas.

Ejemplo

El siguiente ejemplo muestra cómo se usa el método LoadToolBar de la clase CMFCToolBar. Este fragmento de código forma parte del ejemplo de demostración de IE.

CMFCToolBar m_wndToolBar;

// The this pointer points to CMainFrame class which extends the CFrameWnd class.
if (!m_wndToolBar.CreateEx(this, TBSTYLE_TRANSPARENT) ||
    !m_wndToolBar.LoadToolBar(IDR_MAINFRAME, uiToolbarColdID, uiMenuID,
                              FALSE /* Not locked */, 0, 0, uiToolbarHotID))
{
   TRACE0("Failed to create toolbar\n");
   return -1; // fail to create
}

`CMFCToolBar::LoadToolBarEx`

Carga la barra de herramientas desde los recursos de la aplicación mediante la clase auxiliar CMFCToolBarInfo para permitir que la aplicación use imágenes grandes.

virtual BOOL LoadToolBarEx(
    UINT uiToolbarResID,
    CMFCToolBarInfo& params,
    BOOL bLocked=FALSE);

Parámetros

uiToolbarResID
[in] Identificador de recurso de la barra de herramientas.

params
[in] Referencia a un objeto CMFCToolBarInfo que contiene los identificadores de recurso de las imágenes de barra de herramientas.

bLocked
[in] Valor booleano que especifica si la barra de herramientas está bloqueada o no. Si este parámetro es TRUE, la barra de herramientas está bloqueada. De lo contrario, la barra de herramientas no está bloqueada.

Valor devuelto

Distinto de cero si el método es correcto; de lo contrario, 0.

Comentarios

Llame a este método para cargar imágenes de barra de herramientas desde los recursos de la aplicación.

`CMFCToolBar::m_dblLargeImageRatio`

Especifica la relación entre la dimensión (alto o ancho) de imágenes grandes y la dimensión de imágenes normales.

AFX_IMPORT_DATA static double m_dblLargeImageRatio;

Comentarios

La relación predeterminada es 2. Puede cambiar este valor para agrandar o reducir las imágenes de barra de herramientas grandes.

El marco usa este miembro de datos cuando no se especifica un conjunto de imágenes grandes. Por ejemplo, si proporciona solo el conjunto de imágenes pequeñas con un tamaño de 16 x 16 y quiere que las imágenes grandes tengan el tamaño 24 x 24, establezca este miembro de datos en 1,5.

`CMFCToolBar::NextMenu`

virtual BOOL NextMenu();

Valor devuelto

Comentarios

`CMFCToolBar::OnBeforeRemoveButton`

virtual BOOL OnBeforeRemoveButton(
    CMFCToolBarButton* pButton,
    DROPEFFECT dropEffect);

Parámetros

pButton
[in] Sin utilizar.

dropEffect
[in] Sin utilizar.

Valor devuelto

Comentarios

`CMFCToolBar::OnChangeHot`

Lo llama el marco cuando un usuario selecciona un botón en la barra de herramientas.

virtual void OnChangeHot(int iHot);

Parámetros

iHot
[in] Especifica el índice del botón de la barra de herramientas seleccionado; o -1 si no hay ningún botón de barra de herramientas seleccionado.

Comentarios

Invalide este método para procesar las notificaciones de que el usuario seleccionó un botón de una barra de herramientas.

`CMFCToolBar::OnChangeVisualManager`

virtual void OnChangeVisualManager();

Comentarios

`CMFCToolBar::OnFillBackground`

Lo llama el marco desde CBasePane::DoPaint para rellenar el fondo de la barra de herramientas.

virtual void OnFillBackground(CDC* pDC);

Parámetros

pDC
[in] Puntero a un contexto de dispositivo.

Comentarios

CMFCToolBar::DoPaint llama a este método cuando se ha rellenado el fondo de una barra de herramientas. La implementación predeterminada no hace nada.

Invalide este método para dibujar el fondo personalizado en las clases derivadas.

`CMFCToolBar::OnGlobalFontsChanged`

virtual void OnGlobalFontsChanged();

Comentarios

`CMFCToolBar::OnReset`

Restaura la barra de herramientas a su estado original.

virtual void OnReset();

Comentarios

Invalide este método para controlar la notificación sobre un restablecimiento de la barra de herramientas.

La implementación predeterminada no hace nada. Invalide OnReset en una clase derivada de CMFCToolBar cuando la barra de herramientas tenga botones ficticios que se deban reemplazar cuando la barra de herramientas vuelva a su estado original.

`CMFCToolBar::OnSetAccData`

virtual BOOL OnSetAccData(long lVal);

Parámetros

[in] lVal\

Valor devuelto

Comentarios

`CMFCToolBar::OnSetDefaultButtonText`

Restaura el texto de un botón de barra de herramientas a su estado predeterminado.

virtual BOOL OnSetDefaultButtonText(CMFCToolBarButton* pButton);

Parámetros

pButton
[in] Apunta a un botón, cuyo texto se va a establecer.

Valor devuelto

TRUE si el texto se restauró correctamente; de lo contrario, FALSE.

Comentarios

Invalide este método para procesar las notificaciones de que el texto de un botón de la barra de herramientas se está cambiando a su valor predeterminado.

La implementación predeterminada carga el texto de un botón de los recursos de la aplicación.

`CMFCToolBar::OnUserToolTip`

Lo llama el marco antes de que aparezca la información sobre herramientas de un botón.

virtual BOOL OnUserToolTip(
    CMFCToolBarButton* pButton,
    CString& strTTText) const;

Parámetros

pButton
[in] Apunta a un botón de barra de herramientas para el que se va a mostrar información sobre herramientas.

strTTText
[out] Referencia al objeto CString que recibe el texto de la información sobre herramientas.

Valor devuelto

TRUE si strTTText se ha rellenado con texto de información sobre herramientas; de lo contrario, FALSE.

Comentarios

El marco llama a este método cuando la información sobre herramientas de un botón de la barra de herramientas está a punto de mostrarse. Si OnUserToolTip devuelve TRUE, el marco muestra información sobre herramientas que contiene el texto devuelto por OnUserToolTip en strTTText. De lo contrario, la información sobre herramientas contiene el texto del botón.

Invalide OnUserToolTip para personalizar la información sobre herramientas de los botones de la barra de herramientas. La implementación predeterminada llama a CMFCToolBar::OnUserToolTip para obtener el texto de información sobre herramientas.

`CMFCToolBar::PrevMenu`

virtual BOOL PrevMenu();

Valor devuelto

Comentarios

`CMFCToolBar::ProcessCommand`

Publica un mensaje WM_COMMAND en la ventana que posee la barra de herramientas.

BOOL ProcessCommand(CMFCToolBarButton* pButton);

Parámetros

pButton
[in] Puntero a un botón de la barra de herramientas.

Valor devuelto

Este método devuelve siempre TRUE. MFC usa valores FALSE internamente.

Comentarios

Este método envía un mensaje WM_COMMAND a la ventana que posee la barra de herramientas llamando a CWnd::PostMessage y pasando el identificador de comando del botón especificado como parámetro wParam.

Use la macro ON_COMMAND para asignar el mensaje WM_COMMAND a una función miembro.

`CMFCToolBar::RemoveAllButtons`

Quita todos los botones y separadores de la barra de herramientas.

virtual void RemoveAllButtons();

Comentarios

El marco llama a este método cuando vuelve a crear o destruye una barra de herramientas.

`CMFCToolBar::RemoveButton`

Quita de la barra de herramientas el botón que tiene el índice especificado.

virtual BOOL RemoveButton(int iIndex);

Parámetros

iIndex
[in] Especifica el índice de base cero del botón que se va a quitar.

Valor devuelto

TRUE si el método se ejecuta correctamente; o FALSE si el índice especificado no es válido o el índice hace referencia al botón Personalizar.

Comentarios

Este método actualiza atributos adicionales de la barra de herramientas que se ven afectados por la eliminación del botón. Por ejemplo, este método quita separadores no esenciales de la barra de herramientas y vuelve a generar la tabla de teclas de método abreviado.

Para más información sobre el botón Personalizar, consulte CMFCToolBar::EnableCustomizeButton.

`CMFCToolBar::RemoveStateFromRegistry`

Elimina la información de estado de la barra de herramientas del Registro de Windows.

virtual BOOL RemoveStateFromRegistry(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

Parámetros

lpszProfileName
[in] Especifica la clave del Registro donde se encuentra la información de estado.

nIndex
[in] Identificador de control de la barra de herramientas.

uiID
[in] Identificador de recurso de la barra de herramientas. Si este parámetro es -1, este método usa el método CWnd::GetDlgCtrlID para recuperar el identificador de recurso.

Valor devuelto

Distinto de cero si el método es correcto; de lo contrario, 0.

Comentarios

El marco llama a este método cuando elimina una barra de herramientas definida por el usuario.

Invalide este método si almacena información de estado adicional en el Registro de Windows.

`CMFCToolBar::ReplaceButton`

Reemplaza un botón de barra de herramientas por otro botón de barra de herramientas.

int ReplaceButton(
    UINT uiCmd,
    const CMFCToolBarButton& button,
    BOOL bAll=FALSE);

Parámetros

uiCmd
[in] Identificador de comando del botón que se va a reemplazar.

button
[in] Referencia al objeto CMFCToolBarButton que se va a insertar.

bAll
[in] Valor booleano que especifica si se van a reemplazar todos los botones que tienen el identificador de comando especificado por uiCmd. Si este parámetro es TRUE, se reemplazan todos los botones que tienen el identificador de comando especificado. De lo contrario, se reemplaza el primer botón.

Valor devuelto

Número de botones que se reemplazan. Este método devuelve 0 si un botón con el identificador de comando especificado no existe en la barra de herramientas.

Comentarios

Llame a este método cuando quiera agregar botones de barra de herramientas que no se pueden cargar desde recursos. Puede crear un botón de marcador de posición en tiempo de diseño y reemplazar ese botón por un botón personalizado al inicializar la barra de herramientas. Consulte el ejemplo de VisualStudioDemo para ver cómo se usa este método.

Ejemplo

El siguiente ejemplo muestra cómo se usa el método ReplaceButton de la clase CMFCToolBar. Este fragmento de código forma parte del ejemplo de demostración de IE.

CMFCToolBar m_wndToolBar;

// CMenu menuHistory
// CString str
m_wndToolBar.ReplaceButton(ID_GO_BACK,
                           CMFCToolBarMenuButton(ID_GO_BACK, menuHistory,
                                                 GetCmdMgr()->GetCmdImage(ID_GO_BACK), str));

`CMFCToolBar::ResetAll`

Restaura todas las barras de herramientas a sus estados originales.

static void __stdcall ResetAll();

Comentarios

Este método llama al método CMFCToolBar::RestoreOriginalState en cada barra de herramientas de la aplicación que se puede restaurar. Usa el método CMFCToolBar::CanBeRestored para determinar si se puede restaurar una barra de herramientas.

`CMFCToolBar::ResetAllImages`

Borra todas las colecciones de imágenes de barra de herramientas de la aplicación.

static void __stdcall ResetAllImages();

Comentarios

Este método borra las colecciones de imágenes inicializadas por los métodos CMFCToolBar::LoadToolBar y CMFCToolBar::LoadBitmap.

`CMFCToolBar::ResetImages`

virtual void ResetImages();

Comentarios

`CMFCToolBar::RestoreFocus`

virtual void RestoreFocus();

Comentarios

`CMFCToolBar::RestoreOriginalState`

Restaura el estado original de una barra de herramientas.

virtual BOOL RestoreOriginalState();

Valor devuelto

TRUE si el método se ejecuta correctamente; o FALSE si se produce un error en el método o la barra de herramientas está definida por el usuario.

Comentarios

Este método carga la barra de herramientas desde el archivo de recursos mediante el método CMFCToolBar::LoadToolBar.

El marco llama a este método cuando el usuario elige el botón Restablecer todo en la página Barras de herramientas de un cuadro de diálogo de personalización.

`CMFCToolBar::SaveParameters`

static BOOL __stdcall SaveParameters(LPCTSTR lpszProfileName = NULL);

Parámetros

[in] lpszProfileName\

Valor devuelto

Comentarios

`CMFCToolBar::SaveState`

Guarda la información de estado de la barra de herramientas en el Registro de Windows.

virtual BOOL SaveState(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

Parámetros

lpszProfileName
[in] Especifica la ruta de acceso relativa de la clave del Registro de Windows.

nIndex
[in] Identificador de control de la barra de herramientas.

uiID
[in] Identificador de recurso de la barra de herramientas.

Valor devuelto

Distinto de cero si el método es correcto; de lo contrario, 0.

Comentarios

El marco llama a este método cuando guarda el estado de la aplicación en el Registro. Para obtener más información, vea CWinAppEx::SaveState.

`CMFCToolBar::SetBasicCommands`

Establece la lista de comandos que siempre se muestran cuando un usuario abre un menú.

static void __stdcall SetBasicCommands(CList<UINT,UINT>& lstCommands);

Parámetros

lstCommands
[in] Referencia a un objeto CList que contiene una colección de comandos.

Comentarios

Siempre se muestra un comando básico cuando se abre el menú. Este método es significativo cuando el usuario elige ver los comandos usados recientemente.

Use el método CMFCToolBar::AddBasicCommand para agregar un comando a la lista de comandos básicos. Use el método CMFCToolBar::GetBasicCommands para recuperar la lista de comandos básicos que usa la aplicación.

Consulte el ejemplo del Explorador para ver un ejemplo que use este método.

`CMFCToolBar::SetButtonInfo`

Establece el identificador de comando, el estilo y el identificador de imagen de un botón de la barra de herramientas.

void SetButtonInfo(
    int nIndex,
    UINT nID,
    UINT nStyle,
    int iImage);

Parámetros

nIndex
[in] Índice de base cero del botón cuyas propiedades se establecen.

nID
[in] Identificador de comando del botón.

nStyle
[in] Estilo del botón. Consulte Estilos de control ToolBar para ver la lista de estilos de botón de barra de herramientas disponibles.

iImage
[in] Índice de imagen de base cero del botón (es decir, el índice de la colección de imágenes de la barra de herramientas).

Comentarios

Llame a este método para establecer las propiedades de un botón de barra de herramientas.

En compilaciones de depuración, este método genera un error de aserción si el índice especificado por nIndex no es válido.

Llame al método CMFCToolBar::SetButtonStyle para establecer solo el estilo del botón.

`CMFCToolBar::SetButtons`

Establece los botones de la barra de herramientas.

virtual BOOL SetButtons(
    const UINT* lpIDArray,
    int nIDCount,
    BOOL bRemapImages=TRUE);

Parámetros

lpIDArray
[in] Puntero a la matriz de identificadores de comando de los botones que se van a insertar.

nIDCount
[in] El valor de este parámetro se corresponde con el número de elementos que se incluyen en la matriz lpIDArray.

bRemapImages
[in] Valor booleano que especifica si se van a asociar las imágenes de botón existentes a los botones insertados. Si este parámetro es TRUE, se reasignan las imágenes.

Valor devuelto

Distinto de cero si el método es correcto; de lo contrario, 0.

Comentarios

Llame a este método para quitar los botones existentes de una barra de herramientas e insertar una colección de botones nuevos.

Este método agrega el botón Personalizar a la barra de herramientas y envía el mensaje AFX_WM_RESETTOOLBAR a la ventana principal de la barra de herramientas. Para más información sobre el botón Personalizar, consulte CMFCToolBar::EnableCustomizeButton.

`CMFCToolBar::SetButtonStyle`

Establece el estilo del botón de la barra de herramientas en el índice especificado.

virtual void SetButtonStyle(
    int nIndex,
    UINT nStyle);

Parámetros

nIndex
[in] Índice de base cero del botón de la barra de herramientas cuyo estilo se va a establecer.

nStyle
[in] Estilo del botón. Consulte Estilos de control ToolBar para ver la lista de estilos de botón de barra de herramientas disponibles.

Comentarios

Este método quita el estilo TBBS_PRESSED si nStyle es TBBS_DISABLED porque el usuario no puede seleccionar un botón deshabilitado.

`CMFCToolBar::SetButtonText`

Establece la etiqueta de texto de un botón de la barra de herramientas.

BOOL SetButtonText(
    int nIndex,
    LPCTSTR lpszText);

Parámetros

nIndex
[in] Establece el estilo del botón de la barra de herramientas.

lpszText
[in] Etiqueta de texto del botón de la barra de herramientas. No puede ser NULL.

Valor devuelto

TRUE si el método se ejecuta correctamente; de lo contrario, FALSE.

Comentarios

Este método devuelve FALSE si el índice proporcionado no hace referencia a un botón de barra de herramientas válido.

`CMFCToolBar::SetCommandUsageOptions`

Especifica cuándo los comandos usados raramente no aparecen en el menú de la aplicación.

static BOOL SetCommandUsageOptions(
    UINT nStartCount,
    UINT nMinUsagePercentage=5);

Parámetros

nStartCount
[in] Especifica el número de veces que se deben ejecutar los comandos antes de que el marco muestre solo los comandos básicos y usados recientemente.

nMinUsagePercentage
[in] Porcentaje de veces que se debe ejecutar un comando para considerarse un comando usado recientemente.

Valor devuelto

FALSE si nMinUsagePercentage es igual o mayor que 100; en caso contrario, TRUE.

Comentarios

Llame a este método para personalizar el algoritmo que usa el marco para determinar cómo aparecen los elementos de menú básicos y usados recientemente. Para más información sobre estos comandos básicos, consulte CMFCToolBar::AddBasicCommand.

Esta clase usa la clase CMFCCmdUsageCount para realizar un seguimiento del recuento de uso de comandos. Para más información sobre esta clase, consulte CMFCCmdUsageCount Class.

`CMFCToolBar::SetCustomizeMode`

Habilita o deshabilita el modo de personalización para todas las barras de herramientas de la aplicación.

static BOOL __stdcall SetCustomizeMode(BOOL bSet=TRUE);

Parámetros

bSet
[in] Valor booleano que especifica si se va a habilitar o deshabilitar el modo de personalización. Establezca este parámetro en TRUE para habilitar el modo de personalización o FALSE para deshabilitarlo.

Valor devuelto

TRUE si la llamada a este método cambia el modo de personalización; de lo contrario, FALSE.

Comentarios

Este método ajusta el diseño de cada barra de herramientas de la aplicación y la redibuja. Llame al método CMFCToolBar::IsCustomizeMode para determinar si la aplicación está en modo de personalización.

`CMFCToolBar::SetGrayDisabledButtons`

Especifica si los botones no disponibles de la barra de herramientas están atenuados o si se usan imágenes que no están disponibles.

void SetGrayDisabledButtons(BOOL bGrayDisabledButtons);

Parámetros

bGrayDisabledButtons
[in] Valor booleano que especifica cómo mostrar los botones no disponibles. Si este parámetro es TRUE, el marco atenúa los botones. De lo contrario, el marco usa la colección de imágenes de botones no disponibles.

Comentarios

De forma predeterminada, los botones no disponibles están atenuados.

`CMFCToolBar::SetHeight`

Establece el alto de la barra de herramientas.

void SetHeight(int cyHeight);

Parámetros

cyHeight
[in] Alto de la barra de herramientas, en píxeles.

Comentarios

Este método vuelve a dibujar la barra de herramientas después de establecer el alto.

`CMFCToolBar::SetHelpMode`

static void __stdcall SetHelpMode(BOOL bOn = TRUE);

Parámetros

[in] bOn\

Comentarios

`CMFCToolBar::SetHot`

BOOL SetHot(CMFCToolBarButton* pMenuButton);

Parámetros

[in] pMenuButton\

Valor devuelto

Comentarios

`CMFCToolBar::SetHotBorder`

Especifica si los botones de la barra de herramientas tienen un seguimiento activo.

void SetHotBorder(BOOL bShowHotBorder);

Parámetros

bShowHotBorder
[in] Valor booleano que especifica si realizar el seguimiento activo de los botones de la barra de herramientas. Si este parámetro es TRUE, la barra de herramientas realiza un seguimiento activo de sus botones. De lo contrario, la barra de herramientas no realiza un seguimiento activo de sus botones.

Comentarios

Si se realiza un seguimiento activo de un botón, el marco resalta el botón cuando el mouse se mueve por él. De forma predeterminada, cada barra de herramientas realiza un seguimiento activo de sus botones.

Llame al método CMFCToolBar::GetHotBorder para determinar si la barra de herramientas realiza un seguimiento activo de sus botones.

`CMFCToolBar::SetHotTextColor`

Establece el color del texto para los botones de la barra de herramientas activos.

static void SetHotTextColor(COLORREF clrText);

Parámetros

clrText
[in] Especifica el color de texto de los botones de la barra de herramientas con seguimiento activo.

Comentarios

Para más información sobre los botones de la barra de herramientas con seguimiento activo, consulte CMFCToolBar::GetHotBorder y CMFCToolBar::SetHotBorder.

`CMFCToolBar::SetIgnoreSetText`

void SetIgnoreSetText(BOOL bValue);

Parámetros

[in] bValue\

Comentarios

`CMFCToolBar::SetLargeIcons`

Especifica si los botones de la barra de herramientas muestran iconos grandes.

static void SetLargeIcons(BOOL bLargeIcons=TRUE);

Parámetros

bLargeIcons
[in] Valor booleano que especifica los iconos que se van a usar. Si este parámetro es TRUE, el marco muestra iconos grandes. De lo contrario, el marco muestra iconos normales.

Comentarios

El marco llama a este método cuando el usuario cambia el estado de la casilla Iconos grandes en la pestaña Opciones del cuadro de diálogo Personalizar. Este método cambia el tamaño de todas las barras de herramientas de la aplicación.

De forma predeterminada, el marco muestra iconos normales.

Para más información sobre el cuadro de diálogo Personalizar, consulte CMFCToolBarsCustomizeDialog Class.

`CMFCToolBar::SetLockedSizes`

Establece los tamaños de los botones bloqueados y las imágenes bloqueadas en la barra de herramientas.

void SetLockedSizes(
    SIZE sizeButton,
    SIZE sizeImage,
    BOOL bDontScale = FALSE);

Parámetros

sizeButton
[in] Especifica el tamaño de los botones de la barra de herramientas bloqueados.

sizeImage
[in] Especifica el tamaño de las imágenes de la barra de herramientas bloqueadas.

bDontScale
Especifica si se deben escalar o no imágenes de barra de herramientas bloqueadas en modo de PPP alto.

Comentarios

El tamaño predeterminado de los botones bloqueados es de 23 x 22 píxeles. El tamaño predeterminado de las imágenes bloqueadas es de 16 x 15 píxeles.

Llame al CMFCToolBar::GetLockedImageSize método para recuperar el tamaño de las imágenes bloqueadas. Llame al método CMFCToolBar::GetButtonSize para recuperar el tamaño de los botones de la barra de herramientas bloqueados.

`CMFCToolBar::SetMaskMode`

void SetMaskMode(BOOL bMasked);

Parámetros

[in] bMasked\

Comentarios

`CMFCToolBar::SetMenuSizes`

Establece el tamaño de los botones de menú de la barra de herramientas y sus imágenes.

static void __stdcall SetMenuSizes(
    SIZE sizeButton,
    SIZE sizeImage);

Parámetros

sizeButton
[in] Especifica el tamaño de los botones de la barra de herramientas, en píxeles.

sizeImage
[in] Especifica el tamaño de las imágenes de la barra de herramientas, en píxeles.

Comentarios

De forma predeterminada, los botones de menú y sus imágenes tienen un tamaño indefinido.

Llame al método CMFCToolBar::GetMenuButtonSize para determinar el tamaño de los botones de menú y al método CMFCToolBar::GetMenuImageSize para determinar el tamaño de las imágenes de botón de menú.

Consulte los ejemplos IEDemo y MSMoneyDemo, donde se usa este método.

`CMFCToolBar::SetNonPermittedCommands`

Establece la lista de comandos que el usuario no puede ejecutar.

static void SetNonPermittedCommands(CList<UINT,UINT>& lstCommands);

Parámetros

lstCommands
[in] Referencia a un objeto CList que contiene los comandos que el usuario no puede ejecutar.

Comentarios

Llame a este método para evitar que el usuario seleccione determinados comandos. Por ejemplo, es posible que por motivos de seguridad quiera impedir que el usuario seleccione determinados comandos. Consulte los ejemplos MDITabsDemo y MenuSubSet, donde se usa este método.

Este método borra la lista anterior de comandos no permitidos. De forma predeterminada, la lista de comandos no permitidos está vacía.

`CMFCToolBar::SetOneRowWithSibling`

Coloca la barra de herramientas y sus elementos del mismo nivel en la misma fila.

void SetOneRowWithSibling();

Comentarios

El marco llama a este método cuando el usuario selecciona el botón Mostrar botones en una fila.

Llame al método CMFCToolBar::SetSiblingToolBar para habilitar los botones Mostrar botones en una fila o Mostrar botones en dos filas. Si llama a CMFCToolBar::SetSiblingToolBar en esta barra de herramientas, la barra de herramientas del mismo nivel se mueve a la fila de esta barra de herramientas. De lo contrario, esta barra de herramientas se mueve al elemento del mismo nivel.

El marco llama al método CMFCToolBar::SetTwoRowsWithSibling cuando el usuario selecciona el botón Mostrar botones en dos filas.

`CMFCToolBar::SetOrigButtons`

void SetOrigButtons(const CObList& lstOrigButtons);

Parámetros

[in] lstOrigButtons\

Comentarios

`CMFCToolBar::SetPermament`

Especifica si un usuario puede cerrar la barra de herramientas.

void SetPermament(BOOL bPermament=TRUE);

Parámetros

bPermament
[in] Valor booleano que especifica si un usuario puede cerrar la barra de herramientas. Si este parámetro es TRUE, un usuario no puede cerrar la barra de herramientas. De lo contrario, el usuario puede cerrar la barra de herramientas.

Comentarios

De forma predeterminada, un usuario puede cerrar cada barra de herramientas.

Llame al método CMFCToolBar::CanBeClosed para determinar si un usuario puede cerrar la barra de herramientas.

`CMFCToolBar::SetRouteCommandsViaFrame`

Especifica si el marco principal o el propietario envían comandos a la barra de herramientas.

void SetRouteCommandsViaFrame(BOOL bValue);

Parámetros

bValue
[in] Si este parámetro es TRUE, el marco principal envía comandos a la barra de herramientas. De lo contrario, el propietario envía comandos a la barra de herramientas.

Comentarios

De forma predeterminada, el marco principal envía comandos a la barra de herramientas. Llame al método CMFCToolBar::GetRouteCommandsViaFrame para determinar si el marco principal o el propietario envía comandos a la barra de herramientas.

`CMFCToolBar::SetShowTooltips`

Especifica si el marco muestra información sobre herramientas.

static void SetShowTooltips(BOOL bValue);

Parámetros

bValue
[in] Si este parámetro es TRUE, el marco muestra información sobre herramientas. De lo contrario, el marco oculta la información sobre herramientas.

Comentarios

De forma predeterminada, el marco muestra información sobre herramientas.

Llame al método CMFCToolBar::GetShowTooltips para determinar si el marco muestra información sobre herramientas.

`CMFCToolBar::SetSiblingToolBar`

Especifica el elemento del mismo nivel de la barra de herramientas.

void SetSiblingToolBar(CMFCToolBar* pBrotherToolbar);

Parámetros

pBrotherToolbar
[in] Puntero a la barra de herramientas del mismo nivel.

Comentarios

Este método habilita los botones Mostrar botones en una fila o Mostrar botones en dos filas que se muestran cuando el usuario muestra el menú emergente Personalizar. Llame a este método cuando quiera permitir que el usuario especifique si las barras de herramientas relacionadas aparecen en la misma fila o en filas diferentes.

Llame a este método después de habilitar el botón Personalizar que aparece en la barra de herramientas. Para habilitar el botón Personalizar, llame al método CMFCToolBar::EnableCustomizeButton.

Para recuperar el elemento del mismo nivel de una barra de herramientas, llame a CMFCToolBar::GetSiblingToolBar.

`CMFCToolBar::SetSizes`

Especifica los tamaños de los botones y las imágenes de todas las barras de herramientas.

static void __stdcall SetSizes(
    SIZE sizeButton,
    SIZE sizeImage);

Parámetros

sizeButton
[in] Tamaño de los botones de la barra de herramientas, en píxeles.

sizeImage
[in] Tamaño de las imágenes de botón de la barra de herramientas, en píxeles.

Comentarios

El tamaño predeterminado de los botones de la barra de herramientas es de 23 x 22 píxeles. El tamaño predeterminado de las imágenes de botón de la barra de herramientas es de 16 x 15 píxeles.

Llame al método CMFCToolBar::GetImageSize para recuperar el tamaño de las imágenes de botón de la barra de herramientas. Llame al método CMFCToolBar::GetButtonSize para recuperar el tamaño de los botones de la barra de herramientas.

`CMFCToolBar::SetToolBarBtnText`

Especifica las propiedades de un botón de la barra de herramientas.

void SetToolBarBtnText(
    UINT nBtnIndex,
    LPCTSTR szText=NULL,
    BOOL bShowText=TRUE,
    BOOL bShowImage=TRUE);

Parámetros

nBtnIndex
[in] Índice de base cero del botón de la barra de herramientas en la lista de botones de la barra de herramientas.

szText
[in] Especifica la etiqueta de texto del botón de la barra de herramientas.

bShowText
[in] Si este parámetro es TRUE, el marco muestra la etiqueta de texto. De lo contrario, el marco oculta la etiqueta de texto.

bShowImage
[in] Si este parámetro es TRUE, el marco muestra la imagen del botón de la barra de herramientas. De lo contrario, el marco oculta la imagen del botón de la barra de herramientas.

Comentarios

De forma predeterminada, el marco muestra las imágenes de los botones de la barra de herramientas, pero no muestra la etiqueta de texto de los botones de la barra de herramientas.

En las compilaciones de depuración, este método genera un error de aserción si nBtnIndex no hace referencia a un botón de la barra de herramientas válido o el botón de la barra de herramientas es un separador.

`CMFCToolBar::SetTwoRowsWithSibling`

Coloca la barra de herramientas y su elemento del mismo nivel en distintas filas.

void SetTwoRowsWithSibling();

Comentarios

El marco llama a este método cuando el usuario selecciona el botón Mostrar botones en dos filas.

Llame al método CMFCToolBar::SetSiblingToolBar para habilitar los botones Mostrar botones en una fila o Mostrar botones en dos filas. Si llama a CMFCToolBar::SetSiblingToolBar en esta barra de herramientas, la barra de herramientas del mismo nivel se mueve a una fila distinta. De lo contrario, esta barra de herramientas se mueve a una fila distinta.

El marco llama al método CMFCToolBar::SetOneRowWithSibling cuando el usuario selecciona el botón Mostrar botones en una fila.

`CMFCToolBar::SetUserImages`

Establece la colección de imágenes definidas por el usuario en la aplicación.

static BOOL SetUserImages(CMFCToolBarImages* pUserImages);

Parámetros

pUserImages
[in] Puntero a la colección de imágenes definidas por el usuario.

Valor devuelto

Distinto de cero si el método se ejecuta correctamente; o 0 si el objeto CMFCToolBarImages especificado no es válido o tiene un tamaño de imagen que difiere del tamaño de imagen predeterminado de la barra de herramientas.

Comentarios

El marco usa imágenes definidas por el usuario para dibujar botones de la barra de herramientas personalizados por el usuario. La lista de imágenes especificada por pUserImages se comparte entre todas las barras de herramientas de la aplicación.

Este método genera un error de aserción en compilaciones de depuración si el objeto CMFCToolBarImages especificado no es válido o tiene un tamaño de imagen que difiere del tamaño de imagen predeterminado de la barra de herramientas.

En los ejemplos OutlookDemo, ToolTipDemo y VisualStudioDemo se usa este método para establecer la colección global de imágenes definidas por el usuario. Cargan el archivo denominado UserImages.bmp, que se encuentra en el directorio de trabajo de la aplicación.

Llame al método CMFCToolBar::GetUserImages para recuperar la colección de imágenes definidas por el usuario en la aplicación.

`CMFCToolBar::StretchPane`

Estira la barra de herramientas vertical u horizontalmente y cambia la posición de los botones si es necesario.

virtual CSize StretchPane(
    int nLength,
    BOOL bVert);

Parámetros

nLength
[in] Cantidad, en píxeles, que se va estirar el panel.

bVert
[in] Si es TRUE, el panel se estira verticalmente. Si es FALSE, el panel se estira horizontalmente.

Valor devuelto

Objeto CSize que especifica el tamaño del área cliente de la barra de herramientas.

Comentarios

Este método llama a CMFCToolBar::WrapToolBar para cambiar la posición de los botones dentro de la barra de herramientas estirada.

La longitud del valor devuelto viene determinada por la llamada a CMFCToolBar::CalcSize.

`CMFCToolBar::TranslateChar`

Ejecuta un comando de botón si el código de tecla especificado corresponde a un método abreviado de teclado válido.

virtual BOOL TranslateChar(UINT nChar);

Parámetros

nChar
[in] Especifica un código de tecla virtual. Para obtener una lista de códigos de tecla virtual estándar, consulte Winuser.h.

Valor devuelto

FALSE si el código de tecla especificado no es imprimible o no corresponde a un método abreviado de teclado válido; TRUE si el código de clave especificado corresponde a una opción de menú desplegable; de lo contrario, el valor devuelto de CMFCToolBar::ProcessCommand.

Comentarios

El marco llama a este método cuando se presiona una tecla junto con la tecla Alt.

`CMFCToolBar::UpdateButton`

Actualiza el estado del botón especificado.

void UpdateButton(int nIndex);

Parámetros

nIndex
[in] Especifica el índice de base cero del botón que se va a actualizar.

Comentarios

`CMFCToolBar::WrapToolBar`

Cambia la posición de los botones de la barra de herramientas dentro de las dimensiones especificadas.

int WrapToolBar(
    int nWidth,
    int nHeight = 32767,
    CDC* pDC = NULL,
    int nColumnWidth = -1,
    int nRowHeight = -1);

Parámetros

nWidth
[in] Ancho máximo de la barra de herramientas.

nHeight
[in] Alto máximo de la barra de herramientas. No se usa si la barra de herramientas es flotante.

pDC
[in] Puntero a un contexto de dispositivo. Si es NULL, se usa el contexto de dispositivo para la barra de herramientas.

nColumnWidth
[in] Ancho del botón. Si es -1, se usa el ancho actual.

[in] mnRowHeight Alto del botón. Si es -1, se usa el alto actual.

Valor devuelto

Número de filas de botones de la barra de herramientas.

Comentarios

Este método cambia la posición de los botones de la barra de herramientas, y ajusta los botones a filas adicionales si es necesario.

`CMFCToolBar::m_bDontScaleImages`

Especifica si se van a escalar o no imágenes de la barra de herramientas en modo de PPP alto. Establézcalo en TRUE para evitar el escalado de imágenes cuando un tamaño de imagen no coincide con un tamaño de botón.

AFX_IMPORT_DATA static BOOL m_bDontScaleImages;

Consulte también

Gráfico de jerarquías
Clases
CMFCMenuBar (clase)
CMFCPopupMenuBar (clase)
CMFCDropDownToolBar (clase)
Tutorial: Poner controles en las barras de herramientas

Clase CMFCToolBar

Sintaxis

Miembros

Constructores públicos

Métodos públicos

Métodos protegidos

Miembros de datos

Comentarios

Ejemplo

Requisitos

Jerarquía de herencia

CMFCToolBar::AddBasicCommand

Parámetros

Comentarios

CMFCToolBar::AddCommandUsage

Parámetros

Comentarios

CMFCToolBar::AddToolBarForImageCollection

Parámetros

Valor devuelto

Comentarios

CMFCToolBar::AdjustLayout

Comentarios

CMFCToolBar::AdjustSize

Comentarios

CMFCToolBar::AllowChangeTextLabels

Valor devuelto

Comentarios

CMFCToolBar::AllowShowOnList

Valor devuelto

Comentarios

CMFCToolBar::AreTextLabels

Valor devuelto

Comentarios

CMFCToolBar::AutoGrayInactiveImages

Parámetros

Comentarios

CMFCToolBar::ButtonToIndex

Parámetros

Valor devuelto

CMFCToolBar::CalcFixedLayout

Parámetros

Valor devuelto

Comentarios

CMFCToolBar::CalcMaxButtonHeight

Valor devuelto

Comentarios

CMFCToolBar::CalcSize

Parámetros

Valor devuelto

Comentarios

CMFCToolBar::CanBeClosed

Valor devuelto

Comentarios

CMFCToolBar::CanBeRestored

Valor devuelto

Comentarios

CMFCToolBar::CanFocus

Valor devuelto

Comentarios

CMFCToolBar::CanHandleSiblings

Valor devuelto

Comentarios

CMFCToolBar::CleanUpImages

Comentarios

CMFCToolBar::CleanUpLockedImages

Comentarios

CMFCToolBar::CommandToIndex

Parámetros

Valor devuelto

Comentarios

CMFCToolBar::Create

Parámetros

Valor devuelto

Comentarios

CMFCToolBar::CreateEx

Parámetros

Valor devuelto

Comentarios

Ejemplo

Clase `CMFCToolBar`

`CMFCToolBar::AddBasicCommand`

`CMFCToolBar::AddCommandUsage`

`CMFCToolBar::AddToolBarForImageCollection`

`CMFCToolBar::AdjustLayout`

`CMFCToolBar::AdjustSize`

`CMFCToolBar::AllowChangeTextLabels`

`CMFCToolBar::AllowShowOnList`

`CMFCToolBar::AreTextLabels`

`CMFCToolBar::AutoGrayInactiveImages`

`CMFCToolBar::ButtonToIndex`

`CMFCToolBar::CalcFixedLayout`

`CMFCToolBar::CalcMaxButtonHeight`

`CMFCToolBar::CalcSize`

`CMFCToolBar::CanBeClosed`

`CMFCToolBar::CanBeRestored`

`CMFCToolBar::CanFocus`

`CMFCToolBar::CanHandleSiblings`

`CMFCToolBar::CleanUpImages`

`CMFCToolBar::CleanUpLockedImages`

`CMFCToolBar::CommandToIndex`

`CMFCToolBar::Create`

`CMFCToolBar::CreateEx`

`CMFCToolBar::Deactivate`

`CMFCToolBar::DoPaint`

`CMFCToolBar::DrawButton`

`CMFCToolBar::DrawSeparator`

`CMFCToolBar::EnableCustomizeButton`

`CMFCToolBar::EnableDocking`

`CMFCToolBar::EnableLargeIcons`

`CMFCToolBar::EnableQuickCustomization`

`CMFCToolBar::EnableReflections`

`CMFCToolBar::EnableTextLabels`

`CMFCToolBar::FromHandlePermanent`

`CMFCToolBar::GetAllButtons`

`CMFCToolBar::GetAllToolbars`

`CMFCToolBar::GetBasicCommands`

`CMFCToolBar::GetButton`

`CMFCToolBar::GetButtonInfo`

`CMFCToolBar::GetButtonSize`

`CMFCToolBar::GetButtonStyle`

`CMFCToolBar::GetButtonText`

`CMFCToolBar::GetColdImages`

`CMFCToolBar::GetColumnWidth`

`CMFCToolBar::GetCommandButtons`

`CMFCToolBar::GetCount`

`CMFCToolBar::GetCustomizeButton`