CMDIFrameWndEx klass

Utökar funktionerna CMDIFrameWndi , ett MDI-ramfönster (Windows Multiple Document Interface).

Syntax

class CMDIFrameWndEx : public CMDIFrameWnd

Medlemmar

Offentliga metoder

Datamedlemmar

Anmärkningar

Om du vill dra nytta av utökade anpassningsfunktioner i ditt MDI-program härleder du MDI-bildrutefönstrets klass för programmet från CMDIFrameWndEx i stället för CMDIFrameWnd.

Exempel

I följande exempel härleds en klass från CMDIFrameWndEx. Det här kodfragmentet kommer från DrawClient-exemplet: MFC Ribbon-Based OLE-objektritningsprogram.

class CMainFrame : public CMDIFrameWndEx
{
   DECLARE_DYNAMIC(CMainFrame)
public:
   struct XStyle
   {
      COLORREF clrFill;
      COLORREF clrLine;
   };

public:
   CMainFrame();

   // Attributes
public:
   CMFCRibbonBar *GetRibbonBar() { return &m_wndRibbonBar; }

   // Operations
public:
   void UpdateUI(CDrawView *pCurrView);
   void UpdateContextTab(CDrawView *pCurrView);
   void UpdateContextTabFromObject(CDrawObjList &list);

   COLORREF GetColorFromColorButton(int nButtonID);
   int GetWeightFromLineWeight(int nButtonID);
   BOOL GetStyleFromStyles(XStyle &style);

   void SetRibbonContextCategory(UINT uiCategoryID);
   void ActivateRibbonContextCategory(UINT uiCategoryID);

   // Implementation
public:
   virtual ~CMainFrame();
#ifdef _DEBUG
   virtual void AssertValid() const;
   virtual void Dump(CDumpContext &dc) const;
#endif

protected:
   // control bar embedded members
   CMFCRibbonStatusBar m_wndStatusBar;
   CMFCRibbonBar m_wndRibbonBar;

   CMFCRibbonApplicationButton m_MainButton;

   // panel images
   CMFCToolBarImages m_PanelImages;

   // Document colors for demo:
   CList<COLORREF, COLORREF> m_lstMainColors;
   CList<COLORREF, COLORREF> m_lstAdditionalColors;
   CList<COLORREF, COLORREF> m_lstStandardColors;

   // Generated message map functions
protected:
   //{{AFX_MSG(CMainFrame)
   afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);
   afx_msg void OnAppLook(UINT id);
   afx_msg void OnUpdateAppLook(CCmdUI *pCmdUI);
   afx_msg void OnWindowManager();
   afx_msg void OnMdiMoveToNextGroup();
   afx_msg void OnMdiMoveToPrevGroup();
   afx_msg void OnMdiNewHorzTabGroup();
   afx_msg void OnMdiNewVertGroup();
   afx_msg void OnMdiCancel();
   afx_msg LRESULT OnRibbonCustomize(WPARAM wp, LPARAM lp);
   afx_msg LRESULT OnHighlightRibbonListItem(WPARAM wp, LPARAM lp);
   afx_msg void OnToolsOptions();
   afx_msg void OnDummy();
   afx_msg void OnSysColorChange();
   //}}AFX_MSG

   DECLARE_MESSAGE_MAP()

   virtual BOOL OnShowMDITabContextMenu(CPoint point, DWORD dwAllowedItems, BOOL bDrop);
   virtual BOOL OnShowPopupMenu(CMFCPopupMenu *pMenuPopup);

   void ShowOptions(int nPage);
   void CreateDocumentColors();

private:
   BOOL CreateRibbonBar();
   BOOL CreateStatusBar();

   void InitMainButton();
   void InitHomeCategory();
   void InitViewCategory();
   void InitTabButtons();

   void AddContextTab_Format();

   void AdjustObjectSubmenu(CMFCPopupMenu *pMenuPopup);
   void UpdateStatusBarCountPane(int nID, CString strText, int nCount);

   UINT m_nAppLook;
};

Arvshierarki

CObject

CCmdTarget

CWnd

CFrameWnd

CMDIFrameWnd

CMDIFrameWndEx

Kravspecifikation

rubrik:afxMDIFrameWndEx.h

CMDIFrameWndEx::ActiveItemRecalcLayout

Beräknar om layouten för det aktiva objektet.

void ActiveItemRecalcLayout();

CMDIFrameWndEx::AddPane

Registrerar ett fönster med dockningshanteraren.

BOOL AddPane(
    CBasePane* pControlBar,
    BOOL bTail=TRUE);

Parameterar

pControlBar
[i] Pekare till fönstret som ska registreras.

bTail
[i] Anger om du vill lägga till det här fönstret i slutet av listan.

Returvärde

Returnerar ett värde som inte är noll om fönstret har registrerats. Returnerar 0 om fönstret redan är registrerat med dockningshanteraren.

Anmärkningar

Varje fönster måste registreras med CDockingManager klassen innan den kan delta i dockningslayouten. Använd den här metoden för att meddela dockningshanteraren att du vill docka ett visst fönster. När fönstret har registrerats justerar dockningshanteraren det baserat på dess justeringsinställning och position i listan över fönster som underhålls av dockningshanteraren.

CMDIFrameWndEx::AdjustClientArea

Minskar klientområdet för att tillåta en kantlinje.

virtual void AdjustClientArea();

CMDIFrameWndEx::AdjustDockingLayout

Beräknar om layouten för alla dockade fönster.

virtual void AdjustDockingLayout(HDWP hdwp=NULL);

Parameterar

hdwp
[i] Identifierar strukturen för position med flera fönster. Du kan hämta det här värdet genom att anropa BeginDeferWindowPos.

Anmärkningar

Anropa den här medlemsfunktionen för att beräkna layouten för alla fönster som är dockade till ramfönstret.

CMDIFrameWndEx::AreMDITabs

Avgör om funktionen MDI-flikar eller funktionen MDI-flikar är aktiverad.

BOOL AreMDITabs(int* pnMDITabsType=NULL) const;

Parameterar

pnMDITabsType
[ut] En pekare till en heltalsvariabel som anger vilka funktioner som är aktiverade:

• 0: Alla funktioner är inaktiverade.
• 1: MDI-flikar är aktiverade.
• 2: Grupper med MDI-flikar är aktiverade.

Returvärde

Returnerar TRUE om MDI-flikar eller MDI-flikar är aktiverade.

Returnerar FALSE om ingen av ovanstående funktioner är aktiverade.

Anmärkningar

Använd den här funktionen för att avgöra om MDI-flikar eller MDI-flikar är aktiverade för ramfönstret. Använd CMDIFrameWndEx::EnableMDITabs för att aktivera eller inaktivera funktionen MDI-flikar.

Använd CMDIFrameWndEx::EnableMDITabbedGroups för att aktivera eller inaktivera funktionen för MDI-flikar.

CMDIFrameWndEx::CanConvertControlBarToMDIChild

Anropas av ramverket för att avgöra om ramfönstret kan konvertera dockningsfönster till flikar i dokument

virtual BOOL CanConvertControlBarToMDIChild();

Returvärde

Returnerar TRUE om ramfönstret kan konvertera dockningsfönster till tabbdokument. Annars returneras FALSE.

Anmärkningar

Åsidosätt den här metoden i en härledd klass och återgå TRUE för att aktivera konvertering av dockningsfönster till flikar. Du kan också ange CMDIFrameWndEx::m_bCanConvertControlBarToMDIChild till TRUE.

CMDIFrameWndEx::ControlBarToTabbedDocument

Konverterar det angivna dockningsfönstret till ett tabbdokument.

virtual CMDIChildWndEx* ControlBarToTabbedDocument(CDockablePane* pBar);

Parameterar

pBar
En pekare till dockningsfönstret som ska konverteras.

