CMDIFrameWndEx::EnableMDITabs

啟用或停用 MDI 框架視窗的 MDI 索引標籤功能。 啟用時，框架視窗中顯示每個 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 
);

參數

• bEnable
  指定索引標籤是否啟用。

• bIcons
  指定是否在索引標籤應顯示圖示。

• tabLocation
  指定索引標籤的標籤的位置。

• bTabCloseButton
  指定是否顯示索引標籤的 [關閉] 按鈕。

• style
  指定索引標籤樣式。 針對規則選項使用 STYLE_3D_SCROLLED 或 STYLE_3D_ONENOTE 為 Microsoft OneNote 索引標籤。

• bTabCustomTooltips
  指定自訂工具提示是否已啟用。

• bActiveTabCloseButton
  如果 TRUE， [關閉] 按鈕在作用中的索引標籤會顯示而不是在索引標籤區域的右下角。

備註

呼叫這個方法會啟用或停用 MDI 框架視窗的 MDI 索引標籤功能。 啟用時，所有子視窗中顯示為索引標籤。

索引標籤的標籤可以位於框架上方或下方，根據參數 tabLocation的設定。 您可以指定 CMFCTabCtrl::LOCATION_BOTTOM (預設值) 或 CMFCTabCtrl::LOCATION_TOP。

如果 bTabCustomTooltips 是 TRUE， AFX_WM_ON_GET_TAB_TOOLTIP 訊息將會傳送至主框架視窗。 您的程式碼可以處理這個訊息和提供這個架構提供自訂工具提示的 MDI 索引標籤。

範例

下列範例顯示 EnableMDITabs 如何在 MDITabsDemo 範例:MFC 索引標籤式的 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;

需求

標題: afxMDIFrameWndEx.h

請參閱

參考

CMDIFrameWndEx 類別

階層架構圖