CMDIFrameWndEx::EnableMDITabs

Ativa ou desativa o recurso guias MDI para a janela de quadro MDI.Quando ativado, a janela do quadro exibe uma guia para cada janela filho MDI.

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 se as guias estão habilitadas.

  • bIcons
    Especifica se os ícones devem ser exibidas nas guias.

  • tabLocation
    Especifica a localização dos rótulos de guia.

  • bTabCloseButton
    Especifica se exibe os botões Fechar guia.

  • style
    Especifica o estilo das guias.Use STYLE_3D_SCROLLED para guias regulares ou STYLE_3D_ONENOTE para Microsoft OneNote guias.

  • bTabCustomTooltips
    Especifica se as dicas de ferramentas personalizadas estão habilitadas.

  • bActiveTabCloseButton
    If TRUE, um Fechar botão será exibido na guia ativo em vez de no canto direito da área de guia.

Comentários

telefonar Esse método para ativar ou desabilitar o MDI guias recurso para a janela de quadro MDI.Quando ativado, todas sistema autônomo janelas filho são exibidas sistema autônomo guias.

Os rótulos de guia podem ser localizados na parte superior ou inferior do quadro, dependendo da configuração do parâmetro tabLocation. Você pode especificar qualquer um dos CMFCTabCtrl::LOCATION_BOTTOM (a configuração padrão) ou CMFCTabCtrl::LOCATION_TOP.

If bTabCustomTooltips é TRUE, um AFX_WM_ON_GET_TAB_TOOLTIP mensagem será enviada para a janela do quadro principal. Seu código pode tratar essa mensagem e fornecer a estrutura com dicas de ferramentas personalizadas para guias MDI.

Exemplo

O exemplo a seguir mostra como EnableMDITabs é usado na Exemplo do MDITabsDemo: MFC aplicativo MDI com guias.

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

Cabeçalho: afxMDIFrameWndEx.h

Consulte também

Conceitos

Gráfico de hierarquia do MFC

Referência

Classe CMDIFrameWndEx