Returvärde

Returnerar en pekare till det nya underordnade MDI-fönstret som innehåller dockningsfönstret.

Anmärkningar

Den här metoden konverterar ett dockningsfönster till ett tabbdokument. När du anropar den här metoden skapar ramverket ett CMDIChildWndEx klassobjekt , tar bort dockningsfönstret från dockningshanteraren och lägger till dockningsfönstret i det nya underordnade MDI-fönstret. Det underordnade MDI-fönstret ändrar storlek på dockningsfönstret så att det täcker hela klientområdet

CMDIFrameWndEx::CreateDocumentWindow

Skapar ett underordnat dokumentfönster.

virtual CMDIChildWndEx* CreateDocumentWindow(
    LPCTSTR lpcszDocName,
    CObject* pObj);

Parameterar

lpcszDocName
[i] En textsträng som innehåller en dokumentidentifierare. Vanligtvis är det den fullständiga sökvägen till en dokumentfil.

pObj
[i] En pekare till ett användardefinierat objekt. En utvecklare kan till exempel skapa en programspecifik datastruktur som beskriver dokumentet och berätta hur dokumentet ska initieras vid start.

Returvärde

En pekare till CMDIChildWndEx.

Anmärkningar

Ramverket anropar den här metoden när den läser in listan över dokument som tidigare sparats i registret.

Åsidosätt den här metoden för att skapa dokument när de läses in från registret.

Exempel

I följande exempel visas hur CreateDocumentWindow används i VisualStudioDemo-exemplet: MFC Visual Studio Application.

I det här exemplet g_strStartViewName kan vara namnet på ett "virtuellt dokument" (till exempel "Startsida") som inte läses in från en diskfil. Därför behöver vi särskild bearbetning för att hantera det fallet.

CMainFrame::CMainFrame()
{
   CMFCPopupMenu::SetForceShadow(TRUE);
   m_bCanConvertControlBarToMDIChild = TRUE;
}

CMDIFrameWndEx::CreateNewWindow

Anropas av ramverket för att skapa ett nytt fönster.

virtual CMDIChildWndEx* CreateNewWindow(
    LPCTSTR lpcszDocName,
    CObject* pObj);

Parameterar

lpcszDocName
[i] Dokumentnamnet.

pObj
[i] Reserverad för framtida användning.

Returvärde

En pekare till det nya fönstret.

CMDIFrameWndEx::DockPane

Dockar det angivna fönstret till ramfönstret.

void DockPane(
    CBasePane* pBar,
    UINT nDockBarID=0,
    LPCRECT lpRect=NULL);

Parameterar

pBar
[i] Pekare till fönstret som ska dockas.

nDockBarID
[i] Anger vilka sidor av ramfönstret som ska dockas till.

lpRect
[i] Används inte.

Anmärkningar

Den här metoden dockar det angivna fönstret till en av sidorna i ramfönstret som angavs när CBasePane::EnableDocking och CMDIFrameWndEx::EnableDocking anropades.

Exempel

I följande exempel visas användningen av metoden DockPane. Det här kodfragmentet kommer från VisualStudioDemo-exempel: MFC Visual Studio Application.

DockPane(&m_wndMenuBar);
DockPane(&m_wndToolBar);
DockPane(&m_wndPropertiesBar);

DockPane(&m_wndToolbarBuild);

CMDIFrameWndEx::DockPaneLeftOf

Dockar ett fönster till vänster om ett annat fönster.

BOOL DockPaneLeftOf(
    CPane* pBar,
    CPane* pLeftOf);

Parameterar

pBar
[i] En pekare till dockningsfönstret.

pLeftOf
[i] En pekare till fönstret som fungerar som dockplats.

Returvärde

Returnerar TRUE om åtgärden lyckas. Annars returneras FALSE.

Anmärkningar

Anropa den här metoden för att docka flera fönsterobjekt i en fördefinierad ordning. Den här metoden dockar fönstret som anges av pBar till vänster i fönstret som anges av pLeftOf.

Exempel

I följande exempel visas hur DockPaneLeftOf metoden används i VisualStudioDemo-exemplet: MFC Visual Studio Application.

DockPane(&m_wndToolbarBuild);
DockPaneLeftOf(&m_wndToolbarEdit, &m_wndToolbarBuild);

CMDIFrameWndEx::EnableAutoHidePanes

Aktiverar automatiskt döljläge för fönster när de dockas på de angivna sidorna av huvudramsfönstret.

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

Parameterar

dwDockStyle
[i] Anger sidorna i huvudramfönstret som ska aktiveras. Använd en eller flera av följande flaggor.

• CBRS_ALIGN_LEFT
• CBRS_ALIGN_RIGHT
• CBRS_ALIGN_TOP
• CBRS_ALIGN_BOTTOM

Returvärde

Anropa den här funktionen för att aktivera automatiskt döljläge för fönster när de dockas på de angivna sidorna av huvudramsfönstret.

Exempel

I följande exempel visas hur EnableAutoHidePanes metoden används i VisualStudioDemo-exemplet: MFC Visual Studio Application.

EnableAutoHidePanes(CBRS_ALIGN_ANY);

Anmärkningar

CMDIFrameWndEx::EnableDocking

Aktiverar dockning av de fönster som tillhör MDI-ramfönstret.

BOOL EnableDocking(DWORD dwDockStyle);

Parameterar

dwDockStyle
[i] Anger det dockningsformat som du vill använda.

Returvärde

Anmärkningar

Anropa den här funktionen för att aktivera dockning av fönster som tillhör CMDIFrameWndEx objektet.

Exempel

I följande exempel visas hur EnableDocking metoden används i VisualStudioDemo-exemplet: MFC Visual Studio Application.

EnableDocking(CBRS_ALIGN_ANY);

CMDIFrameWndEx::EnableFullScreenMainMenu

Visar eller döljer huvudmenyn i helskärmsläge.

void EnableFullScreenMainMenu(BOOL bEnableMenu);

Parameterar

bEnableMenu
[i] TRUE för att visa huvudmenyn i helskärmsläge eller FALSE för att dölja den.

Anmärkningar

CMDIFrameWndEx::EnableFullScreenMode

Aktiverar helskärmsläge för ramfönstret.

void EnableFullScreenMode(UINT uiFullScreenCmd);

Parameterar

uiFullScreenCmd
[i] ID för ett kommando som aktiverar eller inaktiverar helskärmsläge.

Anmärkningar

I helskärmsläge döljs alla dockningskontrollstaplar, verktygsfält och menyer och den aktiva vyn ändras så att den upptar helskärmsläget. När du aktiverar helskärmsläge måste du ange ett ID för kommandot som aktiverar eller inaktiverar det. Du kan anropa EnableFullScreenMode från huvudramens OnCreate funktion. När ett ramfönster växlas till helskärmsläge skapar ramverket ett flytande verktygsfält med en knapp som har det angivna kommando-ID:t. Om du vill behålla huvudmenyn på skärmen anropar du CMDIFrameWndEx::EnableFullScreenMainMenu.

CMDIFrameWndEx::EnableLoadDockState

Aktiverar eller inaktiverar inläsningen av dockningstillståndet.

void EnableLoadDockState(BOOL bEnable = TRUE);

Parameterar

bEnable
[i] TRUE för att aktivera inläsning av dockningstillståndet för FALSE att inaktivera inläsningen av dockningstillståndet.

Anmärkningar

CMDIFrameWndEx::EnableMDITabbedGroups

Aktiverar eller inaktiverar funktionen MDI-flikar för ramfönstret.

void EnableMDITabbedGroups(
    BOOL bEnable,
    const CMDITabInfo& params);

Parameterar

bEnable
[i] Om TRUEär funktionen grupper med MDI-flikar aktiverad. Om FALSEinaktiveras funktionen MDI-flikarade grupper.

