CMFCToolBarMenuButton (clase)

Artículo
06/16/2023

Un botón de la barra de herramientas que contiene un menú emergente. 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 CMFCToolBarMenuButton : public CMFCToolBarButton

Miembros

Constructores públicos

Nombre	Descripción
CMFCToolBarMenuButton::CMFCToolBarMenuButton	Construye un objeto `CMFCToolBarMenuButton`.

Métodos públicos

Nombre	Descripción
CMFCToolBarMenuButton::CompareWith	Compara esta instancia con el objeto `CMFCToolBarButton` proporcionado. (Invalida CMFCToolBarButton::CompareWith.)
CMFCToolBarMenuButton::CopyFrom	Copia las propiedades de otro botón de la barra de herramientas en el botón actual. (Invalida CMFCToolBarButton::CopyFrom).
CMFCToolBarMenuButton::CreateFromMenu	Inicializa el menú de la barra de herramientas desde un identificador de menú de Windows.
CMFCToolBarMenuButton::CreateMenu	Crea un menú de Windows que consta de los comandos del menú de la barra de herramientas. Devuelve un identificador al menú de Windows.
CMFCToolBarMenuButton::CreatePopupMenu	Crea un objeto de menú emergente (CMFCPopupMenu (clase)) para mostrar el menú de la barra de herramientas.
CMFCToolBarMenuButton::EnableQuickCustomize
CMFCToolBarMenuButton::GetCommands	Proporciona acceso de solo lectura a la lista de comandos del menú de la barra de herramientas.
CMFCToolBarMenuButton::GetImageRect	Recupera el rectángulo delimitador de la imagen del botón.
CMFCToolBarMenuButton::GetPaletteRows	Devuelve el número de filas del menú emergente cuando el menú está en modo de paleta.
CMFCToolBarMenuButton::GetPopupMenu	Devuelve un puntero al objeto de menú emergente asociado al botón.
CMFCToolBarMenuButton::HasButton
CMFCToolBarMenuButton::HaveHotBorder	Determina si se muestra un borde del botón cuando un usuario selecciona el botón. Invalida CMFCToolBarButton::HaveHotBorder.
CMFCToolBarMenuButton::IsBorder
CMFCToolBarMenuButton::IsClickedOnMenu
CMFCToolBarMenuButton::IsDroppedDown	Determina si se muestra el menú emergente.
CMFCToolBarMenuButton::IsEmptyMenuAllowed	Lo llama el marco para determinar si un usuario puede abrir un submenú desde el elemento de menú seleccionado.
CMFCToolBarMenuButton::IsExclusive	Determina si el botón está en modo exclusivo, es decir, si el menú emergente sigue abierto incluso cuando el usuario mueve el puntero sobre otra barra de herramientas u otro botón.
CMFCToolBarMenuButton::IsMenuPaletteMode	Determina si el menú emergente está en modo de paleta.
CMFCToolBarMenuButton::IsQuickMode
CMFCToolBarMenuButton::IsTearOffMenu	Determina si el menú emergente tiene una barra desplazable.
CMFCToolBarMenuButton::OnAfterCreatePopupMenu
CMFCToolBarMenuButton::OnBeforeDrag	Especifica si se puede arrastrar el botón. (Invalida CMFCToolBarButton::OnBeforeDrag.)
CMFCToolBarMenuButton::OnCalculateSize	Lo llama el marco para calcular el tamaño del botón para el contexto de dispositivo y el estado de acoplamiento especificados. (Invalida CMFCToolBarButton::OnCalculateSize.)
CMFCToolBarMenuButton::OnCancelMode	Lo llama el marco para administrar el mensaje WM_CANCELMODE. (Invalida CMFCToolBarButton::OnCancelMode.)
CMFCToolBarMenuButton::OnChangeParentWnd	Lo llama el marco cuando el botón se inserta en una barra de herramientas nueva. (Invalida CMFCToolBarButton::OnChangeParentWnd).
CMFCToolBarMenuButton::OnClick	Lo llama el marco cuando el usuario pulsa el botón del mouse. Invalida CMFCToolBarButton::OnClick.
CMFCToolBarMenuButton::OnClickMenuItem	Lo llama el marco cuando el usuario selecciona un elemento en el menú emergente.
CMFCToolBarMenuButton::OnContextHelp	Lo llama el marco cuando la barra de herramientas primaria controla un mensaje de WM_HELPHITTEST. (Invalida CMFCToolBarButton::OnContextHelp.)
CMFCToolBarMenuButton::OnDraw	Lo llama el marco para dibujar el botón mediante las opciones y los estilos especificados. (Invalida CMFCToolBarButton::OnDraw.)
CMFCToolBarMenuButton::OnDrawOnCustomizeList	Lo llama el marco para dibujar el botón en el panel Comandos del cuadro de diálogo Personalizar. Invalida CMFCToolBarButton::OnDrawOnCustomizeList.
CMFCToolBarMenuButton::OpenPopupMenu	Lo llama el marco cuando el usuario abre el menú emergente.
CMFCToolBarMenuButton::ResetImageToDefault	Establece en el valor predeterminado la imagen asociada al botón. (Invalida CMFCToolBarButton::ResetImageToDefault.)
CMFCToolBarMenuButton::SaveBarState	Guarda el estado del botón de la barra de herramientas. (Invalida CMFCToolBarButton::SaveBarState.)
CMFCToolBarMenuButton::Serialize	Lee este objeto desde un archivo o lo escribe en un archivo. (Invalida CMFCToolBarButton::Serialize).
CMFCToolBarMenuButton::SetACCData	Rellena el objeto proporcionado `CAccessibilityData` con datos de accesibilidad desde el botón de la barra de herramientas. (Invalida CMFCToolBarButton::SetACCData.)
CMFCToolBarMenuButton::SetMenuOnly	Especifica si el botón se puede agregar a una barra de herramientas.
CMFCToolBarMenuButton::SetMenuPaletteMode	Especifica si el menú emergente está en modo de paleta.
CMFCToolBarMenuButton::SetMessageWnd
CMFCToolBarMenuButton::SetRadio	Hace que el botón de menú de la barra de herramientas muestre un icono que indica que está seleccionado.
CMFCToolBarMenuButton::SetTearOff	Especifica un identificador de barra desplazable para el menú emergente.

