CMFCMenuBar (clase)
Una barra de menús que implementa el acoplamiento. 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 CMFCMenuBar : public CMFCToolbar
Miembros
Métodos públicos
| Nombre | Descripción |
|---|---|
| CMFCMenuBar::AdjustLocations | (Invalida CMFCToolBar::AdjustLocations). |
| CMFCMenuBar::AllowChangeTextLabels | Especifica si las etiquetas de texto se pueden mostrar en imágenes de los botones de la barra de herramientas. (Invalida CMFCToolBar::AllowChangeTextLabels.) |
| CMFCMenuBar::AllowShowOnPaneMenu | (Invalida CPane::AllowShowOnPaneMenu). |
| CMFCMenuBar::CalcFixedLayout | Calcula el tamaño horizontal de la barra de herramientas. (Invalida CMFCToolBar::CalcFixedLayout.) |
| CMFCMenuBar::CalcLayout | (Invalida CMFCToolBar::CalcLayout). |
| CMFCMenuBar::CalcMaxButtonHeight | Calcula el alto máximo de los botones de la barra de herramientas. (Invalida CMFCToolBar::CalcMaxButtonHeight.) |
| CMFCMenuBar::CanBeClosed | Especifica si un usuario puede cerrar la barra de herramientas. (Invalida CMFCToolBar::CanBeClosed.) |
| CMFCMenuBar::CanBeRestored | Determina si el sistema puede restaurar una barra de herramientas a su estado original después de la personalización. (Invalida CMFCToolBar::CanBeRestored.) |
| CMFCMenuBar::Create | Crea un control de menú y lo asocia a un objeto CMFCMenuBar. |
| CMFCMenuBar::CreateEx | Crea un objeto CMFCMenuBar con opciones de estilo adicionales. |
| CMFCMenuBar::CreateFromMenu | Inicializa un objeto CMFCMenuBar. Acepta un parámetro HMENU que actúa como plantilla para un CMFCMenuBar rellenado. |
| CMFCMenuBar::EnableHelpCombobox | Habilita un cuadro combinado Ayuda que se encuentra en el lado derecho de la barra de menús. |
| CMFCMenuBar::EnableMenuShadows | Especifica si se muestran sombras para los menús emergentes. |
| CMFCMenuBar::GetAvailableExpandSize | (Invalida CPane::GetAvailableExpandSize.) |
| CMFCMenuBar::GetColumnWidth | Devuelve el ancho de los botones de la barra de herramientas. (Invalida CMFCToolBar::GetColumnWidth.) |
| CMFCMenuBar::GetDefaultMenu | Devuelve un identificador al menú original del archivo de recursos. |
| CMFCMenuBar::GetDefaultMenuResId | Devuelve el identificador de recurso del menú original del archivo de recursos. |
| CMFCMenuBar::GetFloatPopupDirection | |
| CMFCMenuBar::GetForceDownArrows | |
| CMFCMenuBar::GetHelpCombobox | Devuelve un puntero al cuadro combinado Ayuda . |
| CMFCMenuBar::GetHMenu | Devuelve el identificador al menú que está asociado al objeto CMFCMenuBar. |
| CMFCMenuBar::GetMenuFont | Devuelve la fuente global actual para los objetos de menú. |
| CMFCMenuBar::GetMenuItem | Devuelve el botón de la barra de herramientas asociado al índice de elemento proporcionado. |
| CMFCMenuBar::GetRowHeight | Devuelve el alto de los botones de la barra de herramientas. (Invalida CMFCToolBar::GetRowHeight.) |
| CMFCMenuBar::GetSystemButton | |
| CMFCMenuBar::GetSystemButtonsCount | |
| CMFCMenuBar::GetSystemMenu | |
| CMFCMenuBar::HighlightDisabledItems | Indica si los elementos de menú deshabilitados están resaltados. |
| CMFCMenuBar::IsButtonExtraSizeAvailable | Determina si la barra de herramientas puede mostrar botones que tienen bordes extendidos. (Invalida CMFCToolBar::IsButtonExtraSizeAvailable.) |
| CMFCMenuBar::IsHighlightDisabledItems | Indica si los elementos de menú deshabilitados están resaltados. |
| CMFCMenuBar::IsMenuShadows | Indica si las sombras se dibujan para los menús emergentes. |
| CMFCMenuBar::IsRecentlyUsedMenus | Indica si los comandos de menú usados recientemente se muestran en la barra de menús. |
| CMFCMenuBar::IsShowAllCommands | Indica si los menús emergentes muestran todos los comandos. |
| CMFCMenuBar::IsShowAllCommandsDelay | Indica si los menús muestran todos los comandos después de un breve retraso. |
| CMFCMenuBar::LoadState | Carga el estado del objeto CMFCMenuBar desde el registro. |
| CMFCMenuBar::OnChangeHot | Lo llama el marco cuando un usuario selecciona un botón en la barra de herramientas. (Invalida CMFCToolBar::OnChangeHot.) |
| CMFCMenuBar::OnDefaultMenuLoaded | El marco llama a este elemento cuando una ventana de marco carga el menú predeterminado desde el archivo de recursos. |
| CMFCMenuBar::OnSendCommand | (Invalida CMFCToolBar::OnSendCommand). |
| CMFCMenuBar::OnSetDefaultButtonText | El marco llama a este elemento cuando un menú está en modo de personalización y el usuario cambia el texto de un elemento de menú. |
| CMFCMenuBar::OnToolHitTest | (Invalida CMFCToolBar::OnToolHitTest). |
| CMFCMenuBar::PreTranslateMessage | (Invalida CMFCToolBar::PreTranslateMessage). |
| CMFCMenuBar::RestoreOriginalstate | El marco llama a este elemento cuando un menú está en modo de personalización y el usuario selecciona Restablecer de la barra de menús. |
| CMFCMenuBar::SaveState | Guarda el estado del objeto CMFCMenuBar en el registro. |
| CMFCMenuBar::SetDefaultMenuResId | Establece el menú original en el archivo de recursos. |
| CMFCMenuBar::SetForceDownArrows | |
| CMFCMenuBar::SetMaximizeMode | El marco llama a este elemento cuando una ventana secundaria de MDI cambia su modo de presentación. Si la ventana secundaria de MDI se maximiza recientemente o deja de estar maximizada, este método actualiza la barra de menús. |
| CMFCMenuBar::SetMenuButtonRTC | Establece la información de clase de runtime que se genera cuando el usuario crea dinámicamente botones de menú. |
| CMFCMenuBar::SetMenuFont | Establece la fuente de todos los menús de la aplicación. |
| CMFCMenuBar::SetRecentlyUsedMenus | Especifica si una barra de menús muestra comandos de menú usados recientemente. |
| CMFCMenuBar::SetShowAllCommands | Especifica si la barra de menús muestra todos los comandos. |
Comentarios
La clase CMFCMenuBar es una barra de menús que implementa la funcionalidad de acoplamiento. Se parece a una barra de herramientas, aunque no se puede cerrar, siempre se muestra.
CMFCMenuBar admite la opción de mostrar objetos de elemento de menú usados recientemente. Si esta opción está habilitada, CMFCMenuBar muestra solo un subconjunto de los comandos disponibles en la primera vista. A partir de entonces, los comandos usados recientemente se muestran junto con el subconjunto original de comandos. Además, el usuario siempre puede expandir el menú para ver todos los comandos disponibles. Por lo tanto, cada comando disponible está configurado para mostrarse constantemente o para mostrar solo si se ha seleccionado recientemente.
Para usar un objeto CMFCMenuBar, insértelo en el objeto de marco de ventana principal. Al procesar el mensaje WM_CREATE, llame al método CMFCMenuBar::Create o CMFCMenuBar::CreateEx. Independientemente de la función de creación que use, pase un puntero a la ventana de marco principal. A continuación, habilite el acoplamiento mediante una llamada a CFrameWndEx::EnableDocking. Acople este menú llamando a CFrameWndEx::DockPane.
Ejemplo
En el siguiente ejemplo se muestra cómo usar los distintos métodos en la clase CMFCMenuBar . En el ejemplo se muestra cómo establecer el estilo del panel, habilitar el botón Personalizar, habilitar un cuadro ayuda, habilitar sombras para menús emergentes y actualizar la barra de menús. Este fragmento de código forma parte del ejemplo de demostración de IE.
CMFCMenuBar m_wndMenuBar;
m_wndMenuBar.SetPaneStyle(m_wndMenuBar.GetPaneStyle() | CBRS_SIZE_DYNAMIC);
m_wndMenuBar.EnableCustomizeButton(TRUE, -1, _T(""));
// first parameter is the command ID for the button of the Help combo box
// third parameter is the width of the button for the combo box in pixels.
m_wndMenuBar.EnableHelpCombobox(1, _T("enter text here"), 30);
m_wndMenuBar.EnableMenuShadows();
m_wndMenuBar.SetMaximizeMode(true);
Jerarquía de herencia
CMFCMenuBar
Requisitos
Encabezado: afxmenubar.h
CMFCMenuBar::AdjustLocations
Ajusta las posiciones de los elementos de menú en la barra de menús.
virtual void AdjustLocations();
Comentarios
CMFCMenuBar::AllowChangeTextLabels
Determina si las etiquetas de texto se permiten en las imágenes de la barra de menús.
virtual BOOL AllowChangeTextLabels() const;
Valor devuelto
Devuelve TRUE si el usuario puede elegir mostrar etiquetas de texto en imágenes.
Comentarios
CMFCMenuBar::AllowShowOnPaneMenu
virtual BOOL AllowShowOnPaneMenu() const;
Valor devuelto
Comentarios
CMFCMenuBar::CalcFixedLayout
virtual CSize CalcFixedLayout(
BOOL bStretch,
BOOL bHorz);
Parámetros
[in] bStretch
[in] bHorz
Valor devuelto
Comentarios
CMFCMenuBar::CalcLayout
virtual CSize CalcLayout(
DWORD dwMode,
int nLength = -1);
Parámetros
[in] dwMode
[in] nLength
Valor devuelto
Comentarios
CMFCMenuBar::CalcMaxButtonHeight
virtual int CalcMaxButtonHeight();
Valor devuelto
Comentarios
CMFCMenuBar::CanBeClosed
virtual BOOL CanBeClosed() const;
Valor devuelto
Comentarios
CMFCMenuBar::CanBeRestored
virtual BOOL CanBeRestored() const;
Valor devuelto
Comentarios
CMFCMenuBar::Create
Crea un control de menú y lo asocia a un objeto CMFCMenuBar.
virtual BOOL Create(
CWnd* pParentWnd,
DWORD dwStyle = AFX_DEFAULT_TOOLBAR_STYLE,
UINT nID = AFX_IDW_MENUBAR);
Parámetros
pParentWnd
[in] Puntero a la ventana primaria del nuevo objeto CMFCMenuBar.
dwStyle
[in] Estilo de la nueva barra de menús.
Nid
[in] Identificador de la ventana secundaria de la barra de menús.
Valor devuelto
TRUE si es correcto; en caso contrario, FALSE.
Comentarios
Después de construir un objeto CMFCMenuBar, debe llamar a Create. Este método crea el control CMFCMenuBar y lo adjunta al objeto CMFCMenuBar.
Para obtener más información sobre los estilos de barra de herramientas, vea CBasePane::SetPaneStyle.
CMFCMenuBar::CreateEx
Crea un objeto CMFCMenuBar con estilos extendidos especificados.
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_MENUBAR);
Parámetros
pParentWnd
[in] Puntero a la ventana primaria del nuevo objeto CMFCMenuBar.
dwCtrlStyle
[in] Estilos adicionales para la nueva barra de menús.
dwStyle
[in] Estilo principal de la nueva barra de menús.
rcBorders
[in] Parámetro CRect que especifica los tamaños de los bordes del objeto CMFCMenuBar.
Nid
[in] Identificador de la ventana secundaria de la barra de menús.
Valor devuelto
Distinto de cero si el método es correcto; en caso contrario, 0.
Comentarios
Debe usar esta función en lugar de CMFCMenuBar::Create cuando desee especificar estilos además del estilo de la barra de herramientas. Algunos estilos adicionales usados con frecuencia son TBSTYLE_TRANSPARENT y CBRS_TOP.
Para obtener listas de estilos adicionales, vea Estilos de control y botón de la barra de herramientas, estilos de control comunes y estilos de ventana comunes.
Ejemplo
En el siguiente ejemplo se muestra cómo se utiliza el método CreateEx de la clase CMFCMenuBar. Este fragmento de código forma parte del ejemplo de demostración de IE.
CMFCMenuBar m_wndMenuBar;
// The this pointer points to CMainFrame class which extends the CFrameWnd class.
if (!m_wndMenuBar.CreateEx(this, TBSTYLE_TRANSPARENT))
{
TRACE0("Failed to create menubar\n");
return -1; // fail to create
}
CMFCMenuBar::CreateFromMenu
Inicializa un objeto CMFCMenuBar . Este método modela el objeto CMFCMenuBar después de un parámetro HMENU.
virtual void CreateFromMenu(
HMENU hMenu,
BOOL bDefaultMenu = FALSE,
BOOL bForceUpdate = FALSE);
Parámetros
hMenu
[in] Identificador de un recurso de menú. CreateFromMenu usa este recurso como plantilla para CMFCMenuBar.
bDefaultMenu
[in] Valor booleano que indica si el nuevo menú es el predeterminado.
bForceUpdate
[in] Valor booleano que indica si este método fuerza una actualización del menú.
Comentarios
Use este método si desea que un control de menú tenga los mismos elementos de menú que un recurso de menú. Se llama a este método después de llamar a CMFCMenuBar::Create o CMFCMenuBar::CreateEx.
CMFCMenuBar::EnableHelpCombobox
Habilita un cuadro combinado Ayuda que se encuentra en el lado derecho de la barra de menús.
void EnableHelpCombobox(
UINT uiID,
LPCTSTR lpszPrompt = NULL,
int nComboBoxWidth = 150);
Parámetros
uiID
[in] Identificador de comando del botón del cuadro combinado Ayuda .
lpszPrompt
[in] Cadena que contiene el texto que el marco muestra en el cuadro combinado si está vacío y no está activo. Por ejemplo, "Escriba el texto aquí".
nComboBoxWidth
[in] Ancho del botón del cuadro combinado en píxeles.
Comentarios
El cuadro combinado Ayuda es similar al cuadro combinado Ayuda de la barra de menús de Microsoft Word.
Cuando se llama a este método con uiID establecido en 0, este método oculta el cuadro combinado. De lo contrario, este método muestra automáticamente el cuadro combinado en el lado derecho de la barra de menús. Después de llamar a este método, llame a CMFCMenuBar::GetHelpCombobox para obtener un puntero al objeto CMFCToolBarComboBoxButton insertado.
CMFCMenuBar::EnableMenuShadows
Habilita sombras para menús emergentes.
static void EnableMenuShadows(BOOL bEnable = TRUE);
Parámetros
bEnable
[in] Parámetro booleano que indica si las sombras deben habilitarse para los menús emergentes.
Comentarios
El algoritmo que usa este método es complejo y puede reducir el rendimiento de la aplicación en sistemas más lentos.
CMFCMenuBar::GetAvailableExpandSize
virtual int GetAvailableExpandSize() const;
Valor devuelto
Comentarios
CMFCMenuBar::GetColumnWidth
virtual int GetColumnWidth() const;
Valor devuelto
Comentarios
CMFCMenuBar::GetDefaultMenu
Recupera un identificador en el menú original. El marco carga el menú original desde el archivo de recursos.
HMENU GetDefaultMenu() const;
Valor devuelto
Identificador de un recurso de menú.
Comentarios
Si la aplicación personaliza un menú, puede usar este método para recuperar un identificador en el menú original.
CMFCMenuBar::GetDefaultMenuResId
Recupera el identificador de recursos del menú predeterminado.
UINT GetDefaultMenuResId() const;
Valor devuelto
Un id. de recurso de menú.
Comentarios
El marco carga el menú predeterminado para el objeto CMFCMenuBar desde el archivo de recursos.
CMFCMenuBar::GetFloatPopupDirection
int GetFloatPopupDirection(CMFCToolBarMenuButton* pButton);
Parámetros
[in] pButton
Valor devuelto
Comentarios
CMFCMenuBar::GetForceDownArrows
BOOL GetForceDownArrows();
Valor devuelto
Comentarios
CMFCMenuBar::GetHelpCombobox
Devuelve un puntero al cuadro combinado Ayuda .
CMFCToolBarComboBoxButton* GetHelpCombobox();
Valor devuelto
Un puntero al cuadro combinado Ayuda . NULL si el cuadro combinado Ayuda está oculto o no está habilitado.
Comentarios
El cuadro combinado Ayuda se encuentra en el lado derecho de la barra de menús. Llame al método CMFCMenuBar::EnableHelpCombobox para habilitar este cuadro combinado.
CMFCMenuBar::GetHMenu
Recupera el identificador del menú adjunto al objeto CMFCMenuBar .
HMENU GetHMenu() const;
CMFCMenuBar::GetMenuFont
Recupera la fuente de menú actual.
static const CFont& GetMenuFont(BOOL bHorz = TRUE);
Parámetros
bHorz
[in] Parámetro booleano que especifica si se va a devolver la fuente horizontal o vertical. TRUE indica la fuente horizontal.
Valor devuelto
Puntero a un parámetro CFont que contiene la fuente de la barra de menús actual.
Comentarios
La fuente devuelta es un parámetro global para la aplicación. Se mantienen dos fuentes globales para todos los objetos CMFCMenuBar. Estas fuentes independientes se usan para barras de menús horizontales y verticales.
CMFCMenuBar::GetMenuItem
Recupera un objeto CMFCToolBarButton en una barra de menús basada en el índice del elemento.
CMFCToolBarButton* GetMenuItem(int iItem) const;
Parámetros
iItem
[in] Índice del elemento de menú que se va a devolver.
Valor devuelto
Un puntero al objeto CMFCToolBarButton que coincide con el índice especificado por iItem. NULL si el índice no es válido.
CMFCMenuBar::GetRowHeight
virtual int GetRowHeight() const;
Valor devuelto
Comentarios
CMFCMenuBar::GetSystemButton
CMFCToolBarMenuButtonsButton* GetSystemButton(
UINT uiBtn,
BOOL bByCommand = TRUE) const;
Parámetros
[in] uiBtn
[in] bByCommand
Valor devuelto
Comentarios
CMFCMenuBar::GetSystemButtonsCount
int GetSystemButtonsCount() const;
Valor devuelto
Comentarios
CMFCMenuBar::GetSystemMenu
CMFCToolBarSystemMenuButton* GetSystemMenu() const;
Valor devuelto
Comentarios
CMFCMenuBar::HighlightDisabledItems
Controla si el marco resalta los elementos de menú deshabilitados.
static void HighlightDisabledItems(BOOL bHighlight = TRUE);
Parámetros
bHighlight
[in] Parámetro booleano que indica si el marco resalta elementos de menú no disponibles.
Comentarios
De forma predeterminada, el marco no resalta los elementos de menú no disponibles cuando el usuario coloca el puntero del mouse sobre ellos.
CMFCMenuBar::IsButtonExtraSizeAvailable
virtual BOOL IsButtonExtraSizeAvailable() const;
Valor devuelto
Comentarios
CMFCMenuBar::IsHighlightDisabledItems
Indica si el marco resalta los elementos de menú no disponibles.
static BOOL IsHighlightDisabledItems();
Valor devuelto
TRUE si los elementos de menú no disponibles están resaltados; en caso contrario, FALSE.
Comentarios
De forma predeterminada, el marco no resalta los elementos de menú no disponibles cuando el usuario coloca el puntero del mouse sobre ellos. Use el método CMFCMenuBar::HighlightDisabledItems para habilitar esta característica.
CMFCMenuBar::IsMenuShadows
Indica si el marco dibuja sombras para los menús emergentes.
static BOOL IsMenuShadows();
Valor devuelto
TRUE si el marco dibuja sombras de menús; en caso contrario, FALSE.
Comentarios
Use el método CMFCMenuBar::EnableMenuShadows para habilitar o deshabilitar esta característica.
CMFCMenuBar::IsRecentlyUsedMenus
Indica si los comandos de menú usados recientemente se muestran en la barra de menús.
static BOOL IsRecentlyUsedMenus();
Valor devuelto
Distinto de cero si el objeto CMFCMenuBar muestra comandos de menú usados recientemente; en caso contrario, 0.
Comentarios
Use la función CMFCMenuBar::SetRecentlyUsedMenus para controlar si la barra de menús muestra comandos de menú usados recientemente.
CMFCMenuBar::IsShowAllCommands
Indica si los menús muestran todos los comandos.
static BOOL IsShowAllCommands();
Valor devuelto
Distinto de cero si CMFCMenuBar muestra todos los comandos; en caso contrario, 0.
Comentarios
Un objeto CMFCMenuBar se puede configurar para mostrar todos los comandos o mostrar solo un subconjunto de comandos. Para más información sobre esta característica, vea CMFCMenuBar (clase).
IsShowAllCommands le indicará cómo se configura esta característica para el objeto CMFCMenuBar. Para controlar qué comandos de menú se muestran, use los métodos CMFCMenuBar::SetShowAllCommands y CMFCMenuBar::SetRecentlyUsedMenus.
CMFCMenuBar::IsShowAllCommandsDelay
Indica si el objeto CMFCMenuBar muestra todos los comandos después de un breve retraso.
static BOOL IsShowAllCommandsDelay();
Valor devuelto
Distinto de cero si la barra de menús muestra menús completos después de un breve retraso; de lo contrario, 0.
Comentarios
Al configurar una barra de menús para mostrar elementos usados recientemente, la barra de menús muestra el menú completo de una de estas dos maneras:
Muestra el menú completo después de un retraso programado desde el momento en que el usuario mantiene el cursor sobre la flecha situada en la parte inferior del menú.
Muestra el menú completo después de que el usuario haga clic en la flecha situada en la parte inferior del menú.
De forma predeterminada, todos los objetos CMFCMenuBar usan la opción para mostrar el menú completo después de un breve retraso. Esta opción no se puede cambiar con programación en la clase CMFCMenuBar. Sin embargo, un usuario puede cambiar el comportamiento durante la personalización de la barra de herramientas mediante el cuadro de diálogo Personalizar .
CMFCMenuBar::LoadState
Carga el estado de la barra de menús desde el Registro de Windows.
virtual BOOL LoadState(
LPCTSTR lpszProfileName = NULL,
int nIndex = -1,
UINT uiID = (UINT)-1);
Parámetros
lpszProfileName
[in] Cadena que contiene la ruta de acceso de una clave del Registro de Windows.
nIndex
[in] Identificador de control de la barra de menús.
uiID
[in] Valor reservado.
Valor devuelto
TRUE si el método se aplicó correctamente; de lo contrario, FALSE.
Comentarios
Use el método CMFCMenuBar::SaveState para guardar el estado de la barra de menús en el Registro. La información guardada incluye los elementos de menú, el estado de acoplamiento y la posición de la barra de menús.
En la mayoría de los casos, la aplicación no llama a LoadState. El marco llama a este método cuando inicializa el área de trabajo.
CMFCMenuBar::OnChangeHot
virtual void OnChangeHot(int iHot);
Parámetros
[in] iHot
Comentarios
CMFCMenuBar::OnDefaultMenuLoaded
El marco llama a este método cuando carga el recurso de menú desde el archivo de recursos.
virtual void OnDefaultMenuLoaded(HMENU hMenu);
Parámetros
hMenu
[in] Identificador del menú asociado al objeto CMFCMenuBar.
Comentarios
La implementación predeterminada de esta función no hace nada. Invalide esta función para ejecutar código personalizado después de que el marco cargue un recurso de menú desde el archivo de recursos.
CMFCMenuBar::OnSendCommand
virtual BOOL OnSendCommand(const CMFCToolBarButton* pButton);
Parámetros
[in] pButton
Valor devuelto
Comentarios
CMFCMenuBar::OnSetDefaultButtonText
El marco llama a este método cuando el usuario cambia el texto de un elemento en la barra de menús.
virtual BOOL OnSetDefaultButtonText(CMFCToolBarButton* pButton);
Parámetros
pButton
[in] Puntero al objeto CMFCToolBarButton que el usuario quiere personalizar.
Valor devuelto
TRUE si el marco aplica los cambios del usuario a la barra de menús; en caso contrario, FALSE.
Comentarios
La implementación predeterminada de este método cambia el texto del botón al texto que proporciona el usuario.
CMFCMenuBar::OnToolHitTest
virtual INT_PTR OnToolHitTest(
CPoint point,
TOOLINFO* pTI) const;
Parámetros
[in] point
[in] pTI
Valor devuelto
Comentarios
CMFCMenuBar::PreTranslateMessage
virtual BOOL PreTranslateMessage(MSG* pMsg);
Parámetros
[in] pMsg
Valor devuelto
Comentarios
CMFCMenuBar::RestoreOriginalstate
El marco llama a este elemento cuando el usuario selecciona Restablecer en el cuadro de diálogo Personalizar .
virtual BOOL RestoreOriginalstate();
Valor devuelto
Distinto de cero si el método es correcto; en caso contrario, 0.
Comentarios
Se llama a este método cuando el usuario selecciona Restablecer en el menú de personalización. También puede llamar manualmente a este método para restablecer mediante programación el estado de la barra de menús. El marco carga el menú original desde el archivo de recursos.
Invalide este método si desea realizar cualquier procesamiento cuando el usuario seleccione la opción Restablecer .
CMFCMenuBar::SaveState
Guarda el estado del objeto CMFCMenuBar en el Registro de Windows.
virtual BOOL SaveState (
LPCTSTR lpszProfileName = NULL,
int nIndex = -1,
UINT uiID = (UINT)-1);
Parámetros
lpszProfileName
[in] Cadena que contiene la ruta de acceso de una clave del Registro de Windows.
nIndex
[in] Identificador de control de la barra de menús.
uiID
[in] Valor reservado.
Valor devuelto
TRUE si es correcto; en caso contrario, FALSE.
Comentarios
Normalmente, la aplicación no llama a SaveState. El marco llama a este método cuando se serializa el área de trabajo. Para obtener más información, vea CWinAppEx::SaveState.
La información guardada incluye los elementos de menú, el estado de acoplamiento y la posición de la barra de menús.
CMFCMenuBar::SetDefaultMenuResId
Establece el menú predeterminado para un objeto CMFCMenuBar basado en el identificador de recurso.
void SetDefaultMenuResId(UINT uiResId);
Parámetros
uiResId
[in] Identificador de recurso del nuevo menú predeterminado.
Comentarios
El método CMFCMenuBar::RestoreOriginalstate restaura el menú predeterminado desde el archivo de recursos.
Use el método CMFCMenuBar::GetDefaultMenuResId para recuperar el menú predeterminado sin restaurarlo.
CMFCMenuBar::SetForceDownArrows
void SetForceDownArrows(BOOL bValue);
Parámetros
[in] bValue
Comentarios
CMFCMenuBar::SetMaximizeMode
El marco llama a este método cuando un MDI cambia su modo de presentación y se debe actualizar la barra de menús.
void SetMaximizeMode(
BOOL bMax,
CWnd* pWnd = NULL,
BOOL bRecalcLayout = TRUE);
Parámetros
bMax
[in] Valor booleano que especifica el modo. Para obtener más información, consulte la sección Comentarios.
pWnd
[in] Puntero a la ventana secundaria MDI que está cambiando.
bRecalcLayout
[in] Valor booleano que especifica si el diseño de la barra de menús se debe volver a calcular inmediatamente.
Comentarios
Cuando se maximiza una ventana secundaria MDI, una barra de menús adjunta a la ventana marco principal de MDI muestra el menú del sistema y los botones Minimizar, Maximizar y Cerrar . Si bMax es TRUE y pWnd no es NULL, la ventana secundaria MDI se maximiza y la barra de menús debe incorporar los controles adicionales. De lo contrario, la barra de menús vuelve a su estado normal.
CMFCMenuBar::SetMenuButtonRTC
Establece la información de la clase en tiempo de ejecución que usa el marco cuando el usuario crea botones de menú.
void SetMenuButtonRTC(CRuntimeClass* pMenuButtonRTC);
Parámetros
pMenuButtonRTC
[in] Información de CRuntimeClass para una clase derivada de CMFCMenuButton (clase).
Comentarios
Cuando un usuario agrega nuevos botones a la barra de menús, el marco crea dinámicamente los botones. De forma predeterminada, crea objetos CMFCMenuButton. Invalide este método para cambiar el tipo de objetos de botón que crea el marco de trabajo.
CMFCMenuBar::SetMenuFont
Establece la fuente de todas las barras de menú de la aplicación.
static BOOL SetMenuFont(
LPLOGFONT lpLogFont,
BOOL bHorz = TRUE);
Parámetros
lpLogFont
[in] Puntero a una estructura LOGFONT que define la fuente que se va a establecer.
bHorz
[in] TRUE si desea que el parámetro lpLogFont se use para la fuente vertical, FALSE si desea que se use para la fuente horizontal.
Valor devuelto
TRUE si el método se aplicó correctamente; de lo contrario, FALSE.
Comentarios
Se usan dos fuentes para todos los objetos CMFCMenuBar. Estas fuentes independientes se usan para barras de menús horizontales y verticales.
La configuración de fuente son variables globales y afectan a todos los objetos CMFCMenuBar.
CMFCMenuBar::SetRecentlyUsedMenus
Controla si una barra de menús muestra comandos de menú usados recientemente.
static void SetRecentlyUsedMenus (BOOL bOn = TRUE);
Parámetros
bOn
[in] Valor booleano que controla si se muestran los comandos de menú usados recientemente.
CMFCMenuBar::SetShowAllCommands
Controla si un menú muestra todos los comandos disponibles.
static void SetShowAllCommands(BOOL bShowAllCommands = TRUE);
Parámetros
bShowAllCommands
[in] Parámetro booleano que especifica si el menú emergente muestra todos los comandos de menú.
Comentarios
Si un menú no muestra todos los comandos de menú, oculta los comandos que rara vez se usan. Para obtener más información sobre cómo mostrar comandos de menú, vea CMFCMenuBar (clase).
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de