params
[i] Anger parametrar som ramverket gäller för underordnade fönster som skapas i MDI-klientområdet.

Anmärkningar

Använd den här metoden för att aktivera eller inaktivera funktionen för MDI-flikar. Med den här funktionen kan MDI-program visa underordnade fönster som flikar som är lodrätt eller vågrätt i MDI-klientområdet. Grupper av fönster med flikar avgränsas med delare. Användaren kan ändra storlek på grupper med flikar med hjälp av en delning.

Användaren kan:

• Dra enskilda flikar mellan grupper.
• Dra enskilda flikar till fönstrets kant för att skapa nya grupper.
• Flytta flikar eller skapa nya grupper med hjälp av en snabbmeny.
• Ditt program kan spara den aktuella layouten för fönster med flikar och listan över dokument som är öppna för tillfället.

Om du anropar den här metoden med bEnable inställd på FALSEignoreras params .

Även om grupper med MDI-flikar redan är aktiverade kan du anropa den här metoden igen för att ändra inställningarna för underordnade fönster. Anropa metoden med bEnable inställd på TRUE och ändra medlemmarna i objektet CMDITabInfo som anges av parametern params .

Mer information om hur du använder grupper med MDI-flikar finns i MDI-flikar.

Exempel

I följande exempel visas hur EnableMDITabbedGroups används i VisualStudioDemo-exemplet: MFC Visual Studio Application.

CMDITabInfo mdiTabParams;
mdiTabParams.m_bTabCustomTooltips = TRUE;

if (bMDITabsVS2005Look)
{
   mdiTabParams.m_style = CMFCTabCtrl::STYLE_3D_VS2005;
   mdiTabParams.m_bDocumentMenu = TRUE;
}
else if (bOneNoteTabs)
{
   mdiTabParams.m_style = CMFCTabCtrl::STYLE_3D_ONENOTE;
   mdiTabParams.m_bAutoColor = bMDITabColors;
}

if (bActiveTabCloseButton)
{
   mdiTabParams.m_bTabCloseButton = FALSE;
   mdiTabParams.m_bActiveTabCloseButton = TRUE;
}

EnableMDITabbedGroups(TRUE, mdiTabParams);

CMDIFrameWndEx::EnableMDITabs

Aktiverar eller inaktiverar MDI Tabs-funktionen för MDI-ramfönstret. När det är aktiverat visar ramfönstret en flik för varje underordnat MDI-fönster.

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);

Parameterar

bEnable
Anger om flikar är aktiverade.

bIcons
Anger om ikoner ska visas på flikarna.

tabLocation
Anger fliketiketternas plats.

bTabCloseButton
Anger om flikstängningsknappar ska visas.

style
Anger formatmallen för flikar. Använd STYLE_3D_SCROLLED för vanliga flikar eller STYLE_3D_ONENOTE för Microsoft OneNote-flikar.

bTabCustomTooltips
Anger om anpassade knappbeskrivningar är aktiverade.

bActiveTabCloseButton
Om TRUEvisas knappen Stäng på den aktiva fliken i stället för i det högra hörnet i flikområdet.

Anmärkningar

Anropa den här metoden för att aktivera eller inaktivera funktionen MDI-flikar för MDI-ramfönstret. När det är aktiverat visas alla underordnade fönster som flikar.

Tabbetiketterna kan finnas längst upp eller längst ned i ramen, beroende på inställningen för parametern tabLocation. Du kan ange antingen CMFCTabCtrl::LOCATION_BOTTOM (standardinställningen) eller CMFCTabCtrl::LOCATION_TOP.

Om bTabCustomTooltips är TRUEskickas ett AFX_WM_ON_GET_TAB_TOOLTIP meddelande till huvudramfönstret. Koden kan hantera det här meddelandet och tillhandahålla ramverket med anpassade knappbeskrivningar för MDI-flikar.

Exempel

I följande exempel visas hur EnableMDITabs används i MDITabsDemo-exemplet: MFC Tabbed MDI Application.

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;

CMDIFrameWndEx::EnableMDITabsLastActiveActivation

Anger om den senaste aktiva fliken ska öppnas när användaren stänger den aktuella fliken.

void EnableMDITabsLastActiveActivation(BOOL bLastActiveTab=TRUE);

Parameterar

bLastActiveTab
[i] Om TRUEaktiverar du aktivering av den senaste aktiva fliken. Om FALSEinaktiverar du aktivering av den senaste aktiva fliken.

Anmärkningar

Det finns två sätt att öppna en flik när den aktiva fliken stängs:

• Aktivera nästa flik.
• Aktivera den tidigare aktiva fliken.

Standardimplementeringen använder det första sättet.

Använd EnableMDITabsLastActiveActivation för att aktivera det andra sättet för flikaktivering. Den emulerar hur Windows öppnar underordnad MDI-fönster.

CMDIFrameWndEx::EnablePaneMenu

Aktiverar eller inaktiverar automatisk skapande och hantering av popup-menyn, som visar en lista över programfönster.

void EnablePaneMenu(
    BOOL bEnable,
    UINT uiCustomizeCmd,
    const CString& strCustomizeLabel,
    UINT uiViewToolbarsMenuEntryID,
    BOOL bContextMenuShowsToolbarsOnly=FALSE,
    BOOL bViewMenuShowsToolbarsOnly=FALSE);

Parameterar

bEnable
[i] Om TRUEär automatisk hantering av fönstermenyn aktiverad. Om FALSEinaktiveras automatisk hantering.

uiCustomizeCmd
[i] Kommando-ID för menyalternativet Anpassa . Det här menyalternativet läggs vanligtvis till i slutet av listan med fönster.

strCustomizeLabel
[i] Texten som ska visas för menyalternativet Anpassa (för lokalisering).

uiViewToolbarsMenuEntryID
[i] Anger ID för ett menyalternativ i verktygsfältet som öppnar fönstermenyn. Detta är vanligtvis undermenyn Verktygsfält i menyn Visa .

bContextMenuShowsToolbarsOnly
[i] Om TRUEvisar fönstermenyn endast en lista med verktygsfält. Om FALSEvisar menyn en lista över verktygsfält och dockningsstaplar.

bViewMenuShowsToolbarsOnly
[i] Om TRUEvisar fönstermenyn endast en lista med verktygsfält. Om FALSEvisar menyn en lista över verktygsfält och dockningsstaplar.

Anmärkningar

Popup-menyn visar listan över programmets fönster och låter användaren visa eller dölja enskilda fönster.

Exempel

I följande exempel visas hur EnablePaneMenu används i VisualStudioDemo-exemplet: MFC Visual Studio Application.

// Enable pane context menu(list of bars + customize command):
EnablePaneMenu(TRUE, ID_VIEW_CUSTOMIZE, _T("Customize..."), ID_VIEW_TOOLBARS, FALSE, TRUE);

CMDIFrameWndEx::EnableWindowsDialog

Infogar ett menyalternativ vars kommando-ID anropar en CMFCWindowsManagerDialog dialogruta.

void EnableWindowsDialog(
    UINT uiMenuId,
    LPCTSTR lpszMenuText,
    BOOL bShowAllways=FALSE,
    BOOL bShowHelpButton=FALSE);

void EnableWindowsDialog(
    UINT uiMenuId,
    UINT uiMenuTextResId,
    BOOL bShowAllways=FALSE,
    BOOL bShowHelpButton=FALSE);

Parameterar

uiMenuId
[i] Anger resurs-ID för en meny.

lpszMenuText
[i] Anger objektets text.

bShowHelpButton
[i] Anger om du vill visa en hjälpknapp i dialogrutan Windows-hantering.

uiMenuTextResId
[i] Strängresursidentifieraren som innehåller objektets textsträng.

Anmärkningar