Métodos protegidos

Nombre	Descripción
CMFCToolBarMenuButton::DrawDocumentIcon	Dibuja un icono en el botón de menú.

Miembros de datos

Nombre	Descripción
CMFCToolBarMenuButton::m_bAlwaysCallOwnerDraw	Si es TRUE, el marco siempre llama a CFrameWndEx::OnDrawMenuImage cuando se dibuja un botón.

Comentarios

Un CMFCToolBarMenuButton puede aparecer como un menú, un elemento de menú que tiene un submenú, un botón que ejecuta un comando o muestra un menú o un botón que muestra solo un menú. Para determinar el comportamiento y la apariencia del botón de menú, especifique parámetros como la imagen, el texto, el identificador de menú y el identificador de comando que está asociado al botón en el constructor CMFCToolbarMenuButton::CMFCToolbarMenuButton.

Una clase personalizada derivada de la clase CMFCToolbarMenuButton debe usar la macro DECLARE_SERIAL. La macro DECLARE_DYNCREATE genera un error cuando se cierra la aplicación.

Ejemplo

El siguiente ejemplo muestra cómo configurar un objeto CMFCToolBarMenuButton. El código muestra cómo especificar que el menú desplegable está en modo de paleta y cómo especificar el identificador de la barra desplazable que se crea cuando el usuario arrastra el botón de menú fuera de una barra de menús. Este fragmento de código forma parte del ejemplo de WordPad.

pBorderType->SetMenuPaletteMode(TRUE, 2 /* Rows number */);
pBorderType->SetTearOff(ID_BORDER_TEAROFF);

Jerarquía de herencia

CObject

CMFCToolBarButton

CMFCToolBarMenuButton

Requisitos

Encabezado: afxtoolbarmenubutton.h

CMFCToolBarMenuButton::CMFCToolBarMenuButton

Construye un objeto CMFCToolBarMenuButton.

CMFCToolBarMenuButton();
CMFCToolBarMenuButton(const CMFCToolBarMenuButton& src);

CMFCToolBarMenuButton(
    UINT uiID,
    HMENU hMenu,
    int iImage,
    LPCTSTR lpszText=NULL,
    BOOL bUserButton=FALSE);

Parámetros

