Clase CMFCDropDownToolBar

Una barra de herramientas que aparece cuando el usuario presiona y mantiene presionado un botón de la barra de herramientas de nivel superior.

Para obtener información más detallada, consulta el código fuente que se ubica en la carpeta VC\atlmfc\src\mfc de la instalación de Visual Studio.

Sintaxis

class CMFCDropDownToolBar : public CMFCToolBar

Miembros

Métodos públicos

Nombre	Descripción
CMFCDropDownToolBar::AllowShowOnPaneMenu	(Invalida CPane::AllowShowOnPaneMenu).
CMFCDropDownToolBar::LoadBitmap	(Invalida CMFCToolBar::LoadBitmap).
CMFCDropDownToolBar::LoadToolBar	(Invalida CMFCToolBar::LoadToolBar).
CMFCDropDownToolBar::OnLButtonUp
CMFCDropDownToolBar::OnMouseMove
CMFCDropDownToolBar::OnSendCommand	(Invalida CMFCToolBar::OnSendCommand).
CMFCDropDownToolBar::OnUpdateCmdUI	(Invalida CMFCToolBar::OnUpdateCmdUI).

Comentarios

Un objeto CMFCDropDownToolBar combina la apariencia visual de una barra de herramientas con el comportamiento de un menú emergente. Cuando un usuario mantiene presionado un botón de la barra de herramientas desplegable (consulte Clase CMFCDropDownToolbarButton), aparece una barra de herramientas desplegable y el usuario puede seleccionar un botón de esta barra si se desplaza hasta ella y suelta el botón del mouse. Después de que el usuario seleccione un botón en la barra de herramientas desplegable, ese botón se muestra como el botón actual en la barra de herramientas de nivel superior.

Una barra de herramientas desplegable no se puede personalizar ni acoplar, y no tiene un estado desplazable.

En la siguiente ilustración se muestra un objeto CMFCDropDownToolBar:

Para crear un objeto CMFCDropDownToolBar se sigue el mismo procedimiento que para crear una barra de herramientas normal (consulte Clase CMFCToolBar).

Para insertar la barra de herramientas desplegable en una barra de herramientas primaria:

1. Reserve un id. de recurso ficticio para el botón en el recurso primario de la barra de herramientas.

2. Cree un objeto CMFCDropDownToolBarButton que contenga la barra de herramientas desplegable (para obtener más información, consulte CMFCDropDownToolbarButton::CMFCDropDownToolbarButton).

3. Reemplace el botón ficticio por el objeto CMFCDropDownToolBarButton mediante CMFCToolBar::ReplaceButton.

Para obtener más información sobre los botones de la barra de herramientas, consulte Tutorial: Colocación de controles en barras de herramientas. Para obtener un ejemplo de una barra de herramientas desplegable, consulte el proyecto de ejemplo VisualStudioDemo.

Ejemplo

El siguiente ejemplo muestra cómo se usa el método Create de la clase CMFCDropDownToolBar. Este fragmento de código forma parte del ejemplo de demostración de Visual Studio.

CMFCDropDownToolBar m_wndToolbarResource;

// Create Resource toolbar:
// The this pointer points to CMainFrame class which extends the CMDIFrameWndEx class
if (!m_wndToolbarResource.Create(this, WS_CHILD | CBRS_TOP | CBRS_TOOLTIPS | CBRS_FLYBY | CBRS_HIDE_INPLACE | CBRS_SIZE_DYNAMIC | CBRS_GRIPPER | CBRS_BORDER_3D, IDR_TOOLBAR_RESOURCE) || !m_wndToolbarResource.LoadToolBar(IDR_TOOLBAR_RESOURCE))
{
   TRACE0("Failed to create build toolbar\n");
   return FALSE;      // fail to create
}

Jerarquía de herencia

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCBaseToolBar

CMFCToolBar

CMFCDropDownToolBar

Requisitos

Encabezado: afxdropdowntoolbar.h

CMFCDropDownToolBar::AllowShowOnPaneMenu

virtual BOOL AllowShowOnPaneMenu() const;

Valor devuelto

Comentarios

CMFCDropDownToolBar::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.

CMFCDropDownToolBar::LoadToolBar

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

Parámetros

[in] uiResID

[in] uiColdResID

[in] uiMenuResID

[in] BOOL

[in] uiDisabledResID

[in] uiMenuDisabledResID

[in] uiHotResID

Valor devuelto

Comentarios

CMFCDropDownToolBar::OnLButtonUp

afx_msg void OnLButtonUp(
    UINT nFlags,
    CPoint point);

Parámetros

[in] nFlags

[in] point

Comentarios

CMFCDropDownToolBar::OnMouseMove

afx_msg void OnMouseMove(
    UINT nFlags,
    CPoint point);

Parámetros

[in] nFlags

[in] point

Comentarios

CMFCDropDownToolBar::OnSendCommand

virtual BOOL OnSendCommand(const CMFCToolBarButton* pButton);

Parámetros

[in] pButton

Valor devuelto

Comentarios

CMFCDropDownToolBar::OnUpdateCmdUI

virtual void OnUpdateCmdUI(
    CFrameWnd* pTarget,
    BOOL bDisableIfNoHndler);

Parámetros

[in] pTarget

[in] bDisableIfNoHndler

Comentarios

Consulte también

Gráfico de jerarquías
Clases
CMFCToolBar (clase)
CMFCToolBar::Create
CMFCToolBar::ReplaceButton
CMFCDropDownToolbarButton (clase)
Tutorial: Poner controles en las barras de herramientas