Använd den här metoden för att infoga ett menyalternativ vars kommando anropar en dialogruta för underordnad MDI-fönsterhantering ( CMFCWindowsManagerDialog klass). Det nya objektet infogas i menyn som anges av uiMenuId. Anropa EnableWindowsDialog när du bearbetar meddelandet WM_CREATE .

Exempel

I följande exempel visas hur EnableWindowsDialog används i VisualStudioDemo-exemplet: MFC Visual Studio Application.

// Enable windows manager:
EnableWindowsDialog(ID_WINDOW_MANAGER, _T("Windows..."), TRUE);

CMDIFrameWndEx::GetActivePopup

Returnerar en pekare till den popup-meny som visas just nu.

CMFCPopupMenu* GetActivePopup() const;

Returvärde

En pekare till den aktiva popup-menyn. NULL om ingen popup-meny är aktiv.

Anmärkningar

Använd den här funktionen för att hämta en pekare till klassobjektetCMFCPopupMenu som visas för närvarande.

CMDIFrameWndEx::GetDefaultResId

Returnerar ID för delade resurser i MDI-ramfönstret.

UINT GetDefaultResId() const;

Returvärde

Ett resurs-ID-värde. 0 om ramfönstret inte har någon menyrad.

Anmärkningar

Den här metoden returnerar det resurs-ID som angavs när MDI-ramfönstret lästes in av CFrameWnd::LoadFrame.

CMDIFrameWndEx::GetMDITabGroups

Returnerar en lista över MDI-flikarade fönster.

const CObList& GetMDITabGroups() const;

Returvärde

En referens till ett CObList klassobjekt som innehåller en lista över fönster med flikar. Lagra eller ändra inte listan.

Anmärkningar

Använd den här metoden för att komma åt listan över fönster med flikar. Det kan vara användbart om du vill ändra eller köra frågor mot vissa parametrar för enskilda fönster med flikar.

CMDIFrameWndEx::GetMDITabs

Returnerar en referens till det understrukna fönstret med flikar.

CMFCTabCtrl& GetMDITabs();

Returvärde

En referens till det understrukna fönstret med flikar.

CMDIFrameWndEx::GetMDITabsContextMenuAllowedItems

Returnerar en kombination av flaggor som avgör vilka åtgärder som är giltiga när funktionen MDI-flikar är aktiverad.

DWORD GetMDITabsContextMenuAllowedItems();

Returvärde

En bitvis "eller" (|) kombination av följande flaggor:

• AFX_MDI_CREATE_VERT_GROUP – kan skapa en lodrät flikgrupp.
• AFX_MDI_CREATE_HORZ_GROUP – kan skapa en vågrät flikgrupp.
• AFX_MDI_CAN_MOVE_PREV – kan flytta en flik till föregående flikgrupp.
• AFX_MDI_CAN_MOVE_NEXT – kan flytta en flik till nästa flikgrupp.

Anmärkningar

När funktionen MDI-grupper med flikar är aktiverad måste du veta vilka åtgärder som tillåts på flikarna i ett visst fönster. Den här metoden analyserar den aktuella layouten för fönster med flikar och returnerar en kombination av flaggor som kan användas för att skapa till exempel en snabbmeny.

Du kan skapa en ny lodrät flikgrupp när alla fönster med flikar justeras lodrätt eller när det bara finns ett fönster med flikar.

Du kan skapa en ny vågrät flikgrupp när alla fönster med flikar justeras vågrätt eller när det bara finns ett fönster med flikar.

Du kan bara flytta en flik till den föregående gruppen om det finns mer än en flik i ett fönster med flikar.

Du kan bara flytta en flik till nästa grupp om det finns mer än en flik i ett fönster med flikar.

CMDIFrameWndEx::GetMenuBar

Returnerar en pekare till ett menyradsobjekt som är kopplat till ramfönstret.

const CMFCMenuBar* GetMenuBar() const;

Returvärde

En pekare till ett menyradsobjekt.

CMDIFrameWndEx::GetPane

Returnerar en pekare till fönstret som har det angivna kontroll-ID:t.

CBasePane* GetPane(UINT nID);

Parameterar

nID
[i] Kontroll-ID:t.

Returvärde

En pekare till fönstret som har det angivna kontroll-ID:t, om det finns. Annars, NULL.

CMDIFrameWndEx::GetRibbonBar

Hämtar kontrollen för menyfliksområdet för ramen.

CMFCRibbonBar* GetRibbonBar();

Returvärde

Pekare till CMFCRibbonBar klassen för ramen.

Anmärkningar

CMDIFrameWndEx::GetTearOffBars

Returnerar en lista över avrivningsmenyer.

const CObList& GetTearOffBars() const;

Returvärde

En referens till ett CObList klassobjekt som innehåller en samling pekare till CPane-derived-objekt som är i ett avrivningstillstånd.

Anmärkningar

CMDIFrameWndEx har en samling avrivningsmenyer. Använd den här metoden för att hämta en referens till den här listan.

CMDIFrameWndEx::GetToolbarButtonToolTipText

Anropas av ramverket när programmet visar knappbeskrivningen för en verktygsfältsknapp.

virtual BOOL GetToolbarButtonToolTipText(
    CMFCToolBarButton* pButton,
    CString& strTTText);

Parameterar

pButton
[i] En pekare till en knapp i verktygsfältet.

strTTText
[i] Knappbeskrivningstexten som ska visas för knappen.

Returvärde

TRUE om knappbeskrivningen har visats. FALSE annars.

Anmärkningar

CMDIFrameWndEx::InsertPane

Registrerar det angivna fönstret med dockningshanteraren.

BOOL InsertPane(
    CBasePane* pControlBar,
    CBasePane* pTarget,
    BOOL bAfter=TRUE);

Parameterar

pControlBar
[i] En pekare till fönstret som ska infogas.

pTarget
[i] En pekare till fönstret före eller efter vilken fönstret ska infogas.

bAfter
[i] Om TRUE, pControlBar infogas efter pTarget. Om FALSE, pControlBar infogas före pTarget.

Returvärde

TRUE om metoden registrerar fönstret FALSE om fönstret redan har registrerats med dockningshanteraren.

Anmärkningar

Använd den här metoden för att berätta för dockningshanteraren om ett fönster som anges av pControlBar. Dockningshanteraren justerar det här fönstret enligt fönstrets justering och position i dockningshanterarens interna lista.

CMDIFrameWndEx::IsFullScreen

Avgör om ramfönstret är i helskärmsläge.

BOOL IsFullScreen() const;

Returvärde

TRUE om ramfönstret är i helskärmsläge; annars FALSE.

Anmärkningar

Du kan ange helskärmsläget genom att anropa CMDIFrameWndEx::EnableFullScreenMode metoden.

CMDIFrameWndEx::IsMDITabbedGroup

Anger om funktionen MDI-grupper med flikar är aktiverad.

BOOL IsMDITabbedGroup() const;

Returvärde

TRUE om funktionen MDI-flikar är aktiverad; annars FALSE.

Anmärkningar

Om du vill avgöra om vanliga MDI-flikar eller funktionen MDI-flikar är aktiverad använder du CMDIFrameWndEx::AreMDITabs.

CMDIFrameWndEx::IsMemberOfMDITabGroup

Avgör om det angivna fönstret med flikar finns i listan över fönster som finns i MDI-flikar.

BOOL IsMemberOfMDITabGroup(CWnd* pWnd);

Parameterar

pWnd
[i] En pekare till ett fönster med flikar.

Returvärde

TRUE om det angivna fönstret med flikar finns i listan över flikar som bildar MDI-flikar. Annars FALSE.

CMDIFrameWndEx::IsMenuBarAvailable

Avgör om ramfönstret har en menyrad.

BOOL IsMenuBarAvailable() const;