src
[in] Un objeto existente CMFCToolBarMenuButton que se va a copiar en este objeto CMFCToolBarMenuButton.

uiID
[in] El identificador del comando que se va a ejecutar cuando un usuario haga clic en el botón; o (UINT)-1 para un botón de menú que no ejecuta directamente un comando.

hMenu
[in] Un identificador de un menú; o NULL si el botón no tiene un menú.

iImage
[in] Índice de la imagen del botón; o -1 si este botón no tiene un icono o usa el icono para el comando especificado por uiID. El índice es el mismo para cada objeto CMFCToolBarImages de la aplicación.

lpszText
[in] El texto del botón de menú de la barra de herramientas.

bUserButton
[in] TRUE si el botón muestra una imagen definida por el usuario; FALSE si el botón muestra una imagen predefinida asociada al comando especificado por uiID.

Comentarios

Si uiID es un identificador de comando válido, el botón ejecuta dicho comando cuando el usuario hace clic en él. Si hMenu es un identificador de menú válido, el botón proporciona un menú desplegable cuando aparece en una barra de herramientas o un submenú cuando aparece en un menú. Si tanto uiID como hMenu son válidos, el botón es un botón de expansión con una parte que ejecutará el comando cuando el usuario haga clic en ella y una parte con una flecha hacia abajo que abrirá un menú desplegable cuando el usuario haga clic en ella. Sin embargo, si hMenu es válido, el usuario no podrá hacer clic en el botón para ejecutar un comando cuando el botón se inserte en un menú.

Ejemplo

En el ejemplo siguiente se muestra cómo construir un objeto de la clase CMFCToolBarMenuButton. Este fragmento de código forma parte del ejemplo de WordPad.

CMFCToolBarMenuButton *pBorderType = new CMFCToolBarMenuButton(ID_BORDER_1, pPopup->GetSafeHmenu(),
                                                               GetCmdMgr()->GetCmdImage(ID_BORDER_1, FALSE),
                                                               _T("Borders"));

CMFCToolBarMenuButton::CompareWith

virtual BOOL CompareWith(const CMFCToolBarButton& other) const;

Parámetros

[in] otro

Valor devuelto

Comentarios

CMFCToolBarMenuButton::CopyFrom

virtual void CopyFrom(const CMFCToolBarButton& src);

Parámetros

[in] src

Comentarios

CMFCToolBarMenuButton::CreateFromMenu

Inicializa el menú de la barra de herramientas desde un identificador de menú de Windows.

virtual void CreateFromMenu(HMENU hMenu);

Parámetros

hMenu
[in] Un identificador de un menú.

Comentarios

Un botón de menú de la barra de herramientas puede mostrar un submenú desplegable.

El marco llama a este método para inicializar los comandos en el submenú desde un menú.

CMFCToolBarMenuButton::CreateMenu

Crea un menú que consta de los comandos del menú de la barra de herramientas. Devuelve un identificador para este menú.

virtual HMENU CreateMenu() const;

Valor devuelto

Un identificador del menú si se ejecuta correctamente. NULL si la lista de comandos asociados al botón de menú de la barra de herramientas está vacía.

Comentarios

Puede invalidar este método en una clase derivada para personalizar la forma en que se genera el menú.

CMFCToolBarMenuButton::CreatePopupMenu

Crea un objeto CMFCPopupMenu para mostrar el menú de la barra de herramientas.

virtual CMFCPopupMenu* CreatePopupMenu();

Valor devuelto

Un puntero a un objeto CMFCPopupMenu que muestra el menú desplegable asociado al botón de menú de la barra de herramientas.

Comentarios

El marco llama a este método para preparar la presentación del menú desplegable asociado al botón.

La implementación predeterminada solo construye y devuelve un objeto CMFCPopupMenu nuevo. Invalide este método si desea usar un tipo derivado de la clase CMFCPopupMenu o para realizar una inicialización adicional.

CMFCToolBarMenuButton::DrawDocumentIcon

Dibuja un icono de documento en el botón de menú.

void DrawDocumentIcon(
    CDC* pDC,
    const CRect& rectImage,
    HICON hIcon);

Parámetros

pDC
[in] Puntero al contexto de dispositivo.

rectImage
[in] Coordina el rectángulo delimitador de la imagen.

hIcon
[in] Identificador del icono.

