Share via


CMDIFrameWndEx::EnableMDITabs

Habilita o deshabilita la característica de las pestañas MDI para la ventana de marco MDI.Cuando está habilitada, la ventana cuadro muestra una ficha para cada ventana MDI secundaria.

void EnableMDITabs(
   BOOL bEnable=TRUE,
   BOOL bIcons=TRUE,
   CMFCTabCtrl::Location tabLocation=CMFCTabCtrl::LOCATION_BOTTOM,
   BOOL bTabCloseButton=FALSE,
   CMFCTabCtrl::Style style=CMFCTabCtrl::STYLE_3D_SCROLLED,
   BOOL bTabCustomTooltips=FALSE,
   BOOL bActiveTabCloseButton=FALSE 
);

Parámetros

  • bEnable
    Especifica si las pestañas están habilitadas.

  • bIcons
    Especifica si los iconos se deben mostrar en las pestañas.

  • tabLocation
    Especifica la ubicación de las etiquetas de la pestaña.

  • bTabCloseButton
    Especifica si mostrar botones cerca de la pestaña.

  • style
    Especifica el estilo de pestañas.Utilice STYLE_3D_SCROLLED para las pestañas regulares o STYLE_3D_ONENOTE para las pestañas de Microsoft OneNote.

  • bTabCustomTooltips
    Especifica si la información sobre herramientas personalizadas están habilitadas.

  • bActiveTabCloseButton
    Si TRUE, botón de Cerrar se muestra en la pestaña activa en lugar de en la esquina correcta del área de la pestaña.

Comentarios

Llame a este método para habilitar o deshabilitar la característica de las pestañas MDI para la ventana de marco MDI.Cuando están habilitadas, todas las ventanas secundarias se muestran como pestañas.

Las etiquetas de la pestaña se pueden encontrar en la parte superior o inferior del marco, según el valor del parámetro tabLocation.Puede especificar CMFCTabCtrl::LOCATION_BOTTOM (configuración predeterminada) o CMFCTabCtrl::LOCATION_TOP.

Si bTabCustomTooltips es TRUE, un mensaje de AFX_WM_ON_GET_TAB_TOOLTIP se envía a la ventana de marco principal.El código puede controlar este mensaje y proporcionar el marco con la información sobre herramientas personalizadas para las pestañas de MDI.

Ejemplo

El ejemplo siguiente se muestra cómo EnableMDITabs se utiliza en ejemplo de MDITabsDemo: MFC con la aplicación MDI.

void CMainFrame::UpdateMDITabs (BOOL bResetMDIChild)
{
    CMDITabInfo params;
    HWND hwndActive = NULL;

    switch (theApp.m_Options.m_nMDITabsType)
    {
    case CMDITabOptions::None:
        {
            BOOL bCascadeMDIChild = FALSE;

            if (IsMDITabbedGroup ())
            {
                EnableMDITabbedGroups (FALSE, params);
                bCascadeMDIChild = TRUE;
            }
            else if (AreMDITabs ())
            {
                EnableMDITabs (FALSE);
                bCascadeMDIChild = TRUE;
            }

            if (bCascadeMDIChild)
            {
                // CMDIClientAreaWnd m_wndClientArea
                hwndActive = (HWND) m_wndClientArea.SendMessage (WM_MDIGETACTIVE);
                m_wndClientArea.PostMessage (WM_MDICASCADE);
                m_wndClientArea.UpdateTabs( false );
                m_wndClientArea.SetActiveTab(hwndActive);
                ::BringWindowToTop (hwndActive);
            }
        }
        break;

    case CMDITabOptions::MDITabsStandard:
        hwndActive = (HWND) m_wndClientArea.SendMessage (WM_MDIGETACTIVE);
        m_wndClientArea.PostMessage (WM_MDIMAXIMIZE, LPARAM(hwndActive), 0L);
        ::BringWindowToTop (hwndActive);

        EnableMDITabs (TRUE,theApp.m_Options.m_bMDITabsIcons, theApp.m_Options.m_bTabsOnTop ? CMFCTabCtrl::LOCATION_TOP : CMFCTabCtrl::LOCATION_BOTTOM, theApp.m_Options.m_nTabsStyle);

        GetMDITabs().EnableAutoColor (theApp.m_Options.m_bTabsAutoColor);
        GetMDITabs().EnableTabDocumentsMenu (theApp.m_Options.m_bMDITabsDocMenu);
        GetMDITabs().EnableTabSwap (theApp.m_Options.m_bDragMDITabs);
        GetMDITabs().SetTabBorderSize (theApp.m_Options.m_nMDITabsBorderSize);
        GetMDITabs().SetFlatFrame (theApp.m_Options.m_bFlatFrame);
        GetMDITabs().EnableCustomToolTips (theApp.m_Options.m_bCustomTooltips);
        GetMDITabs().EnableCustomToolTips (theApp.m_Options.m_bCustomTooltips);
        GetMDITabs().EnableActiveTabCloseButton (theApp.m_Options.m_bActiveTabCloseButton);
        break;

Requisitos

encabezado: afxMDIFrameWndEx.h

Vea también

Referencia

Clase de CMDIFrameWndEx

Gráfico de jerarquía