Returvärde

TRUE om pekaren till menyradsobjektet inte NULLär , annars FALSE.

CMDIFrameWndEx::IsPointNearDockSite

Avgör om en angiven punkt ligger nära dockningsplatsen.

BOOL IsPointNearDockSite(
    CPoint point,
    DWORD& dwBarAlignment,
    BOOL& bOuterEdge) const;

Parameterar

point
[i] Den angivna punkten i skärmkoordinater.

dwBarAlignment
[i] Anger vilken kant punkten är nära. Möjliga värden är CBRS_ALIGN_LEFT, CBRS_ALIGN_RIGHT, CBRS_ALIGN_TOPoch CBRS_ALIGN_BOTTOM

bOuterEdge
[i] TRUE om punkten ligger nära dockplatsens yttre kantlinje; FALSE annars.

Returvärde

TRUE om punkten ligger nära dockningsplatsen; annars FALSE.

Anmärkningar

Punkten ligger nära dockningsplatsen när den ligger inom känslighetsuppsättningen i dockningshanteraren. Standardkänsligheten är 15 bildpunkter.

CMDIFrameWndEx::IsPrintPreview

Avgör om ramfönstret är i förhandsgranskningsläge.

BOOL IsPrintPreview();

Returvärde

TRUEom ramfönstret är i förhandsgranskningsläge; annars . FALSE

Anmärkningar

CMDIFrameWndEx::LoadFrame

Skapar ett ramfönster från resursinformation.

virtual BOOL LoadFrame(
    UINT nIDResource,
    DWORD dwDefaultStyle = WS_OVERLAPPEDWINDOW | FWS_ADDTOTITLE,
    CWnd* pParentWnd = NULL,
    CCreateContext* pContext = NULL);

Parameterar

nIDResource
[i] ID för en delad resurs som är associerad med ramfönstret.

dwDefaultStyle
[i] Bildrutefönstrets format.

pParentWnd
[i] En pekare till ramens överordnade.

pContext
[i] En pekare till en CCreateContext struktur. Den här parametern kan vara NULL.

Returvärde

TRUE om metoden lyckas, annars FALSE.

CMDIFrameWndEx::LoadMDIState

Läser in den angivna layouten för MDI-flikar och listan över dokument som öppnats tidigare.

virtual BOOL LoadMDIState(LPCTSTR lpszProfileName);

Parameterar

lpszProfileName
[i] Anger profilnamnet.

Returvärde

TRUE om belastningen lyckades. FALSE om belastningen misslyckades eller om det inte finns några data att läsa in.

Anmärkningar

Om du vill läsa in eller spara tillståndet för MDI-flikar och grupper och listan över öppnade dokument gör du följande:

• Anropa CMDIFrameWndEx::SaveMDIState när huvudramen stängs
• Anropa CMDIFrameWndEx::LoadMDIState när huvudramen skapas. Den rekommenderade platsen för det här anropet är innan huvudramen visas för första gången. Lägg till CWinAppEx::EnableLoadWindowPlacement(FALSE); före pMainFrame->LoadFrame (IDR_MAINFRAME);. Lägg till CWinAppEx::ReloadWindowPlacement(pMainFrame); efter anropet till för att LoadMDIState visa huvudramen på den plats som lagrades i registret.
• Åsidosätt GetDocumentName i CMDIChildWndEx- härledd klass om ditt program visar dokument som inte lagras som filer. Den returnerade strängen sparas i registret som dokumentidentifierare. Basimplementeringen av CMDIChildWndEx::GetDocumentName returnerar ett värde som hämtats från CDocument::GetPathName.
• Åsidosätt CMDIFrameWndEx::CreateDocumentWindow för att skapa dokument korrekt när de läses in från registret. Den första parametern är strängen som GetDocumentName returnerades.

Exempel

I följande exempel visas hur LoadMDIState används i VisualStudioDemo-exemplet: MFC Visual Studio Application.

// Parse command line for standard shell commands, DDE, file open
CCommandLineInfo cmdInfo;
ParseCommandLine(cmdInfo);

if (cmdInfo.m_nShellCommand == CCommandLineInfo::FileNew)
{
   if (!pMainFrame->LoadMDIState(GetRegSectionPath()))
   {
      m_pStartDocTemplate->OpenDocumentFile(NULL);
   }
}
else
{
   // Dispatch commands specified on the command line
   if (!ProcessShellCommand(cmdInfo))
   {
      return FALSE;
   }
}

CMDIFrameWndEx::MDITabMoveToNextGroup

Flyttar den aktiva fliken från det aktiva fönstret med flikar till nästa eller föregående flikar.

void MDITabMoveToNextGroup(BOOL bNext=TRUE);

Parameterar

bNext
[i] Om TRUEflyttar du fliken till nästa flikar. Om FALSEflyttar du den till den tidigare gruppen med flikar.

CMDIFrameWndEx::MDITabNewGroup

Skapar en ny grupp med flikar som har ett enda fönster.

void MDITabNewGroup(BOOL bVert=TRUE);

Parameterar

bVert
[i] Anger den nya gruppjusteringen. Om TRUEjusteras den nya gruppen lodrätt. Om FALSEjusteras den nya gruppen vågrätt.

Anmärkningar

Använd den här funktionen för att skapa ett nytt fönster med flikar (ny grupp med flikar) och lägg till den första fliken i den.

Exempel

I följande exempel visas hur MDITabNewGroup används i VisualStudioDemo-exemplet: MFC Visual Studio Application.

void CMainFrame::OnMdiNewHorzTabGroup()
{
   MDITabNewGroup(FALSE);
}

CMDIFrameWndEx::m_bCanConvertControlBarToMDIChild

Anger om dockningsfönster kan konverteras till underordnade MDI-fönster.

BOOL m_bCanConvertControlBarToMDIChild;

Anmärkningar

Anger om dockningskontrollstaplar kan konverteras till underordnade MDI-fönster. Om den här flaggan är TRUEhanterar ramverket konverteringen automatiskt när användaren väljer kommandot Tabbed Document . Flaggan är skyddad och du måste uttryckligen aktivera det här alternativet antingen genom att ange m_bCanConvertControlBarToMDIChild i en konstruktor för en CMDIFrameWndEx-härledd klass eller genom att CanConvertControlBarToMDIChildåsidosätta .

Standardvärdet är FALSE.

Exempel

I följande exempel visas hur m_bCanConvertControlBarToMDIChild används i VisualStudioDemo-exemplet: MFC Visual Studio Application.

CMainFrame::CMainFrame()
{
   CMFCPopupMenu::SetForceShadow(TRUE);
   m_bCanConvertControlBarToMDIChild = TRUE;
}

CMDIFrameWndEx::m_bDisableSetRedraw

Aktiverar eller inaktiverar optimering av omaraw för underordnade MDI-fönster.

AFX_IMPORT_DATA static BOOL m_bDisableSetRedraw;

Anmärkningar

Standardvärdet är TRUE.

Ange den här flaggan till FALSE om du vill optimera omformuleringen av MDI-underordnade objekt. I det här fallet anropar SetRedraw (FALSE) ramverket huvudramen när programmet ändrar den aktiva fliken.

Den här flaggan kan orsaka oönskade effekter (till exempel bakgrundsprogram som blir synliga). Därför rekommenderar vi att du ändrar standardvärdet endast om du upplever märkbar flimmer under MDI-flikaktivering.

CMDIFrameWndEx::NegotiateBorderSpace

Förhandlar om kantutrymme i ett ramfönster under aktivering av OLE på plats.

virtual BOOL NegotiateBorderSpace(
    UINT nBorderCmd,
    LPRECT lpRectBorder);

Parameterar

nBorderCmd
[i] Innehåller något av följande värden från uppräkningen CFrameWnd::BorderCmd:

• borderGet = 1
• borderRequest = 2
• borderSet = 3

lpRectBorder
[in, ut] Pekare till en RECT struktur eller ett CRect klassobjekt som anger koordinaterna för kantlinjen.

Returvärde

Nonzero om metoden lyckades; annars 0.

Anmärkningar

Den här metoden är en implementering av OLE-gränsrymdsförhandling.

CMDIFrameWndEx::OnCloseDockingPane

Anropas av ramverket när användaren klickar på knappen Stäng i ett dockbart fönster.

virtual BOOL OnCloseDockingPane(CDockablePane* pWnd);

Parameterar

pWnd
[i] Pekare till fönstret som stängs.

Returvärde

TRUE om dockningsfönstret kan stängas. Annars, FALSE.

Anmärkningar

Åsidosätt den här metoden för att hantera döljande av dockningsfönster. Gå tillbaka FALSE om du vill förhindra att ett dockningsfönster döljs.

Standardimplementeringen gör ingenting och returnerar TRUE.

CMDIFrameWndEx::OnCloseMiniFrame

Anropas av ramverket när användaren klickar på knappen Stäng i ett flytande miniramfönster.

virtual BOOL OnCloseMiniFrame(CPaneFrameWnd*);

Parameterar

pWnd
[i] Pekare till miniramsfönstret som stängs.

Returvärde

TRUE om det flytande miniramsfönstret kan stängas. Annars, FALSE.

Anmärkningar

Åsidosätt den här metoden för att hantera döljande av flytande miniramfönster. Returnera FALSE om du vill förhindra att ett flytande miniramfönster döljs.

Standardimplementeringen gör ingenting och returnerar TRUE.

CMDIFrameWndEx::OnClosePopupMenu

Anropas av ramverket när en aktiv popup-meny bearbetar ett WM_DESTROY meddelande.

virtual void OnClosePopupMenu(CMFCPopupMenu* pMenuPopup);

Parameterar

pMenuPopup
[i] Pekare till en popup-meny.

Anmärkningar

Åsidosätt den här metoden om du vill bearbeta meddelanden från CMFCPopupMenu klassobjekt som tillhör MDI-ramfönstret när objekten bearbetar WM_DESTROY meddelanden.

CMDIFrameWndEx::OnCmdMsg

Anropas av ramverket för att dirigera och skicka kommandomeddelanden och för att uppdatera kommandoobjekt för användargränssnittet.

virtual BOOL OnCmdMsg(
    UINT nID,
    int nCode,
    void* pExtra,
    AFX_CMDHANDLERINFO* pHandlerInfo);

Parameterar

nID
[i] Kommando-ID:t.

nCode
[i] Identifierar kommandots meddelandekod. Mer information om värden för nCodefinns i CCmdTarget::OnCmdMsg.

pExtra
[i] Används enligt värdet nCodeför . Mer information om pExtrafinns i CCmdTarget::OnCmdMsg.

pHandlerInfo
[in, ut] Den här parametern bör vanligtvis vara NULL. Om inte NULLOnCmdMsg fyller i och pTarget medlemmar pmf i strukturen i pHandlerInfo stället för att skicka kommandot.

Returvärde

Nonzero om meddelandet hanteras; annars 0.

CMDIFrameWndEx::OnDrawMenuImage

Anropas av ramverket när bilden som är associerad med ett menyalternativ ritas.

virtual BOOL OnDrawMenuImage(
    CDC* pDC,
    const CMFCToolBarMenuButton* pMenuButton,
    const CRect& rectImage);

Parameterar

pDC
[i] Pekare mot en enhetskontext.

pMenuButton
[i] Pekare till menyknappen.

rectImage
[i] Avgränsningsrektangeln för bilden.

Returvärde

TRUE om metoden ritar bilden. Standardimplementeringen returnerar FALSE.

Anmärkningar

Åsidosätt den här metoden om du vill anpassa bildåtergivningen för menyalternativen som tillhör menyraden som ägs av - CMDIFrameWndExderived-objektet. Standardimplementeringen gör ingenting.

CMDIFrameWndEx::OnDrawMenuLogo

Anropas av ramverket när ett CMFCPopupMenu meddelande bearbetas WM_PAINT .

virtual void OnDrawMenuLogo(
    CDC*,
    CMFCPopupMenu*,
    const CRect&);

Anmärkningar

Åsidosätt den här funktionen om du vill visa en logotyp på popup-menyn som tillhör menyraden som ägs av - CMDIFrameWndExderived-objektet. Standardimplementeringen gör ingenting.

CMDIFrameWndEx::OnEraseMDIClientBackground

Anropas av ramverket när MDI-ramfönstret bearbetar ett WM_ERASEBKGND meddelande.

virtual BOOL OnEraseMDIClientBackground(CDC*);

Returvärde

TRUE om programmet bearbetar meddelandet och raderar bakgrunden.

Anmärkningar

Åsidosätt den här medlemsfunktionen om du vill bearbeta meddelandet WM_ERASEBKGND i en CMDIFrameWndEx-derived-klass.

CMDIFrameWndEx::OnMenuButtonToolHitTest

Anropas av ramverket när ett CMFCToolBarButton objekt bearbetar ett WM_NCHITTEST meddelande.

virtual BOOL OnMenuButtonToolHitTest(
    CMFCToolBarButton* pButton,
    TOOLINFO* pTI);

Parameterar

pButton
[i] Verktygsfältsknappen.

pTI
[ut] Pekare mot en TOOLINFO struktur.

Returvärde

TRUE om programmet fyller parametern pTI . Standardimplementeringen returnerar FALSE.

Anmärkningar

Åsidosätt den här metoden om du vill ange information om specifika menyalternativ i en knappbeskrivning. Standardimplementeringen gör ingenting.

CMDIFrameWndEx::OnMoveMiniFrame

Anropas av ramverket för att flytta ett miniramfönster.

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

Parameterar

pFrame
[i] En pekare till ett miniramfönster.

Returvärde

TRUE om metoden lyckas, annars FALSE.

CMDIFrameWndEx::OnSetPreviewMode

Anger programmets förhandsgranskningsläge för huvudramsfönstret.

virtual void OnSetPreviewMode(
    BOOL bPreview,
    CPrintPreviewState* pState);

Parameterar

bPreview
[i] Om TRUEanger anger du läget för utskriftsförhandsgranskning. Om FALSEavbryter förhandsgranskningsläget.

pState
[i] En pekare till en CPrintPreviewState struktur.

Anmärkningar

Den här metoden åsidosätter CFrameWnd::OnSetPreviewMode.

CMDIFrameWndEx::OnShowCustomizePane

Anropas av ramverket när ett snabbanpassat fönster aktiveras.

virtual BOOL OnShowCustomizePane(
    CMFCPopupMenu* pMenuPane,
    UINT uiToolbarID);

Parameterar

pMenuPane
[i] En pekare till fönstret Snabbanpassning.

uiToolbarID
[i] Kontroll-ID för verktygsfältet som ska anpassas.

Returvärde

Den här metoden returnerar alltid TRUE.

Anmärkningar

Fönstret Snabbanpassning är en meny som öppnas när användaren klickar på Anpassa i ett verktygsfält.

Åsidosätt den här metoden i en härledd klass för att göra ändringar i fönstret Snabbanpassning.

CMDIFrameWndEx::OnShowMDITabContextMenu

Anropas av ramverket innan en snabbmeny visas på någon av flikarna. Gäller endast för grupper med MDI-flikar.

virtual BOOL OnShowMDITabContextMenu(
    CPoint point,
    DWORD dwAllowedItems,
    BOOL bTabDrop);

Parameterar

point
[i] Platsen för menyn i skärmkoordinater.

dwAllowedItems
[i] En bitvis "eller" (|) kombination av flaggor som anger vilka åtgärder som tillåts för den aktuella fliken:

• AFX_MDI_CREATE_VERT_GROUP – kan skapa en lodrät flikgrupp.
• AFX_MDI_CREATE_HORZ_GROUP – kan skapa en vågrät flikgrupp.
• AFX_MDI_CAN_MOVE_PREV – kan flytta en flik till föregående flikgrupp.
• AFX_MDI_CAN_MOVE_NEXT – kan flytta en flik till nästa flikgrupp.
• AFX_MDI_CAN_BE_DOCKED – växla ett tabbed-dokument till dockat tillstånd (endast relevant för flikar).

bTabDrop
[i] TRUE för att visa menyn som ett resultat av att dra fliken till en annan grupp med flikar. FALSE för att visa menyn som en snabbmeny på den aktiva fliken.

Returvärde

Åsidosätt den här metoden i en CMDIFrameWndEx-derived-klass.

Anmärkningar

Om du inte bearbetar OnShowMDITabContextMenuvisas inte snabbmenyn. Den här funktionen genereras av MFC-programguiden när du aktiverar funktionen MDI-flikar.

Exempel

I följande exempel visas hur OnShowMDITabContextMenu används i VisualStudioDemo-exemplet: MFC Visual Studio Application.

BOOL CMainFrame::OnShowMDITabContextMenu(CPoint point, DWORD dwAllowedItems, BOOL bDrop)
{
   CMenu menu;
   VERIFY(menu.LoadMenu(bDrop ? IDR_POPUP_DROP_MDITABS : IDR_POPUP_MDITABS));

   CMenu* pPopup = menu.GetSubMenu(0);
   ASSERT(pPopup != NULL);

   if ((dwAllowedItems & AFX_MDI_CREATE_HORZ_GROUP) == 0)
   {
      pPopup->DeleteMenu(ID_MDI_NEW_HORZ_TAB_GROUP, MF_BYCOMMAND);
   }

   if ((dwAllowedItems & AFX_MDI_CREATE_VERT_GROUP) == 0)
   {
      pPopup->DeleteMenu(ID_MDI_NEW_VERT_GROUP, MF_BYCOMMAND);
   }

   if ((dwAllowedItems & AFX_MDI_CAN_MOVE_NEXT) == 0)
   {
      pPopup->DeleteMenu(ID_MDI_MOVE_TO_NEXT_GROUP, MF_BYCOMMAND);
   }

   if ((dwAllowedItems & AFX_MDI_CAN_MOVE_PREV) == 0)
   {
      pPopup->DeleteMenu(ID_MDI_MOVE_TO_PREV_GROUP, MF_BYCOMMAND);
   }

   if ((dwAllowedItems & AFX_MDI_CAN_BE_DOCKED) == 0)
   {
      pPopup->DeleteMenu(ID_MDI_TABBED_DOCUMENT, MF_BYCOMMAND);
   }

   CMFCPopupMenu* pPopupMenu = new CMFCPopupMenu;
   pPopupMenu->SetAutoDestroy(FALSE);
   pPopupMenu->Create(this, point.x, point.y, pPopup->GetSafeHmenu());

   return TRUE;
}

CMDIFrameWndEx::OnShowPanes

Anropas av ramverket för att visa eller dölja fönster.

virtual BOOL OnShowPanes(BOOL bShow);

Parameterar

bShow
[i] TRUE för att visa fönster, FALSE för att dölja fönster.

Returvärde

TRUE om tillståndet för fönsterrutorna ändras till följd av att den här metoden anropas, FALSE om fönsterrutorna redan är i det tillstånd som anges av bShow. Om fönsterrutorna till exempel är dolda och bShow är FALSE, är FALSEreturvärdet .

Anmärkningar

Standardimplementeringen tar bort verktygsfältet från ramfönstret på den översta nivån.

Om CDockingManager::m_bHideDockingBarsInContainerMode är TRUE (standard) döljs alla dockningsfönster.

CMDIFrameWndEx::OnShowPopupMenu

Anropas av ramverket när det öppnar en popup-meny.

virtual BOOL OnShowPopupMenu(CMFCPopupMenu*);

Returvärde

TRUE om popup-menyn ska visas. Annars, FALSE. Standardimplementeringen returnerar TRUE.

Anmärkningar

Åsidosätt den här metoden om du vill implementera särskild bearbetning vid aktivering av popup-menyn. Om du till exempel vill ändra vanliga menyalternativ till färgmenyknappar konfigurerar du avrivningsstaplar och så vidare.

Standardimplementeringen gör ingenting.

CMDIFrameWndEx::OnSizeMDIClient

Anropas av ramverket när storleken på klientens MDI-fönster ändras.

virtual void OnSizeMDIClient(
    const CRect& rectOld,
    const CRect& rectNew);

Parameterar

rectOld
[i] Den aktuella storleken på MDI-klientfönstret.

rectNew
[i] Den nya storleken på MDI-klientfönstret.

Anmärkningar

CMDIFrameWndEx::OnTearOffMenu

Anropas av ramverket när en meny som har ett avstängt fält aktiveras.

virtual BOOL OnTearOffMenu(
    CMFCPopupMenu* pMenuPopup,
    CPane* pBar);

Parameterar

pMenuPopup
[i] En pekare till popup-menyn.

pBar
[i] En pekare till avrivningsfältet.

Returvärde

TRUE för att tillåta att popup-menyn med avrivningsfältet aktiveras; annars FALSE. Standardvärdet är TRUE.

Anmärkningar

Åsidosätt den här funktionen när du vill implementera en särskild konfiguration för avrivningsfältet. Standardimplementeringen gör ingenting.

CMDIFrameWndEx::OnUpdateFrameMenu

Anropas av ramverket för att uppdatera rammenyn.

virtual void OnUpdateFrameMenu(HMENU hMenuAlt);

Parameterar

hMenuAlt
[i] Ett handtag till en meny.

CMDIFrameWndEx::PaneFromPoint

Returnerar dockningsfönstret som innehåller den angivna punkten.

CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    bool bExactBar,
    CRuntimeClass* pRTCBarType) const;

CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    DWORD& dwAlignment,
    CRuntimeClass* pRTCBarType) const;

Parameterar

point
[i] Punkten (i skärmkoordinater).

nSensitivity
[i] Fönstrets rektangel för varje markerat fönster förstoras i alla riktningar med det här värdet.

bExactBar
[i] Om TRUEignoreras parametern nSensitivity .

pRTCBarType
[i] Om metoden inte är NULL- itererar metoden endast över fönsterrutorna av den angivna typen.

dwAlignment
[ut] Om en ruta hittas anger den här parametern vilken sida av fönstret som är närmast den angivna punkten.

Returvärde

En pekare till ett dockningsfönster, eller NULL om ingen kontroll innehåller den punkt som anges av point.

Anmärkningar

Anropet omdirigeras till CDockingManager klassen. Mer information finns i CDockingManager::ControlBarFromPoint.

CMDIFrameWndEx::RecalcLayout

Anropas av ramverket för att beräkna om layouten för ramfönstret.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parameterar

bNotify
[i] Avgör om det aktiva objektet på plats för ramfönstret får ett meddelande om layoutändringen. Om TRUE, meddelas objektet, annars FALSE.

Anmärkningar

Den här metoden åsidosätter CFrameWnd::RecalcLayout.

CMDIFrameWndEx::RemovePaneFromDockManager

Avregistrerar ett fönster och tar bort det från dockningshanteraren.

void RemovePaneFromDockManager(
    CBasePane* pControlBar,
    BOOL bDestroy,
    BOOL bAdjustLayout,
    BOOL bAutoHide,
    CBasePane* pBarReplacement);

Parameterar

pControlBar
[i] En pekare till ett fönster som ska tas bort.