Comentarios

Este método toma un icono de documento y lo dibuja en el botón de menú, centrado en el área especificada por rectImage.

CMFCToolBarMenuButton::EnableQuickCustomize

void EnableQuickCustomize();

Comentarios

CMFCToolBarMenuButton::HasButton

virtual BOOL HasButton() const;

Valor devuelto

Comentarios

CMFCToolBarMenuButton::HaveHotBorder

virtual BOOL HaveHotBorder() const;

Valor devuelto

Comentarios

CMFCToolBarMenuButton::IsBorder

virtual BOOL IsBorder() const;

Valor devuelto

Comentarios

CMFCToolBarMenuButton::IsClickedOnMenu

BOOL IsClickedOnMenu() const;

Valor devuelto

Comentarios

CMFCToolBarMenuButton::IsQuickMode

BOOL IsQuickMode();

Valor devuelto

Comentarios

CMFCToolBarMenuButton::GetCommands

Proporciona acceso de solo lectura a la lista de comandos del menú de la barra de herramientas.

const CObList& GetCommands() const;

Valor devuelto

Referencia const a un objeto de CObList (clase), que contiene una colección de objetos de CMFCToolBarButton (clase).

Comentarios

Un botón de menú de la barra de herramientas puede mostrar un submenú. Puede proporcionar la lista de comandos en el submenú del constructor o en CMFCToolBarMenuButton::CreateFromMenu como identificador de un menú (HMENU). El menú se convierte en una lista de objetos derivados de CMFCToolBarButton (clase) y almacenados en el objeto interno CObList. Llame a este método para acceder a esta lista.

CMFCToolBarMenuButton::GetImageRect

Recupera el rectángulo delimitador de la imagen del botón.

void GetImageRect(CRect& rectImage);

Parámetros

rectImage
[out] Referencia a un objeto CRect que recibe las coordenadas del rectángulo delimitador de la imagen.

CMFCToolBarMenuButton::GetPaletteRows

Devuelve el número de filas del menú desplegable cuando el menú está en modo de paleta.

int GetPaletteRows() const;

Valor devuelto

Número de filas de la paleta.

Comentarios

Cuando el botón de menú se establece en modo de paleta, los elementos de menú aparecerán en varias columnas con un número limitado de filas. Llame a este método para obtener el número de filas. Puede habilitar o deshabilitar el modo de paleta y especificar el número de filas mediante CMFCToolBarMenuButton::SetMenuPaletteMode.

CMFCToolBarMenuButton::GetPopupMenu

Devuelve un puntero al objeto de CMFCPopupMenu (clase) que representa el menú desplegable del botón.

CMFCPopupMenu* GetPopupMenu() const;

Valor devuelto

Puntero a un objeto de CMFCPopupMenu (clase) que se creó cuando el marco dibujó el submenú del botón de menú de la barra de herramientas; NULL si no se muestra ningún submenú.

Comentarios

Cuando un botón de menú de la barra de herramientas muestra un menú desplegable, el botón crea un objeto de CMFCPopupMenu (clase) para representar el menú. Llame a este método para obtener un puntero al CMFCPopupMenu objeto. No debe almacenar el puntero devuelto, ya que es temporal y deja de ser válido cuando el usuario cierra el menú desplegable.

CMFCToolBarMenuButton::IsDroppedDown

Indica si el menú emergente se muestra actualmente.

virtual BOOL IsDroppedDown() const;

Valor devuelto

TRUE si el botón de menú de la barra de herramientas muestra su submenú; en caso contrario, FALSE.

CMFCToolBarMenuButton::IsEmptyMenuAllowed

Especifica si los elementos de menú muestran submenús vacíos.

virtual BOOL IsEmptyMenuAllowed() const;

Valor devuelto

TRUE si el marco abre un submenú desde el elemento de menú seleccionado actualmente incluso cuando el submenú está vacío; en caso contrario, FALSE.

Comentarios

El marco llama a este método cuando un usuario intenta abrir el submenú desde el elemento de menú seleccionado actualmente. Si el submenú está vacío y IsEmptyMenuAllowed devuelve FALSE, el submenú no se abrirá.

La implementación predeterminada devuelve FALSE. Invalide este método para personalizar este comportamiento.

CMFCToolBarMenuButton::IsExclusive

Indica si el botón está en modo exclusivo.

virtual BOOL IsExclusive() const;

Valor devuelto

TRUE si el botón funciona en modo exclusivo; en caso contrario, FALSE.

Comentarios

Cuando un usuario abre un menú emergente para un botón y, a continuación, mueve el puntero del mouse sobre otra barra de herramientas o botón de menú, el menú emergente se cierra a menos que el botón esté en modo exclusivo.

La implementación predeterminada siempre devuelve FALSE. Invalide este método en una clase derivada si desea activar el modo exclusivo.

CMFCToolBarMenuButton::IsMenuPaletteMode

Determina si el menú desplegable está en modo de paleta.

BOOL IsMenuPaletteMode() const;

Valor devuelto

TRUE si el modo de paleta está habilitado; de lo contrario, FALSE.

Comentarios

Cuando el botón de menú se establece en modo de paleta, los elementos de menú aparecen en varias columnas con un número limitado de filas. Llame a este método para obtener el número de filas. Para habilitar o deshabilitar el modo de paleta llame a CMFCToolBarMenuButton::SetMenuPaletteMode.

CMFCToolBarMenuButton::IsTearOffMenu

Indica si el menú desplegable tiene una barra desplazable.

virtual BOOL IsTearOffMenu() const;

Valor devuelto

TRUE si el botón de menú de la barra de herramientas tiene una barra desplazable; en caso contrario, FALSE.

Comentarios

Para habilitar la característica de desplazamiento y establecer el identificador de barra desplazable, llame a CMFCToolBarMenuButton::SetTearOff.

CMFCToolBarMenuButton::m_bAlwaysCallOwnerDraw

Especifica si el marco siempre llama a CFrameWndEx::OnDrawMenuImage cuando se dibuja un botón.

static BOOL m_bAlwaysCallOwnerDraw;

Comentarios

Cuando esta variable miembro se establece en TRUE, el botón siempre llama al método CFrameWndEx::OnDrawMenuImage para mostrar la imagen en el botón. Cuando m_bAlwaysCallOwnerDraw es FALSE, el propio botón dibuja la imagen si la imagen está predefinida. En caso contrario, llama a OnDrawMenuImage.

CMFCToolBarMenuButton::OnAfterCreatePopupMenu

virtual void OnAfterCreatePopupMenu();

Comentarios

CMFCToolBarMenuButton::OnBeforeDrag

virtual BOOL OnBeforeDrag() const;

Valor devuelto

Comentarios

CMFCToolBarMenuButton::OnCalculateSize

virtual SIZE OnCalculateSize(
    CDC* pDC,
    const CSize& sizeDefault,
    BOOL bHorz);

Parámetros

[in] pDC
[in] sizeDefault
[in] bHorz

Valor devuelto

Comentarios

CMFCToolBarMenuButton::OnCancelMode

virtual void OnCancelMode();

Comentarios

CMFCToolBarMenuButton::OnChangeParentWnd

virtual void OnChangeParentWnd(CWnd* pWndParent);

Parámetros

[in] pWndParent

Comentarios

CMFCToolBarMenuButton::OnClick

virtual BOOL OnClick(
    CWnd* pWnd,
    BOOL bDelay = TRUE);

Parámetros

[in] pWnd
[in] bDelay

Valor devuelto

Comentarios

CMFCToolBarMenuButton::OnClickMenuItem

Lo llama el marco cuando el usuario selecciona un elemento en el menú desplegable.

virtual BOOL OnClickMenuItem();

Valor devuelto

FALSE si el marco debe continuar con el procesamiento de elementos de menú predeterminado; de lo contrario, es TRUE. La implementación predeterminada siempre devuelve FALSE.

Comentarios

Cuando el usuario hace clic en un elemento de menú, el marco ejecuta un comando asociado a ese elemento.

Para personalizar el procesamiento de elementos de menú, invalide OnClickMenuItem en una clase derivada de la clase CMFCToolBarMenuButton. También debe invalidar CFrameWndEx::OnShowPopupMenu y reemplazar los botones de menú que requieren procesamiento especial con instancias de la clase derivada.

CMFCToolBarMenuButton::OnContextHelp

virtual BOOL OnContextHelp(CWnd* pWnd);

Parámetros

[in] pWnd

Valor devuelto

Comentarios