bDestroy
[i] TRUE för att förstöra den borttagna rutan. FALSE att inte förstöra den.

bAdjustLayout
[i] TRUE för att justera dockningslayouten omedelbart. Om FALSEinträffar justeringen endast när en omarbetningshändelse inträffar av andra orsaker (användaren ändrar storlek på fönstret, drar huvudramen osv.).

bAutoHide
[i] TRUE för att ta bort fönstret från listan över automatiska fönster. FALSE för att ta bort fönstret från listan över vanliga fönster.

pBarReplacement
[i] En pekare till ett fönster som ersätter det borttagna fönstret.

Anmärkningar

Du måste registrera varje fönster med dockningshanteraren för att kunna delta i dockningslayouten. Använd CMDIFrameWndEx::AddPane eller CMDIFrameWndEx::InsertPane för att registrera fönsterrutor.

Använd den här metoden när ett fönster inte längre är en del av dockningslayouten i ramfönstret.

CMDIFrameWndEx::SaveMDIState

Sparar den aktuella layouten för MDI-flikar och listan över tidigare öppnade dokument.

virtual BOOL SaveMDIState(LPCTSTR lpszProfileName);

Parameterar

lpszProfileName
[i] Anger profilnamnet.

Returvärde

TRUE om spara lyckades; FALSE om det inte gick att spara.

Anmärkningar

Om du vill läsa in eller spara tillståndet för MDI-flikar och grupper och listan över öppnade dokument gör du följande:

• Anropa SaveMDIState när huvudramen stängs
• Anropa CMDIFrameWndEx::LoadMDIState när huvudramen skapas. Den rekommenderade platsen för det här anropet är innan huvudramen visas för första gången.
• Ring CWinAppEx::EnableLoadWindowPlacement(FALSE); innan pMainFrame->LoadFrame (IDR_MAINFRAME);
• Anropa CWinAppEx::ReloadWindowPlacement(pMainFrame) efter LoadMDIState för att visa huvudramen på den plats som lagrades i registret.
• Åsidosätt GetDocumentName i CMDIChildWndEx- härledd klass om ditt program visar dokument som inte lagras som filer. Den returnerade strängen sparas i registret som en dokumentidentifierare. Mer information finns i CMDIChildWndEx::GetDocumentName.
• Åsidosätt CMDIFrameWndEx::CreateDocumentWindow för att skapa dokument korrekt när de läses in från registret. Parametern till CreateDocumentWindow är strängen som GetDocumentName returnerades tidigare.

Exempel

I följande exempel visas hur SaveMDIState används i VisualStudioDemo-exemplet: MFC Visual Studio Application.

void CMainFrame::OnClose()
{
   SaveMDIState(theApp.GetRegSectionPath());
   CMDIFrameWndEx::OnClose();
}

CMDIFrameWndEx::SetPrintPreviewFrame

Anger fönstret för förhandsgranskningsramen.

void SetPrintPreviewFrame(CFrameWnd* pWnd);

Parameterar

pWnd
[i] Pekare till ett fönster för förhandsgranskningsram.

Anmärkningar

CMDIFrameWndEx::SetupToolbarMenu

Ändrar ett verktygsfältsobjekt genom att ersätta dummyobjekt med användardefinierade objekt.

void SetupToolbarMenu(
    CMenu& menu,
    const UINT uiViewUserToolbarCmdFirst,
    const UINT uiViewUserToolbarCmdLast);

Parameterar

menu
[i] En referens till ett CMenu klassobjekt som ska ändras.

uiViewUserToolbarCmdFirst
[i] Anger det första användardefinierade kommandot.

uiViewUserToolbarCmdLast
[i] Anger det senaste användardefinierade kommandot.

CMDIFrameWndEx::ShowFullScreen

Växlar huvudramen från vanligt läge till helskärmsläge.

void ShowFullScreen();

Anmärkningar

CMDIFrameWndEx::ShowPane

Visar eller döljer det angivna fönstret.

void ShowPane(
    CBasePane* pBar,
    BOOL bShow,
    BOOL bDelay,
    BOOL bActivate);

Parameterar

pBar
[i] Pekare till fönstret som ska visas eller döljas.

bShow
[i] TRUE för att visa fönstret. FALSE för att dölja fönstret.

bDelay
[i] TRUE för att fördröja omberäkningen av dockningslayouten. FALSE för att beräkna om dockningslayouten omedelbart.

bActivate
[i] TRUE för att visa fönstret som aktivt. FALSE för att visa fönstret som inaktivt.

Anmärkningar

Anropa den här metoden för att visa eller dölja fönstret. Använd inte ShowWindow för dockningsfönster.

Exempel

I följande exempel visas hur ShowPane används i VisualStudioDemo-exemplet: MFC Visual Studio Application.

void COutputList1::OnViewOutput()
{
   CBasePane* pParentBar = DYNAMIC_DOWNCAST(CBasePane, GetOwner());
   CFrameWndEx* pMainFrame = DYNAMIC_DOWNCAST(CFrameWndEx, GetTopLevelFrame());

   if (pMainFrame != NULL && pParentBar != NULL)
   {
      pMainFrame->SetFocus();
      pMainFrame->ShowPane(pParentBar, FALSE, FALSE, FALSE);
   }
}

CMDIFrameWndEx::ShowWindowsDialog

Skapar en CMFCWindowsManagerDialog ruta och öppnar den.

void ShowWindowsDialog();

Exempel

I följande exempel visas hur ShowWindowsDialog används i VisualStudioDemo-exemplet: MFC Visual Studio Application.

void CMainFrame::OnWindowManager()
{
   ShowWindowsDialog();
}

CMDIFrameWndEx::TabbedDocumentToControlBar

Konverterar det angivna dokumentet med flikar till ett dockningsfönster.

virtual BOOL TabbedDocumentToControlBar(CMDIChildWndEx* pMDIChildWnd);

Parameterar

pMDIChildWnd
En pekare till ett underordnat MDI-fönster som innehåller ett dockningsfönster.

Returvärde

TRUE om metoden lyckades vid FALSE fel.

Anmärkningar

Använd den här metoden för att konvertera ett tabbed-dokument till ett dockningsfönster. Dokumentet med flikar måste ha skapats med hjälp CMDIFrameWndEx::ControlBarToTabbedDocumentav .

Exempel

I följande exempel visas hur TabbedDocumentToControlBar används i VisualStudioDemo-exemplet: MFC Visual Studio Application.

void CMainFrame::OnMdiTabbedDocument()
{
   CMDIChildWndEx* pMDIChild = DYNAMIC_DOWNCAST(CMDIChildWndEx, MDIGetActive());
   if (pMDIChild == NULL)
   {
      ASSERT(FALSE);
      return;
   }

   TabbedDocumentToControlBar(pMDIChild);
}

CMDIFrameWndEx::UpdateCaption

Anropas av ramverket för att uppdatera undertexten för fönsterramen.

void UpdateCaption();

Anmärkningar

CMDIFrameWndEx::UpdateMDITabbedBarsIcons

Anger ikonen för varje fönster med MDI-flikar.

void UpdateMDITabbedBarsIcons();

CMDIFrameWndEx::WinHelp

Anropas av ramverket för att initiera WinHelp-programmet eller kontexthjälpen.

virtual void WinHelp(
    DWORD dwData,
    UINT nCmd = HELP_CONTEXT);

Parameterar

dwData
[i] Anger data som krävs för den typ av hjälp som anges av nCmd.

nCmd
[i] Anger vilken typ av hjälp som begärs. Mer information om möjliga värden och hur de påverkar parametern dwDatafinns i WinHelp .

Anmärkningar

Den här metoden åsidosätter CWnd::WinHelp.

Se även

hierarkidiagram
klasser
Klassen CMDIFrameWnd
Klassen CMDIChildWndEx