CMFCToolBarMenuButton::OnDraw

virtual void OnDraw(
    CDC* pDC,
    const CRect& rect,
    CMFCToolBarImages* pImages,
    BOOL bHorz = TRUE,
    BOOL bCustomizeMode = FALSE,
    BOOL bHighlight = FALSE,
    BOOL bDrawBorder = TRUE,
    BOOL bGrayDisabledButtons = TRUE);

Parámetros

[in] pDC
[in] rect
[in] pImages
[in] bHorz
[in] bCustomizeMode
[in] bHighlight
[in] bDrawBorder
[in] bGrayDisabledButtons

Comentarios

CMFCToolBarMenuButton::OnDrawOnCustomizeList

virtual int OnDrawOnCustomizeList(
    CDC* pDC,
    const CRect& rect,
    BOOL bSelected);

Parámetros

[in] pDC
[in] rect
[in] bSelected

Valor devuelto

Comentarios

CMFCToolBarMenuButton::OpenPopupMenu

Lo llama el marco cuando el usuario abre el menú desplegable de un botón de menú de la barra de herramientas.

virtual BOOL OpenPopupMenu(CWnd* pWnd=NULL);

Parámetros

pWnd
[in] Especifica la ventana que recibe los comandos de menú desplegable. Solo puede ser NULL si el botón de menú de la barra de herramientas tiene una ventana primaria.

Valor devuelto

TRUE cuando se creó y se abrió correctamente un objeto de CMFCPopupMenu (clase); en caso contrario, FALSE.

Comentarios

El marco llama a esta función cuando el usuario abre un menú desplegable desde un botón de menú de la barra de herramientas.

CMFCToolBarMenuButton::ResetImageToDefault

virtual void ResetImageToDefault();

Comentarios

CMFCToolBarMenuButton::SaveBarState

virtual void SaveBarState();

Comentarios

El marco llama a este método cuando crea un botón de barra de herramientas como resultado de una operación de arrastrar y colocar. Este método llama al método CMFCPopupMenu::SaveState del menú emergente de nivel superior, lo que provoca que el botón primario del menú emergente vuelva a crear su menú.

CMFCToolBarMenuButton::Serialize

virtual void Serialize(CArchive& ar);

Parámetros

[in] ar

Comentarios

CMFCToolBarMenuButton::SetACCData

Establece los datos de accesibilidad para el elemento de la cinta de opciones.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

Parámetros

pParent
La ventana principal para el elemento de la cinta de opciones.

data
Los datos de accesibilidad para el elemento de la cinta de opciones.

Valor devuelto

Siempre devuelve TRUE.

Comentarios

De forma predeterminada, este método establece los datos de accesibilidad para el elemento de la cinta de opciones y siempre devuelve TRUE. Invalide este método para establecer los datos de accesibilidad y devolver un valor que indique éxito o error.

CMFCToolBarMenuButton::SetMenuOnly

Especifica si el botón se dibuja como un botón de menú o un botón de expansión cuando tiene un identificador de comando válido y un submenú.

void SetMenuOnly(BOOL bMenuOnly);

Parámetros

bMenuOnly
[in] TRUE para mostrar este botón como un botón de menú cuando tiene un identificador de comando válido y un submenú; FALSE para mostrar este botón como un botón de expansión cuando tiene un identificador de comando válido y un submenú.

Comentarios

Normalmente, cuando un botón de menú de la barra de herramientas tiene un submenú y un identificador de comando, el menú aparece como un botón de expansión que tiene un botón principal con un botón adjunto de flecha hacia abajo. En cambio, si llama a este método y bMenuOnly es TRUE, el botón aparece como un único botón de menú con una flecha hacia abajo en el botón. Cuando el usuario hace clic en la flecha en cualquier modo, se abre el submenú; cuando, en cualquier modo, el usuario hace clic en la parte del botón que no es la flecha, el marco ejecuta el comando.

CMFCToolBarMenuButton::SetMenuPaletteMode

Especifica si el menú desplegable está en modo de paleta.

void SetMenuPaletteMode(
    BOOL bMenuPaletteMode=TRUE,
    int nPaletteRows=1);

Parámetros

bMenuPaletteMode
[in] Especifica si el menú desplegable está en modo de paleta.

nPaletteRows
[in] Número de filas en la paleta.

Comentarios

En el modo de paleta, todos los elementos de menú se muestran como una paleta de varias columnas. Especifique el número de filas mediante nPaletteRows.

CMFCToolBarMenuButton::SetMessageWnd

void SetMessageWnd(CWnd* pWndMessage);

Parámetros

[in] pWndMessage

Comentarios

CMFCToolBarMenuButton::SetRadio

Establece el botón de menú de la barra de herramientas para mostrar un icono de estilo de botón de radio cuando se selecciona.

virtual void SetRadio();

Comentarios

Si se dibuja el botón de menú mientras está seleccionado, llama a CMFCVisualManager::OnDrawMenuCheck para dibujar un icono de marca de verificación. De forma predeterminada, OnDrawMenuCheck solicita que el administrador visual actual dibuje una marca de verificación de estilo de casilla en el botón de menú. Después de que usted llame a este método, el administrador visual actual dibuja una marca de verificación de estilo de botón de radio en el botón de menú. Este cambio no se puede deshacer.

Si se llama a este método y se muestra el botón de menú en ese momento, se actualizará.

CMFCToolBarMenuButton::SetTearOff

Especifica el identificador de la barra desplazable del menú desplegable.

virtual void SetTearOff(UINT uiBarID);

Parámetros

uiBarID
[in] Especifica un nuevo identificador de barra desplazable.

Comentarios

Llame a este método para especificar el identificador de la barra desplazable que se crea cuando el usuario arrastra el botón de menú fuera de una barra de menús. Si el parámetro uiBarID es 0, el usuario no puede desplazar el botón de menú.

Llame a CWinAppEx::EnableTearOffMenus para habilitar la característica de menú desplazable en la aplicación.

Consulte también

Gráfico de jerarquías
Clases
CMFCToolBarButton (clase)
CMFCToolBar (clase)
CMFCPopupMenu (clase)

Compartir a través de

CMFCToolBarMenuButton (clase)

Sintaxis

Miembros

Constructores públicos

Métodos públicos

Métodos protegidos

Miembros de datos

Comentarios

Ejemplo

Jerarquía de herencia

Requisitos

CMFCToolBarMenuButton::CMFCToolBarMenuButton

Parámetros

Comentarios

Ejemplo

CMFCToolBarMenuButton::CompareWith

Parámetros

Valor devuelto

Comentarios

CMFCToolBarMenuButton::CopyFrom

Parámetros

Comentarios

CMFCToolBarMenuButton::CreateFromMenu

Parámetros

Comentarios

CMFCToolBarMenuButton::CreateMenu

Valor devuelto

Comentarios

CMFCToolBarMenuButton::CreatePopupMenu

Valor devuelto

Comentarios

CMFCToolBarMenuButton::DrawDocumentIcon

Parámetros

Comentarios

CMFCToolBarMenuButton::EnableQuickCustomize

Comentarios

CMFCToolBarMenuButton::HasButton

Valor devuelto

Comentarios

CMFCToolBarMenuButton::HaveHotBorder

Valor devuelto

Comentarios

CMFCToolBarMenuButton::IsBorder

Valor devuelto

Comentarios

CMFCToolBarMenuButton::IsClickedOnMenu

Valor devuelto

Comentarios

CMFCToolBarMenuButton::IsQuickMode

Valor devuelto

Comentarios

CMFCToolBarMenuButton::GetCommands

Valor devuelto

Comentarios

CMFCToolBarMenuButton::GetImageRect

Parámetros

CMFCToolBarMenuButton::GetPaletteRows

Valor devuelto

Comentarios

CMFCToolBarMenuButton::GetPopupMenu

Valor devuelto

Comentarios

CMFCToolBarMenuButton::IsDroppedDown

Valor devuelto

CMFCToolBarMenuButton::IsEmptyMenuAllowed

Valor devuelto

Comentarios

CMFCToolBarMenuButton::IsExclusive

Valor devuelto

Comentarios

CMFCToolBarMenuButton::IsMenuPaletteMode

Valor devuelto

Comentarios

CMFCToolBarMenuButton::IsTearOffMenu

Valor devuelto

Comentarios

CMFCToolBarMenuButton::m_bAlwaysCallOwnerDraw

Comentarios

CMFCToolBarMenuButton::OnAfterCreatePopupMenu