`CFrameWndEx` osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Megvalósítja a Windows egyetlen dokumentumfelület (SDI) átfedésben lévő vagy előugró keretablakának funkcióit, és biztosítja a tagok számára az ablak kezelését. Kibővíti az osztályt CFrameWnd .

Szemantika

class CFrameWndEx : public CFrameWnd

Tagok

Nyilvános metódusok

Név	Description
`CFrameWndEx::ActiveItemRecalcLayout`	Módosítja az OLE-ügyfélelem elrendezését és a keret ügyfélterületét.
`CFrameWndEx::AddDockSite`	Ez a módszer nem használható.
`CFrameWndEx::AddPane`	Regisztrál egy vezérlősávot a dokkolókezelővel.
`CFrameWndEx::AdjustDockingLayout`	Újraszámítja a keretablakhoz rögzített összes panel elrendezését.
`CFrameWndEx::DelayUpdateFrameMenu`	Beállítja a keretmenüt, majd frissíti, amikor a parancsfeldolgozás tétlen.
`CFrameWndEx::DockPane`	A megadott panel rögzítése a keretablakhoz.
`CFrameWndEx::DockPaneLeftOf`	Az egyik panelt egy másik ablaktábla bal oldalán rögzíti.
`CFrameWndEx::EnableAutoHidePanes`	Engedélyezi a panelek automatikus elrejtésének módját, amikor a főkeret ablakának megadott oldalához vannak rögzítve.
`CFrameWndEx::EnableDocking`	Engedélyezi a keretablakhoz tartozó panelek rögzítését.
`CFrameWndEx::EnableFullScreenMainMenu`	Teljes képernyős módban jeleníti meg vagy rejti el a főmenüt.
`CFrameWndEx::EnableFullScreenMode`	Engedélyezi a teljes képernyős módot a keretablakhoz.
`CFrameWndEx::EnableLoadDockState`	Engedélyezi vagy letiltja a dokkoló állapot betöltését.
`CFrameWndEx::EnablePaneMenu`	Engedélyezi vagy letiltja a panelmenü automatikus kezelését.
`CFrameWndEx::GetActivePopup`	Az aktuálisan megjelenített előugró menüre mutató mutatót ad vissza.
`CFrameWndEx::GetDefaultResId`	Azt az erőforrás-azonosítót adja vissza, amelyet akkor adott meg, amikor a keretrendszer betöltötte a keretablakot.
`CFrameWndEx::GetDockingManager`	Lekéri a `CDockingManager` keretablak Osztály objektumát.
`CFrameWndEx::GetMenuBar`	A keretablakhoz csatolt menüsáv-objektumra mutató mutatót ad vissza.
`CFrameWndEx::GetPane`	A megadott azonosítóval rendelkező panelre mutató mutatót ad vissza.
`CFrameWndEx::GetRibbonBar`	Lekéri a keret menüszalagsáv-vezérlőelemét.
`CFrameWndEx::GetTearOffBars`	A szakadás állapotú panelobjektumok listáját adja vissza.
`CFrameWndEx::GetToolbarButtonToolTipText`	A keretrendszer meghívja, amikor az alkalmazás megjeleníti az eszköztárgomb elemleírását.
`CFrameWndEx::InsertPane`	Egy panel regisztrálása a dokkolókezelővel.
`CFrameWndEx::IsFullScreen`	Meghatározza, hogy a keretablak teljes képernyős módban van-e.
`CFrameWndEx::IsMenuBarAvailable`	Meghatározza, hogy a menüsáv objektumára mutató mutató érvényes-e.
`CFrameWndEx::IsPointNearDockSite`	Azt jelzi, hogy a pont egy igazítási zónában található-e.
`CFrameWndEx::IsPrintPreview`	Azt jelzi, hogy a keretablak nyomtatási kép módban van-e.
`CFrameWndEx::LoadFrame`	Ezt a metódust az építés után hívjuk meg a keretablak létrehozásához és az erőforrások betöltéséhez.
`CFrameWndEx::NegotiateBorderSpace`	Implementálja az OLE ügyfélszegély-egyeztetést.
`CFrameWndEx::OnActivate`	A keretrendszer akkor hívja meg ezt a metódust, ha a rendszer a felhasználói bemenetet a keretre vagy a kerettől távolra váltja.
`CFrameWndEx::OnActivateApp`	A keretrendszer meghívja, amikor az alkalmazás ki van jelölve, vagy nincs bejelölve.
`CFrameWndEx::OnChangeVisualManager`	A keretrendszer meghívja, ha a keret módosítása a vizualizációkezelő módosítását igényli.
`CFrameWndEx::OnClose`	A keretrendszer ezt a metódust a keret bezárására hívja meg.
`CFrameWndEx::OnCloseDockingPane`	A keretrendszer meghívja, amikor a felhasználó a Dokkoló panel Bezárás gombjára kattint.
`CFrameWndEx::OnCloseMiniFrame`	A keretrendszer meghívta, amikor a felhasználó a Bezárás gombra kattint egy lebegő minikeretablakban.
`CFrameWndEx::OnClosePopupMenu`	A keretrendszer meghívja, amikor egy aktív előugró menü feldolgoz egy `WM_DESTROY` üzenetet.
`CFrameWndEx::OnCmdMsg`	Parancsüzenetek küldése.
`CFrameWndEx::OnContextHelp`	A keretrendszer meghívta, hogy megjelenítse a környezettel kapcsolatos súgót.
`CFrameWndEx::OnCreate`	A keret létrehozása után a keretrendszer hívja meg.
`CFrameWndEx::OnDestroy`	A keretrendszer meghívta, amikor a keret elpusztul.
`CFrameWndEx::OnDrawMenuImage`	A keretrendszer meghívja, amikor az alkalmazás megrajzolja a menüelemhez társított képet.
`CFrameWndEx::OnDrawMenuLogo`	A keretrendszer meghívja, amikor egy `CMFCPopupMenu` objektum feldolgoz egy `WM_PAINT` üzenetet.
`CFrameWndEx::OnDWMCompositionChanged`	A keretrendszer meghívja, ha a Desktop Window Manager (DWM) összeállítása engedélyezve van vagy le van tiltva.
`CFrameWndEx::OnExitSizeMove`	A keretrendszer hívja meg, ha a keret nem mozog vagy átméretez.
`CFrameWndEx::OnGetMinMaxInfo`	A keretrendszer meghívja a keret átméretezésekor az ablakméret korlátainak beállításához.
`CFrameWndEx::OnIdleUpdateCmdUI`	A keretrendszer meghívta a keret megjelenítésének frissítésére, amikor a parancsfeldolgozás tétlen.
`CFrameWndEx::OnLButtonDown`	A keretrendszer meghívja ezt a metódust, amikor a felhasználó lenyomja a bal egérgombot.
`CFrameWndEx::OnLButtonUp`	A keretrendszer meghívja ezt a metódust, amikor a felhasználó felengedi a bal egérgombot.
`CFrameWndEx::OnMenuButtonToolHitTest`	A keretrendszer meghívja, amikor egy `CMFCToolBarButton` objektum feldolgoz egy `WM_NCHITTEST` üzenetet.
`CFrameWndEx::OnMenuChar`	A keretrendszer meghívja, amikor megjelenik egy menü, és a felhasználó lenyom egy olyan kulcsot, amely nem felel meg egy parancsnak.
`CFrameWndEx::OnMouseMove`	A keretrendszer meghívja ezt a metódust, amikor a mutató mozog.
`CFrameWndEx::OnMoveMiniFrame`	A keretrendszer meghívta, amikor egy ablaktábla elmozdul.
`CFrameWndEx::OnNcActivate`	A keretrendszer meghívja, amikor a keret nem ügyfélterületét újra kell hívni, hogy jelezze az aktív állapot változását.
`CFrameWndEx::OnNcCalcSize`	A keretrendszer meghívja, amikor ki kell számítani az ügyfélterület méretét és pozícióját.
`CFrameWndEx::OnNcHitTest`	A keretrendszer meghívja, amikor a mutató mozog, vagy ha az egérgombot lenyomják vagy felengedik.
`CFrameWndEx::OnNcMouseMove`	A keretrendszer meghívja, amikor az egérmutató nem ügyfélterületen mozog.
`CFrameWndEx::OnNcPaint`	A keretrendszer meghívja, amikor a nem ügyfélterületet meg kell festeni.
`CFrameWndEx::OnPaneCheck`	A keretrendszer meghívta a panel láthatóságának szabályozására.
`CFrameWndEx::OnPostPreviewFrame`	A keretrendszer meghívta, amikor a felhasználó módosította a nyomtatási kép módot.
`CFrameWndEx::OnPowerBroadcast`	A keretrendszer meghívja, amikor energiagazdálkodási esemény történik.
`CFrameWndEx::OnSetMenu`	A keretrendszer meghívta a keretablak menüjének cseréjére.
`CFrameWndEx::OnSetPreviewMode`	A keretrendszer meghívta a keret nyomtatási képének beállításához.
`CFrameWndEx::OnSetText`	A keretrendszer meghívta egy ablak szövegének beállításához.
`CFrameWndEx::OnShowCustomizePane`	A keretrendszer meghívja, ha engedélyezve van egy gyors testreszabási panel.
`CFrameWndEx::OnShowPanes`	A keretrendszer meghívta a panelek megjelenítésére vagy elrejtésére.
`CFrameWndEx::OnShowPopupMenu`	A keretrendszer meghívja, ha engedélyezve van egy előugró menü.
`CFrameWndEx::OnSize`	A keretrendszer ezt a metódust a keret méretének módosítása után hívja meg.
`CFrameWndEx::OnSizing`	A keretrendszer ezt a metódust hívja meg, amikor a felhasználó átméretezi a keretet.
`CFrameWndEx::OnSysColorChange`	A keretrendszer meghívta, amikor a rendszer színe megváltozik.
`CFrameWndEx::OnTearOffMenu`	A keretrendszer meghívja, ha engedélyezve van egy letört sávot tartalmazó menü.
`CFrameWndEx::OnToolbarContextMenu`	A keretrendszer meghívta, hogy hozzon létre egy eszköztár helyi menüjét.
`CFrameWndEx::OnToolbarCreateNew`	A keretrendszer ezt a metódust egy új eszköztár létrehozásához hívja meg.
`CFrameWndEx::OnToolbarDelete`	Az eszköztár törlésekor a keretrendszer hívja meg.
`CFrameWndEx::OnUpdateFrameMenu`	A keretrendszer meghívta a keretmenü beállításához.
`CFrameWndEx::OnUpdateFrameTitle`	A keretrendszer meghívja ezt a metódust a keretablak címsorának frissítésére.
`CFrameWndEx::OnUpdatePaneMenu`	A keretrendszer meghívta a panel menüjének frissítéséhez.
`CFrameWndEx::OnWindowPosChanged`	A keretrendszer meghívta, amikor a keret mérete, pozíciója vagy z-sorrendje megváltozott egy ablakkezelési metódus hívása miatt.
`CFrameWndEx::PaneFromPoint`	A megadott pontot tartalmazó dokkolópanelt adja vissza.
`CFrameWndEx::PreTranslateMessage`	A küldés előtt kezeli az egyes ablaküzeneteket.
`CFrameWndEx::RecalcLayout`	Beállítja a keret és a gyermekablakok elrendezését.
`CFrameWndEx::RemovePaneFromDockManager`	Törli a panel regisztrációját, és eltávolítja azt a dokkolókezelő belső listájából.
`CFrameWndEx::SetDockState`	Visszaállítja a rögzítési elrendezést a beállításjegyzékben tárolt rögzítési állapotra.
`CFrameWndEx::SetPrintPreviewFrame`	Beállítja a nyomtatási képkeret ablakát.
`CFrameWndEx::SetupToolbarMenu`	Felhasználó által definiált parancsokat szúr be egy eszköztár menüjébe.
`CFrameWndEx::ShowFullScreen`	A főkeret váltása a teljes képernyő és a normál üzemmódok között.
`CFrameWndEx::ShowPane`	Megjeleníti vagy elrejti a megadott panelt.
`CFrameWndEx::UpdateCaption`	A keretrendszer meghívta az ablakkeret feliratának frissítéséhez.
`CFrameWndEx::WinHelp`	Meghívja az alkalmazást vagy a `WinHelp` környezettel kapcsolatos súgót.

Example

Az alábbi példa bemutatja, hogyan örökölhet egy osztályt az CFrameWndEx osztályból. A példa bemutatja az alosztály metódus-aláírásait és a metódus felülbírálásának OnShowPopupMenu módját. Ez a kódrészlet a Word Pad-minta része.

class CMainFrame : public CFrameWndEx
{
protected: // create from serialization only
   CMainFrame();
   DECLARE_DYNCREATE(CMainFrame)

   // Attributes
public:
   HICON m_hIconDoc;
   HICON m_hIconText;
   HICON m_hIconWrite;
   HICON GetIcon(int nDocType);

   // Operations
public:
   void UpdateMRUFilesList()
   {
      m_wndTaskPane.UpdateMRUFilesList();
   }

   void OnChangeLook();

   // Overrides
   // ClassWizard generated virtual function overrides
   //{{AFX_VIRTUAL(CMainFrame)
public:
   virtual void ActivateFrame(int nCmdShow = -1);
   virtual BOOL LoadFrame(UINT nIDResource,
                          DWORD dwDefaultStyle = WS_OVERLAPPEDWINDOW | FWS_ADDTOTITLE,
                          CWnd *pParentWnd = NULL,
                          CCreateContext *pContext = NULL);

protected:
   virtual BOOL PreCreateWindow(CREATESTRUCT &cs);
   virtual BOOL OnCommand(WPARAM wParam, LPARAM lParam);
   //}}AFX_VIRTUAL

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

protected:
   void AdjustObjectSubmenu(CMFCPopupMenu *pMenuPopup);
   void AdjustColorsMenu(CMFCPopupMenu *pMenuPopup, UINT uiId);

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

public:
   CMFCMenuBar m_wndMenuBar;
   CMFCToolBar m_wndToolBar;
   CMFCStatusBar m_wndStatusBar;
   CFormatBar m_wndFormatBar;
   CRulerBar m_wndRulerBar;
   CTaskPane m_wndTaskPane;

protected: // control bar embedded members
   BOOL CreateMenuBar();
   BOOL CreateToolBar();
   BOOL CreateFormatBar();
   BOOL CreateStatusBar();
   BOOL CreateRulerBar();
   BOOL CreateTaskPane();

   // Generated message map functions
protected:
   //{{AFX_MSG(CMainFrame)
   afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);
   afx_msg void OnSysColorChange();
   afx_msg void OnSize(UINT nType, int cx, int cy);
   afx_msg void OnMove(int x, int y);
   afx_msg void OnHelpFinder();
   afx_msg void OnDropFiles(HDROP hDropInfo);
   afx_msg void OnFontChange();
   afx_msg BOOL OnQueryNewPalette();
   afx_msg void OnPaletteChanged(CWnd *pFocusWnd);
   afx_msg void OnDevModeChange(LPTSTR lpDeviceName);
   afx_msg void OnViewCustomize();
   afx_msg void OnViewFullScreen();
   //}}AFX_MSG
   afx_msg LRESULT OnBarState(WPARAM wParam, LPARAM lParam);
   afx_msg LRESULT OnOpenMsg(WPARAM wParam, LPARAM lParam);
   afx_msg LRESULT OnHelpCustomizeToolbars(WPARAM wp, LPARAM lp);
   afx_msg LRESULT OnStartCustomize(WPARAM wp, LPARAM lp);
   afx_msg LRESULT OnToolbarCreateNew(WPARAM, LPARAM);
   afx_msg LRESULT OnGetDocumentColors(WPARAM, LPARAM);
   afx_msg void OnDummy();
   afx_msg void OnAskQuestion();
   DECLARE_MESSAGE_MAP()
};

// CMainFrame is application-defined object of type CFrameWndEx
BOOL CMainFrame::OnShowPopupMenu(CMFCPopupMenu *pMenuPopup)
{
   BOOL bRes = CFrameWndEx::OnShowPopupMenu(pMenuPopup);

   if (pMenuPopup != NULL && !pMenuPopup->IsCustomizePane())
   {
      AdjustObjectSubmenu(pMenuPopup);
      AdjustColorsMenu(pMenuPopup, ID_CHAR_COLOR);
   }

   return bRes;
}

Öröklési hierarchia

Requirements

Fejléc:afxframewndex.h

`CFrameWndEx::ActiveItemRecalcLayout`

Módosítja az OLE-ügyfélelem elrendezését és a keret ügyfélterületét.

void ActiveItemRecalcLayout();

Megjegyzések

`CFrameWndEx::AddPane`

Regisztrál egy vezérlősávot a dokkolókezelővel.

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

Paraméterek

pControlBar
[in] A regisztrálandó vezérlősáv panelje.

bTail
[in] TRUE ha hozzá szeretné adni a vezérlősáv panelt a lista végéhez; FALSE Egyébként.

Visszaadott érték

TRUE ha a vezérlősáv regisztrálása sikeresen megtörtént; FALSE Egyébként.

`CFrameWndEx::AdjustDockingLayout`

Újraszámítja a keretablakhoz rögzített összes panel elrendezését.

virtual void AdjustDockingLayout(HDWP hdwp=NULL);

Paraméterek

hdwp
Több ablak pozícióját tartalmazó szerkezet fogópontja. .

Megjegyzések

A hdwp struktúrát a BeginDeferWindowPos metódus inicializálja.

`CFrameWndEx::DelayUpdateFrameMenu`

Beállítja a keretmenüt, majd frissíti, amikor a parancsfeldolgozás tétlen.

virtual void DelayUpdateFrameMenu(HMENU hMenuAlt);

Paraméterek

hMenuAlt
[in] Másik menü kezelése.

Megjegyzések

`CFrameWndEx::DockPane`

A megadott panel rögzítése a keretablakhoz.

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

Paraméterek

pBar
[in] A rögzítendő vezérlősávra mutató mutató.

nDockBarID
[in] A keretablak oldalának azonosítója, amelyhez dokkol.

lpRect
[in] Egy állandó Rect szerkezetre mutató mutató, amely meghatározza az ablak képernyőpozícióját és méretét.

Megjegyzések

A nDockBarID paraméter a következő értékek egyikével rendelkezhet:

AFX_IDW_DOCKBAR_TOP
AFX_IDW_DOCKBAR_BOTTOM
AFX_IDW_DOCKBAR_LEFT
AFX_IDW_DOCKBAR_RIGHT

`CFrameWndEx::DockPaneLeftOf`

A megadott ablaktáblát egy másik ablaktábla bal oldalán rögzíti.

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

Paraméterek

pBar
[in] Mutató a rögzítendő ablaktábla-objektumra.

pLeftOf
[in] A bal oldali ablaktáblára mutató mutató a megadott pBarpanel rögzítéséhez.

Visszaadott érték

TRUE ha pBar a dokkolás sikeresen megtörtént. FALSE egyébként.

Megjegyzések

A metódus a paraméter által megadott eszköztárat veszi át, és a paraméter által pBarpLeftOf megadott eszköztár bal oldalán dokkolja.

`CFrameWndEx::EnableAutoHidePanes`

Engedélyezi az automatikus elrejtés módját az ablaktábla számára, ha a főkeret ablakának megadott oldalához van rögzítve.

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

Paraméterek

dwDockStyle
[in] A fő keretablak azon oldalát adja meg, amelyhez a panelt rögzíteni szeretné.

Visszaadott érték

TRUEha egy sávpanel sikeresen rögzítve van a keret ablakának azon oldalához, FALSE amely dwDockStyleegyébként meg van adva.

Megjegyzések

dwDockStyle az alábbi értékek egyikével rendelkezhet:

CBRS_ALIGN_TOP: lehetővé teszi a vezérlősáv rögzítését a keretablak ügyfélterületének tetejére.
CBRS_ALIGN_BOTTOM: lehetővé teszi a vezérlősáv rögzítését a keretablak ügyfélterületének aljára.
CBRS_ALIGN_LEFT: lehetővé teszi a vezérlősáv rögzítését a keretablak ügyfélterületének bal oldalán.
CBRS_ALIGN_RIGHT: lehetővé teszi a vezérlősáv rögzítését a keretablak ügyfélterületének jobb oldalán.

`CFrameWndEx::EnableDocking`

Engedélyezi a keretablak paneljeinek rögzítését.

BOOL EnableDocking(DWORD dwDockStyle);

Paraméterek

dwDockStyle
[in] A fő keretablak azon oldalát adja meg, ahol a panelsáv rögzítve van.

Visszaadott érték

TRUE ha egy sávpanel sikeresen rögzíthető a megadott oldalon. FALSE egyébként.

Megjegyzések

A dwDockStyle paraméter a következő értékek egyikével rendelkezhet:

CBRS_ALIGN_TOP
CBRS_ALIGN_BOTTOM
CBRS_ALIGN_LEFT
CBRS_ALIGN_RIGHT

`CFrameWndEx::EnableFullScreenMainMenu`

Teljes képernyős módban jeleníti meg vagy rejti el a főmenüt.

void EnableFullScreenMainMenu(BOOL bEnableMenu);

Paraméterek

bEnableMenu
[in] TRUE a főmenü teljes képernyős módban való megjelenítéséhez, FALSE ellenkező esetben.

`CFrameWndEx::EnableFullScreenMode`

Engedélyezi a teljes képernyős módot a keretablakhoz.

void EnableFullScreenMode(UINT uiFullScreenCmd);

Paraméterek

uiFullScreenCmd
[in] A teljes képernyős módot engedélyező és letiltó parancs azonosítója.

Megjegyzések

Teljes képernyős módban az összes dokkoló vezérlősáv, eszköztár és menü el van rejtve, és az aktív nézet átméretezése a teljes képernyős megjelenítésre történik.

A teljes képernyős mód engedélyezésekor meg kell adnia a parancs azonosítóját, amely engedélyezi vagy letiltja a teljes képernyős módot. A fő keret függvényéből OnCreate hívhatEnableFullScreenMode. Amikor egy keretablakot teljes képernyős módra vált, a keretrendszer létrehoz egy lebegő eszköztárat egy olyan gombbal, amely rendelkezik a megadott parancsazonosítóval.

Ha meg szeretné tartani a főmenüt a képernyőn, hívja fel a következőt CFrameWndEx::EnableFullScreenMainMenu:

`CFrameWndEx::EnableLoadDockState`

Engedélyezi vagy letiltja a dokkoló állapot betöltését.

void EnableLoadDockState(BOOL bEnable=TRUE);

Paraméterek

bEnable
[in] TRUE a dokkoló állapot betöltésének engedélyezéséhez, FALSE a dokkoló állapot betöltésének letiltásához.

`CFrameWndEx::EnablePaneMenu`

Engedélyezi vagy letiltja a panelmenü automatikus kezelését.

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

Paraméterek

bEnable
[in] TRUE a vezérlősáv előugró menüinek automatikus kezelésének engedélyezése; FALSE a vezérlősáv előugró menüinek automatikus kezelésének letiltásához.

uiCustomizeCmd
[in] A Testreszabás menüelem parancsazonosítója .

strCustomizeLabel
[in] A Testreszabás menüelemhez megjelenítendő címke

uiViewToolbarsMenuEntryID
[in] Az eszköztár menüelemének azonosítója, amely megnyitja az előugró menüt a vezérlősávon.

bContextMenuShowsToolbarsOnly
[in] Ha TRUE, a vezérlősáv helyi menüje csak az eszköztárak listáját jeleníti meg. Ha FALSE, a menü megjeleníti az eszköztárak és a dokkolósávok listáját.

bViewMenuShowsToolbarsOnly
[in] Ha TRUE, a vezérlősáv menüje csak az eszköztárak listáját jeleníti meg. Ha FALSE, a menü megjeleníti az eszköztárak és a dokkolósávok listáját.

`CFrameWndEx::GetActivePopup`

Az aktuálisan megjelenített előugró menüre mutató mutatót ad vissza.

CMFCPopupMenu* GetActivePopup() const;

Visszaadott érték

Mutató az aktuálisan megjelenített előugró menüre; egyéb esetben NULL.

`CFrameWndEx::GetDefaultResId`

Azt az erőforrás-azonosítót adja vissza, amelyet akkor adott meg, amikor a keretrendszer betöltötte a keretablakot.

UINT GetDefaultResId() const;

Visszaadott érték

Az erőforrás-azonosító értéke, amelyet a felhasználó adott meg, amikor a keretrendszer betöltötte a keretablakot. Nulla, ha a keretablakban nincs menüsáv.

`CFrameWndEx::GetDockingManager`

Lekéri a CDockingManager keretablak Osztály objektumát.

CDockingManager* GetDockingManager();

Visszaadott érték

Mutató az CDockingManager osztályhoz.

Megjegyzések

A keretablak egy CDockingManager osztályobjektumot hoz létre és használ a gyermekablak dokkolásának kezeléséhez.

`CFrameWndEx::GetMenuBar`

A keretablakhoz csatolt menüsáv-objektumra mutató mutatót ad vissza.

const CMFCMenuBar* GetMenuBar() const;

Visszaadott érték

A keretablakhoz csatolt menüsáv-objektumra mutató mutató.

`CFrameWndEx::GetPane`

A megadott azonosítóval rendelkező panelre mutató mutatót ad vissza.

CBasePane* GetPane(UINT nID);

Paraméterek

nID
[in] A vezérlő azonosítója.

Visszaadott érték

Mutató a megadott azonosítóval rendelkező panelre. NULL ha nincs ilyen ablaktábla.

`CFrameWndEx::GetRibbonBar`

Lekéri a keret menüszalagsáv-vezérlőelemét.

CMFCRibbonBar* GetRibbonBar();

Visszaadott érték

Mutasson a CMFCRibbonBar keret osztályára .

Megjegyzések

`CFrameWndEx::GetTearOffBars`

A szakadás állapotú panelobjektumok listáját adja vissza.

const CObList& GetTearOffBars() const;

Visszaadott érték

Hivatkozás azokra az objektumokra CObList , amelyek mutatógyűjteményt tartalmaznak az elszakítandó állapotban lévő panelobjektumokra.

`CFrameWndEx::GetToolbarButtonToolTipText`

A keretrendszer meghívja, amikor az alkalmazás megjeleníti az eszköztárgomb elemleírását.

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

Paraméterek

pButton
[in] Egérmutató egy eszköztárgombhoz.

strTTText
[in] A gombhoz megjelenítendő elemleírás szövege.

Visszaadott érték

TRUE ha az elemleírás megjelenik. FALSE egyébként.

Megjegyzések

Alapértelmezés szerint ez a metódus nem tesz semmit. Bírálja felül ezt a metódust, ha meg szeretné jeleníteni az eszköztár gomb elemleírását.

`CFrameWndEx::InsertPane`

Beszúr egy panelt a vezérlősávok listájába, és regisztrálja azt a dokkolókezelőnél.

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

Paraméterek

pControlBar
Egy vezérlősávra mutató mutató, amelyet be szeretne szúrni a vezérlősávok listájába, és regisztrálva van a dokkolókezelőben.

pTarget
Egy vezérlősávra mutató mutató, amely előtt vagy után be szeretné szúrni az ablaktáblát.

bAfter
TRUE ha utána szeretne beszúrni pControlBarpTarget, FALSE ellenkező esetben.

Visszaadott érték

TRUE ha a vezérlősávot sikeresen beszúrták és regisztrálták, FALSE ellenkező esetben.

Megjegyzések

Az egyes vezérlősávokat az CDockingManager Osztály használatával kell regisztrálnia, hogy részt vegyen a dokkolás elrendezésében.

`CFrameWndEx::IsFullScreen`

Meghatározza, hogy a keretablak teljes képernyős módban van-e.

BOOL IsFullScreen() const;

Visszaadott érték

TRUE ha a keretablak teljes képernyős módban van; egyéb esetben FALSE.

Megjegyzések

A teljes képernyős módot a metódus meghívásával CFrameWndEx::EnableFullScreenMode állíthatja be.

`CFrameWndEx::IsMenuBarAvailable`

Meghatározza, hogy a menüsáv objektumára mutató mutató érvényes-e.

BOOL IsMenuBarAvailable() const;

Visszaadott érték

TRUE ha a keretablak menüsávja van; egyéb esetben FALSE.

`CFrameWndEx::IsPointNearDockSite`

Meghatározza, hogy a pont egy igazítási zónában található-e.

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

Paraméterek

point
[in] A pont pozíciója.

dwBarAlignment
[kifelé] A pont igazításának helye. A lehetséges értékekért tekintse meg a Megjegyzések szakaszban található táblázatot.

bOuterEdge
[kifelé] TRUE ha a pont a keretszegély közelében található; FALSE ha a pont egy ügyfélterületen található.

Visszaadott érték

TRUEha a pont egy igazítási zónában található; egyéb esetben. FALSE

Megjegyzések

Az alábbi táblázat a paraméter lehetséges értékeit sorolja fel dwBarAlignment .

Érték	Description
`CBRS_ALIGN_TOP`	Felülre igazítva.
`CBRS_ALIGN_RIGHT`	Jobbra igazítva.
`CBRS_ALIGN_BOTTOM`	Alulra igazítva.
`CBRS_ALIGN_LEFT`	Balra igazítva.

`CFrameWndEx::IsPrintPreview`

Meghatározza, hogy a keretablak nyomtatási kép módban van-e.

BOOL IsPrintPreview();

Visszaadott érték

TRUEha a keretablak nyomtatási kép módban van; egyéb esetben. FALSE

Megjegyzések

`CFrameWndEx::LoadFrame`

Ezt a metódust az építés után hívjuk meg a keretablak létrehozásához és az erőforrások betöltéséhez.

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

Paraméterek

nIDResource
[in] Az összes kereterőforrás betöltéséhez használt erőforrás-azonosító.

dwDefaultStyle
[in] Az alapértelmezett keretablakstílus.

pParentWnd
[in] Mutasson a keret szülőablakára.

pContext
[in] Mutasson egy CCreateContext struktúraosztályra , amelyet a keretrendszer használ az alkalmazás létrehozása során.

Visszaadott érték

TRUEha a módszer sikeres volt; egyéb esetben. FALSE

Megjegyzések

`CFrameWndEx::NegotiateBorderSpace`

Implementálja az OLE ügyfélszegély-egyeztetést.

virtual BOOL NegotiateBorderSpace(
    UINT nBorderCmd,
    LPRECT lpRectBorder);

Paraméterek

nBorderCmd
[in] A határ-egyeztetési parancs. A lehetséges értékekért tekintse meg a Megjegyzések szakaszt.

lpRectBorder
[be, ki] A szegély méretei.

Visszaadott érték

TRUEha az elrendezést újra kell számítani; egyéb esetben. FALSE

Megjegyzések

Az alábbi táblázat a paraméter lehetséges értékeit sorolja fel nBorderCmd .

borderGet
Szabad OLE-ügyféltér lekérése.

borderRequest
OLE-ügyfélterület kérése.

borderSet
OLE-ügyféltér beállítása.

`CFrameWndEx::OnActivate`

A keretrendszer akkor hívja meg ezt a metódust, ha a rendszer a felhasználói bemenetet a keretre vagy a kerettől távolra váltja.

afx_msg void OnActivate(
    UINT nState,
    CWnd* pWndOther,
    BOOL bMinimized);

Paraméterek

nState
[in] A keret aktív vagy inaktív. A lehetséges értékekért tekintse meg a Megjegyzések szakaszban található táblázatot.

pWndOther
[in] Mutasson egy másik ablakra, amely a felhasználói bemenetet az aktuáliskal váltja.

bMinimized
[in] A keret minimálisra csökkentett állapota. TRUEha a keret kis méretű; egyéb esetben. FALSE

Megjegyzések

Az alábbi táblázat a paraméter lehetséges értékeit sorolja fel nState .

Érték	Description
`WA_ACTIVE`	A keretet az egérkattintástól eltérő metódus választja ki.
`WA_CLICKACTIVE`	A keret kijelölése kattintással történik.
`WA_INACTIVE`	A keret nincs kijelölve.

`CFrameWndEx::OnActivateApp`

A keretrendszer meghívja, amikor az alkalmazás ki van jelölve, vagy nincs bejelölve.

afx_msg void OnActivateApp(
    BOOL bActive,
    DWORD dwThreadID);

Paraméterek

bActive
[in] TRUE ha az alkalmazás ki van választva; FALSE ha az alkalmazás nincs kijelölve.

dwThreadID
[in] Ezt a paramétert nem használja a rendszer.

Megjegyzések

`CFrameWndEx::OnChangeVisualManager`

A keretrendszer meghívja, ha a keret módosítása a vizualizációkezelő módosítását igényli.

afx_msg LRESULT OnChangeVisualManager(
    WPARAM wParam,
    LPARAM lParam);

Paraméterek

wParam
[in] Ezt a paramétert nem használja a rendszer.

lParam
[in] Ezt a paramétert nem használja a rendszer.

Visszaadott érték

Mindig 0-t ad.

Megjegyzések

`CFrameWndEx::OnClose`

A keretrendszer ezt a metódust a keret bezárására hívja meg.

afx_msg void OnClose();

Megjegyzések

Ha a keret nyomtatási kép módban van, egy Windows-üzenetet küld a nyomtatási kép bezárásához; ellenkező esetben, ha a keret OLE-ügyfelet üzemeltet, az ügyfél inaktiválva lesz.

`CFrameWndEx::OnCloseDockingPane`

A keretrendszer meghívja, amikor a felhasználó a Dokkoló panel Bezárás gombjára kattint.

virtual BOOL OnCloseDockingPane(CDockablePane* pPane);

Visszaadott érték

TRUE ha a dokkolósáv bezárható. FALSE egyébként

Megjegyzések

Az alapértelmezett implementálás nem tesz semmit. Bírálja felül ezt a módszert, ha kezelni szeretné a dokkolósáv elrejtését.

`CFrameWndEx::OnCloseMiniFrame`

A keretrendszer meghívta, amikor a felhasználó a Bezárás gombra kattint egy lebegő minikeretablakban.

virtual BOOL OnCloseMiniFrame(CPaneFrameWnd* pWnd);

Visszaadott érték

TRUE ha egy lebegő minikeret ablaka bezárható. FALSE egyébként.

Megjegyzések

Az alapértelmezett implementáció nem végez semmit. Bírálja felül ezt a módszert, ha egy lebegő minikeret ablakának elrejtését szeretné feldolgozni.

`CFrameWndEx::OnClosePopupMenu`

A keretrendszer meghívja, amikor egy aktív előugró menü feldolgoz egy WM_DESTROY üzenetet.

virtual void OnClosePopupMenu(CMFCPopupMenu* pMenuPopup);

Paraméterek

pMenuPopup
Mutató egy előugró menüre.

Megjegyzések

A keretrendszer üzenetet WM_DESTROY küld, amikor be szeretné zárni az ablakot. Bírálja felül ezt a módszert, ha a keretablakhoz tartozó objektumok értesítéseit CMFCPopupMenu szeretné kezelni, amikor egy CMFCPopupMenu objektum feldolgozza WM_DESTROY a keretrendszer által az ablak bezárásakor küldött üzenetet.

`CFrameWndEx::OnCmdMsg`

Parancsüzenetek küldése.

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

Paraméterek

nID
[in] A parancs azonosítója.

nCode
[in] Parancsüzenet-kategória.

pExtra
[be, ki] Mutasson egy parancsobjektumra.

pHandlerInfo
[be, ki] Mutató egy parancskezelő struktúrára.

Visszaadott érték

TRUEha a parancsüzenetet kezelték; egyéb esetben. FALSE

Megjegyzések

`CFrameWndEx::OnContextHelp`

A keretrendszer meghívta a környezettel kapcsolatos súgó megjelenítéséhez.

afx_msg void OnContextHelp();

Megjegyzések

`CFrameWndEx::OnCreate`

A keret létrehozása után a keretrendszer hívja meg.

afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);

Paraméterek

lpCreateStruct
[in] Az új keret struktúrájának mutatójaCREATESTRUCT.

Visszaadott érték

0 a keret létrehozásának folytatásához; -1, hogy elpusztítsa a keretet.

Megjegyzések

`CFrameWndEx::OnDestroy`

A keretrendszer meghívta, amikor a keret elpusztul.

afx_msg void OnDestroy();

Megjegyzések

A gázpedál és az összes ablak elpusztul.

`CFrameWndEx::OnDrawMenuImage`

A keretrendszer meghívja, amikor az alkalmazás megrajzolja a menüelemhez társított képet.

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

Paraméterek

pDC
[in] Egy eszközkörnyezetre mutató mutató.

pMenuButton
[in] Egy menügombra mutató mutató, amelynek képe renderelve van.

rectImage
[in] A kép képernyőpozícióját és méretét meghatározó struktúra mutatója Rect .

Visszaadott érték

TRUE ha a keretrendszer sikeresen rendereli a képet; FALSE Egyébként.

Megjegyzések

Bírálja felül ezt a módszert, ha testre szeretné szabni a képmegjelenítést a származtatott objektum által CFrameWndEx birtokolt menüsávhoz tartozó menüelemekhez.

`CFrameWndEx::OnDrawMenuLogo`

A keretrendszer meghívja, amikor egy CMFCPopupMenu objektum feldolgoz egy WM_PAINT üzenetet.

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

Paraméterek

pDC
[in] Egy eszközkörnyezetre mutató mutató.

pMenu
[in] A menüelemre mutató mutató.

rectLogo
[in] Egy állandó CRect szerkezetre mutató hivatkozás, amely meghatározza a menü emblémájának képernyőpozícióját és méretét.

Megjegyzések

Bírálja felül ezt a függvényt, ha az előugró menüben egy emblémát szeretne megjeleníteni, amely a származtatott objektum tulajdonában CFrameWndEx lévő menüsávhoz tartozik.

`CFrameWndEx::OnDWMCompositionChanged`

A keretrendszer meghívja, ha a Desktop Window Manager (DWM) összeállítása engedélyezve van vagy le van tiltva.

afx_msg LRESULT OnDWMCompositionChanged(
    WPARAM wp,
    LPARAM lp);

Paraméterek

wp
[in] Ezt a paramétert nem használja a rendszer.

lp
[in] Ezt a paramétert nem használja a rendszer.

Visszaadott érték

Mindig 0-t ad.

Megjegyzések

`CFrameWndEx::OnExitSizeMove`

A keretrendszer hívja meg, ha a keret nem mozog vagy átméretez.

LRESULT OnExitSizeMove(
    WPARAM wp,
    LPARAM lp);

Paraméterek

wp
[in] Ezt a paramétert nem használja a rendszer.

lp
[in] Ezt a paramétert nem használja a rendszer.

Visszaadott érték

Mindig 0-t ad.

Megjegyzések

`CFrameWndEx::OnGetMinMaxInfo`

A keretrendszer meghívja a keret átméretezésekor az ablakméret korlátainak beállításához.

afx_msg void OnGetMinMaxInfo(MINMAXINFO FAR* lpMMI);

Paraméterek

lpMMI
[in] Mutató egy struktúrára MINMAXINFO .

Megjegyzések

`CFrameWndEx::OnIdleUpdateCmdUI`

A keretrendszer meghívta a keret megjelenítésének frissítésére, amikor a parancsfeldolgozás tétlen.

afx_msg LRESULT OnIdleUpdateCmdUI(
    WPARAM wParam = 0,
    LPARAM lParam = 0);

Paraméterek

wParam
[in] Ezt a paramétert nem használja a rendszer.

lParam
[in] Ezt a paramétert nem használja a rendszer.

Visszaadott érték

Mindig 0-t ad.

Megjegyzések

`CFrameWndEx::OnLButtonDown`

A keretrendszer meghívja ezt a metódust, amikor a felhasználó lenyomja a bal egérgombot.

afx_msg void OnLButtonDown(
    UINT nFlags,
    CPoint point);

Paraméterek

nFlags
[in] Azt jelzi, hogy a felhasználó lenyomta-e a módosító kulcsokat. A lehetséges értékekért tekintse meg a paramétert wParam az ÉrtesítésbenWM_LBUTTONDOWN.

point
[in] A mutató x és y koordinátáit adja meg az ablak bal felső sarkához viszonyítva.

Megjegyzések

`CFrameWndEx::OnLButtonUp`

A keretrendszer meghívja ezt a metódust, amikor a felhasználó felengedi a bal egérgombot.

afx_msg void OnLButtonUp(
    UINT nFlags,
    CPoint point);

Paraméterek

nFlags
[in] Azt jelzi, hogy a felhasználó lenyomta-e a módosító kulcsokat. A lehetséges értékekért tekintse meg a paramétert wParam az ÉrtesítésbenWM_LBUTTONUP.

point
[in] A mutató x és y koordinátáit adja meg az ablak bal felső sarkához viszonyítva.

Megjegyzések

`CFrameWndEx::OnMenuButtonToolHitTest`

A keretrendszer meghívja, amikor egy CMFCToolBarButton objektum feldolgoz egy WM_NCHITTEST üzenetet.

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

Paraméterek

pButton
[in] Mutató az eszközsáv gombjára.

pTI
[kifelé] Egy eszközinformációs struktúra mutatója.

Visszaadott érték

TRUE ha az alkalmazás kitölti a paramétert pTI . FALSE egyébként.

Megjegyzések

Bírálja felül ezt a metódust, ha elemleírást szeretne megadni egy adott menüelemről.

`CFrameWndEx::OnMenuChar`

A keretrendszer meghívja, amikor megjelenik egy menü, és a felhasználó lenyom egy olyan kulcsot, amely nem felel meg egy parancsnak.

afx_msg LRESULT OnMenuChar(
    UINT nChar,
    UINT nFlags,
    CMenu* pMenu);

Paraméterek

nChar
[in] A lenyomott kulcs karakterkódja.

nFlags
[in] A jelölőt MF_POPUP tartalmazza, ha a megjelenített menü egy almenü; tartalmazza a MF_SYSMENU jelölőt, ha a megjelenő menü egy vezérlőmenü.

pMenu
[in] Mutasson egy menüre.

Visszaadott érték

A magasrendű szónak az alábbi értékek egyikének kell lennie.

Érték	Description
`0`	A keretrendszernek figyelmen kívül kell hagynia a billentyűleütést.
`1`	A keretrendszernek be kell zárnia a menüt.
`2`	A keretrendszernek ki kell választania a menüben megjelenő elemek egyikét. Az alacsony sorrendű szó tartalmazza a kijelölendő parancs azonosítóját.

`CFrameWndEx::OnMouseMove`

A keretrendszer meghívja ezt a metódust, amikor a mutató mozog.

afx_msg void OnMouseMove(
    UINT nFlags,
    CPoint point);

Paraméterek

nFlags
[in] Azt jelzi, hogy egy felhasználó lenyomta-e a módosító kulcsokat. A lehetséges értékekért tekintse meg a paramétert wParam az ÉrtesítésbenWM_MOUSEMOVE.

point
[in] x Az ablak bal felső sarkához viszonyítva adja meg a mutató koordinátáit és y koordinátáit.

Megjegyzések

`CFrameWndEx::OnMoveMiniFrame`

A keretrendszer meghívta, amikor egy ablaktábla elmozdul.

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

Paraméterek

pFrame
[in] Mutasson az CPaneFrameWnd Osztály ablakra.

Visszaadott érték

TRUE ha az ablaktábla nincs rögzítve; FALSE ha az ablaktábla rögzítve van.

Megjegyzések

`CFrameWndEx::OnNcActivate`

A keretrendszer meghívja, amikor a keret nem ügyfélterületét újra kell hívni, hogy jelezze az aktív állapot változását.

afx_msg BOOL OnNcActivate(BOOL bActive);

Paraméterek

bActive
[in] TRUE a keret aktív rajzolásához; FALSE a keret inaktívvá tételéhez.

Visszaadott érték

Nonzero az alapértelmezett feldolgozás folytatásához; 0 a nem ügyfélterület inaktiválásának megakadályozása érdekében.

Megjegyzések

`CFrameWndEx::OnNcCalcSize`

A keretrendszer meghívja, amikor ki kell számítani az ügyfélterület méretét és pozícióját.

afx_msg void OnNcCalcSize(
    BOOL bCalcValidRects,
    NCCALCSIZE_PARAMS FAR* lpncsp);

Paraméterek

bCalcValidRects
[in] TRUE amikor az alkalmazásnak érvényes ügyfélterületet kell megadnia; egyéb esetben. FALSE

lpncsp
[in] Mutasson egy NCCALCSIZE_PARAMS olyan struktúrára, amely keretdimenzió-módosításokat tartalmaz.

Megjegyzések

`CFrameWndEx::OnNcHitTest`

A keretrendszer meghívja, amikor a mutató mozog, vagy ha az egérgombot lenyomják vagy felengedik.

afx_msg LRESULT OnNcHitTest(CPoint point);

Paraméterek

point
[in] A mutató helye a képernyő koordinátáiban.

Visszaadott érték

Egy mutató enumerált értéket talált. A lehetséges értékek listáját az Értesítés című témakörben találjaWM_NCHITTEST.

Megjegyzések

`CFrameWndEx::OnNcMouseMove`

A keretrendszer meghívja, amikor az egérmutató nem ügyfélterületen mozog.

afx_msg void OnNcMouseMove(
    UINT nHitTest,
    CPoint point);

Paraméterek

nHitTest
[in] Egy mutató enumerált értéket talált. A lehetséges értékek listáját az Értesítés című témakörben találjaWM_NCHITTEST.

point
[in] A mutató helye a képernyő koordinátáiban.

Megjegyzések

`CFrameWndEx::OnNcPaint`

A keretrendszer meghívja, amikor a nem ügyfélterületet meg kell festeni.

afx_msg void OnNcPaint();

Megjegyzések

`CFrameWndEx::OnPaneCheck`

A keretrendszer meghívta a panel láthatóságának szabályozására.

afx_msg BOOL OnPaneCheck(UINT nID);

Paraméterek

nID
[in] Panel vezérlőazonosítója.

Visszaadott érték

TRUE ha a parancsot kezelték; FALSE parancsfeldolgozás folytatásához.

Megjegyzések

`CFrameWndEx::OnPostPreviewFrame`

A keretrendszer meghívta, amikor a felhasználó megváltoztatja a nyomtatási kép módot.

afx_msg LRESULT OnPostPreviewFrame(
    WPARAM wParam,
    LPARAM lParam);

Paraméterek

wParam
[in] Ezt a paramétert nem használja a rendszer.

lParam
[in] TRUE ha a keret nyomtatási kép módban van; FALSE ha a nyomtatási kép mód ki van kapcsolva.

Visszaadott érték

Mindig 0-t ad.

Megjegyzések

`CFrameWndEx::OnPowerBroadcast`

A keretrendszer meghívja, amikor energiagazdálkodási esemény történik.

afx_msg LRESULT OnPowerBroadcast(
    WPARAM wp,
    LPARAM lp);

Paraméterek

wp
[in] Az energiagazdálkodási esemény. A lehetséges értékek listáját az Üzenetben találjaWM_POWERBROADCAST.

lp
[in] Ezt a paramétert nem használja a rendszer.

Visszaadott érték

Az alapértelmezett ablakeljárás meghívásának eredménye.

Megjegyzések

`CFrameWndEx::OnSetMenu`

A keretrendszer meghívta a keretablak menüjének cseréjére.

afx_msg LRESULT OnSetMenu(
    WPARAM wp,
    LPARAM lp);

BOOL OnSetMenu(HMENU hmenu);

Paraméterek

wp
[in] Az új keretablak menüjének kezelése.

lp
[in] Az új ablak menü kezelése.

hmenu
[in] Az új keretablak menüjének kezelése.

Visszaadott érték

LRESULT az alapértelmezett ablakeljárás meghívásának eredménye.

A BOOL az, TRUE ha az eseményt kezelték; FALSEellenkező esetben.

Megjegyzések

`CFrameWndEx::OnSetPreviewMode`

A keretrendszer meghívta a keret nyomtatási képének beállításához.

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

Paraméterek

bPreview
[in] TRUE a nyomtatási kép engedélyezéséhez; FALSE a nyomtatási kép letiltásához.

pState
[in] Mutató egy CPrintPreviewState keretállapot-struktúrára.

Megjegyzések

`CFrameWndEx::OnSetText`

A keretrendszer meghívta egy ablak szövegének beállításához.

afx_msg LRESULT OnSetText(
    WPARAM wParam,
    LPARAM lParam);

Paraméterek

wParam
[in] Ezt a paramétert nem használja a rendszer.

lParam
[in] Mutasson az ablak szövegére.

Visszaadott érték

A hívás értékének visszaadása DefWindowProc.

Megjegyzések

`CFrameWndEx::OnShowCustomizePane`

A keretrendszer meghívja, amikor megjelenít egy QuickCustomizePane.

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

Paraméterek

pMenuPane
[in] Mutató a gyors testreszabás panelre.

uiToolbarID
[in] A testre szabandó eszköztár vezérlőazonosítója.

Visszaadott érték

Ez a metódus mindig visszaadja a függvényt TRUE.

Megjegyzések

A gyors testreszabás menü egy előugró menü, amely az eszköztár testreszabási gombjára kattintva jelenik meg

`CFrameWndEx::OnShowPanes`

A keretrendszer meghívta a panelek megjelenítésére vagy elrejtésére.

virtual BOOL OnShowPanes(BOOL bShow);

Paraméterek

bShow
[in] TRUE ha az alkalmazás megjeleníti a paneleket; FALSE Egyébként.

Visszaadott érték

Ez a metódus mindig visszaadja a függvényt FALSE.

Megjegyzések

Az alapértelmezett implementáció megjeleníti az ablaktáblákat, ha bShow igen, TRUE és az ablaktáblák rejtettek, vagy ha bShow igen, FALSE és a panelek láthatók.

Az alapértelmezett implementáció elrejti a paneleket, ha bShow igen TRUE , és az ablaktáblák láthatók, vagy ha bShow igen, FALSE és a panelek rejtettek.

Felülbírálja ezt a metódust egy származtatott osztályban az egyéni kód végrehajtásához, amikor a keretrendszer paneleket jelenít meg vagy rejt el.

`CFrameWndEx::OnShowPopupMenu`

A keretrendszer meghívja, amikor előugró menüt jelenít meg.

virtual BOOL OnShowPopupMenu(CMFCPopupMenu* pMenu);

Paraméterek

pMenu
[in] Mutató egy előugró menüre.

Visszaadott érték

TRUE ha az előugró menü látható; egyéb esetben FALSE.

Megjegyzések

Felülbírálja ezt a metódust egy származtatott osztályban, hogy egyéni kódot hajtson végre, amikor a keretrendszer előugró menüt jelenít meg. Felülbírálhatja például ezt a módszert a parancsok háttérszínének módosításához egy előugró menüben.

`CFrameWndEx::OnSize`

A keretrendszer a keret méretének változása után hívja meg.

afx_msg void OnSize(
    UINT nType,
    int cx,
    int cy);

Paraméterek

nType
[in] Az átméretezés típusa. A lehetséges értékekért tekintse meg a paramétert wParam az WM_SIZE Notificationben.

cx
[in] A keret új szélessége képpontban.

cy
[in] A keret új magassága képpontban.

Megjegyzések

`CFrameWndEx::OnSizing`

A keretrendszer meghívja, amikor a felhasználó átméretezi a keretet.

afx_msg void OnSizing(
    UINT fwSide,
    LPRECT pRect);

Paraméterek

fwSide
[in] Az áthelyezett keret széle. Tekintse meg a paramétert wParam az ÉrtesítésbenWM_SIZING.

pRect
[be, ki] Mutasson a CRect keret koordinátáit tartalmazó szerkezetre RECT vagy szerkezetre.

Megjegyzések

`CFrameWndEx::OnSysColorChange`

A keretrendszer meghívta, amikor a rendszer színe megváltozik.

void OnSysColorChange();

Megjegyzések

`CFrameWndEx::OnTearOffMenu`

A keretrendszer meghívta, amikor az alkalmazás egy letört sávot tartalmazó menüt jelenít meg.

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

Paraméterek

pMenuPopup
[in] Mutató egy előugró menüre.

pBar
[in] Mutató egy letört sávra.

Visszaadott érték

TRUE ha engedélyezve van a felugró menü és a letört sáv; egyéb esetben FALSE.

Megjegyzések

Felülbírálja ezt a metódust egy származtatott osztályban, hogy egyéni kódot hajtson végre, amikor a keretrendszer egy vezérlősávot jelenít meg.

Az alapértelmezett implementáció nem végez semmit, és visszaadja azt TRUE.

`CFrameWndEx::OnToolbarContextMenu`

A keretrendszer meghívta az eszköztár előugró menüjének létrehozásához.

afx_msg LRESULT OnToolbarContextMenu(
    WPARAM wp,
    LPARAM lp);

Paraméterek

wp
[in] Ezt a paramétert nem használja a rendszer.

lp
[in] Ezt a paramétert nem használja a rendszer.

Visszaadott érték

Mindig 1-et ad vissza.

Megjegyzések

`CFrameWndEx::OnToolbarCreateNew`

A keretrendszer ezt a metódust egy új eszköztár létrehozásához hívja meg.

afx_msg LRESULT OnToolbarCreateNew(
    WPARAM wp,
    LPARAM lp);

Paraméterek

wp
[in] Ezt a paramétert nem használja a rendszer.

lp
[in] Mutasson az eszköztár címsorának szövegére.

Visszaadott érték

Mutató az új eszköztárra; vagy NULL ha nem hozott létre eszköztárat.

Megjegyzések

`CFrameWndEx::OnToolbarDelete`

Az eszköztár törlésekor a keretrendszer hívja meg.

afx_msg LRESULT OnToolbarDelete(
    WPARAM /* unused */,
    LPARAM lp);

`CFrameWndEx::PaneFromPoint`

Minden panelen megkeresi az adott pontot.

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

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

Paraméterek

point
[in] Az ellenőrizni kívánt pont képernyőkoordinátái.

nSensitivity
[in] A pont keresésekor bontsa ki az egyes vezérlősávok határoló téglalapját ezzel az összeggel.

bExactBar
[in] TRUE paraméter figyelmen kívül hagyásanSensitivity; ellenkező esetben. FALSE

pRTCBarType
[in] Ha nem NULL, a metódus csak a megadott típusú vezérlősávokat keresi.

dwAlignment
[kifelé] Ha sikeres, ez a paraméter a vezérlősávnak a megadott ponthoz legközelebbi oldalát tartalmazza. Ellenkező esetben ez a paraméter nincs inicializálva.

Visszaadott érték

Mutató egy vezérlősávra, amely tartalmazza a point; NULL értéket, ha nem található vezérlő.

Megjegyzések

Ez a metódus az alkalmazás összes vezérlősávjában keres egy point.

A keresési terület méretének növeléséhez használható nSensitivity . A metódus által keresett vezérlősávok típusainak korlátozására használható pRTCBarType .

`CFrameWndEx::PreTranslateMessage`

A küldés előtt kezeli az egyes ablaküzeneteket.

virtual BOOL PreTranslateMessage(MSG* pMsg);

Paraméterek

pMsg
[in] A feldolgozandó üzenetet tartalmazó struktúra mutatója MSG .

Visszaadott érték

Nem nulla, ha az üzenetet kezelték, és nem kellett volna elküldeni; 0, ha az üzenetet nem kezelte, és el kell küldeni.

Megjegyzések

`CFrameWndEx::RecalcLayout`

Beállítja a keret és a gyermekablakok elrendezését.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Paraméterek

bNotify
[in] Megadja, hogy az OLE-ügyfélelem értesítést küld-e az elrendezés módosításáról.

Megjegyzések

Ezt a metódust akkor hívjuk meg, ha a keretablak mérete megváltozott, vagy amikor a vezérlősávok megjelennek vagy rejtettek.

`CFrameWndEx::RemovePaneFromDockManager`

Törli a panel regisztrációját, és eltávolítja azt a dokkolókezelőből.

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

Paraméterek

pControlBar
[in] Az eltávolítandó vezérlősáv panelre mutató mutató.

bDestroy
[in] TRUE a vezérlősáv eltávolítását követően megsemmisíteni; FALSE Egyébként.

bAdjustLayout
[in] TRUE a dokkolás elrendezésének módosítása; FALSE Egyébként.

bAutoHide
[in] TRUE ha a vezérlősáv automatikus elrejtés módban van; FALSE Egyébként.

pBarReplacement
[in] Az eltávolított ablaktáblát lecserélő ablaktábla mutatója.

Megjegyzések

Ezzel a módszerrel eltávolíthat egy vezérlősávot a keretablak dokkolásos elrendezéséből.

Az CDockingManager osztály kezeli a vezérlősávok elrendezését. Az egyes vezérlősávokat regisztrálnia kell a dokkolókezelőben a metódus vagy a CFrameWndEx::AddPaneCFrameWndEx::InsertPane metódus használatával.

`CFrameWndEx::SetDockState`

Visszaállítja a rögzítési elrendezést a beállításjegyzékben tárolt rögzítési állapotra.

void SetDockState(const CDockState& state);

Paraméterek

state
A dokkolás állapota. Ezt a paramétert a rendszer figyelmen kívül hagyja.

`CFrameWndEx::SetPrintPreviewFrame`

Beállítja a nyomtatási képkeret ablakát.

void SetPrintPreviewFrame(CFrameWnd* pWnd);

Paraméterek

pWnd
[in] Mutató egy nyomtatási képkeret ablakára.

Megjegyzések

`CFrameWndEx::SetupToolbarMenu`

Felhasználó által definiált parancsokat szúr be egy eszköztár menüjébe.

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

Paraméterek

menu
[in] Módosítandó CMenu objektum.

uiViewUserToolbarCmdFirst
[in] Az első felhasználó által definiált parancs.

uiViewUserToolbarCmdLast
[in] Az utolsó felhasználó által definiált parancs.

Megjegyzések

A keretrendszer egy listában tárolja a felhasználó által definiált parancsokat. Használja uiViewUserToolbarCmdFirst és uiViewUserToolbarCmdList adja meg a beszúrni kívánt parancsok indexeit.

`CFrameWndEx::ShowFullScreen`

A főkeret váltása a teljes képernyős és a normál mód között.

void ShowFullScreen();

`CFrameWndEx::ShowPane`

Megjeleníti vagy elrejti a megadott panelt.

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

Paraméterek

pBar
[in] Mutató a vezérlősávra a megjelenítéshez vagy elrejtéséhez.

bShow
[in] Ha TRUE, az alkalmazás megjeleníti a vezérlősávot. Ellenkező esetben az alkalmazás elrejti a vezérlősávot.

bDelay
[in] Ha TRUE, késleltetje a dokkolás elrendezésének módosítását, amíg a keretrendszer nem hív.CFrameWndEx::AdjustDockingLayout Ellenkező esetben azonnal számítsa újra a dokkolás elrendezését.

bActivate
[in] Ha TRUE, állítsa aktívvá a vezérlősávot. Ellenkező esetben a vezérlősáv inaktív állapotban jelenik meg.

`CFrameWndEx::UpdateCaption`

A keretrendszer meghívta az ablakkeret feliratának frissítéséhez.

void UpdateCaption();

Megjegyzések

`CFrameWndEx::WinHelp`

Meghívja a WinHelp-alkalmazást vagy a környezettel kapcsolatos súgót.

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

Paraméterek

dwData
A paramétertől függő nCmd adatok. A lehetséges értékek listáját lásd WinHelp: .

nCmd
A súgó parancs. A lehetséges értékek listáját lásd WinHelp: .

Megjegyzések

Lásd még

hierarchiadiagram
osztályok
CFrameWnd

Visszajelzés

Hasznosnak találta ezt az oldalt?

Last updated on 2026-02-23

CFrameWndEx osztály

Szemantika

Tagok

Nyilvános metódusok

Example

Öröklési hierarchia

Requirements

CFrameWndEx::ActiveItemRecalcLayout

Megjegyzések

CFrameWndEx::AddPane

Paraméterek

Visszaadott érték

CFrameWndEx::AdjustDockingLayout

Paraméterek

Megjegyzések

CFrameWndEx::DelayUpdateFrameMenu

Paraméterek

Megjegyzések

CFrameWndEx::DockPane

Paraméterek

Megjegyzések

CFrameWndEx::DockPaneLeftOf

Paraméterek

Visszaadott érték

Megjegyzések

CFrameWndEx::EnableAutoHidePanes

Paraméterek

Visszaadott érték

Megjegyzések

CFrameWndEx::EnableDocking

Paraméterek

Visszaadott érték

Megjegyzések

CFrameWndEx::EnableFullScreenMainMenu

Paraméterek

CFrameWndEx::EnableFullScreenMode

Paraméterek

Megjegyzések

CFrameWndEx::EnableLoadDockState

Paraméterek

CFrameWndEx::EnablePaneMenu

Paraméterek

CFrameWndEx::GetActivePopup

Visszaadott érték

CFrameWndEx::GetDefaultResId

Visszaadott érték

CFrameWndEx::GetDockingManager

Visszaadott érték

Megjegyzések

CFrameWndEx::GetMenuBar

Visszaadott érték

CFrameWndEx::GetPane

Paraméterek

Visszaadott érték

CFrameWndEx::GetRibbonBar

Visszaadott érték

Megjegyzések

CFrameWndEx::GetTearOffBars

Visszaadott érték

CFrameWndEx::GetToolbarButtonToolTipText

Paraméterek

Visszaadott érték

Megjegyzések

CFrameWndEx::InsertPane

Paraméterek

Visszaadott érték

Megjegyzések

CFrameWndEx::IsFullScreen

Visszaadott érték

Megjegyzések

CFrameWndEx::IsMenuBarAvailable

Visszaadott érték

CFrameWndEx::IsPointNearDockSite

Paraméterek

Visszaadott érték

Megjegyzések

CFrameWndEx::IsPrintPreview

Visszaadott érték

Megjegyzések

CFrameWndEx::LoadFrame

`CFrameWndEx` osztály

`CFrameWndEx::ActiveItemRecalcLayout`

`CFrameWndEx::AddPane`

`CFrameWndEx::AdjustDockingLayout`

`CFrameWndEx::DelayUpdateFrameMenu`

`CFrameWndEx::DockPane`

`CFrameWndEx::DockPaneLeftOf`

`CFrameWndEx::EnableAutoHidePanes`

`CFrameWndEx::EnableDocking`

`CFrameWndEx::EnableFullScreenMainMenu`

`CFrameWndEx::EnableFullScreenMode`

`CFrameWndEx::EnableLoadDockState`

`CFrameWndEx::EnablePaneMenu`

`CFrameWndEx::GetActivePopup`

`CFrameWndEx::GetDefaultResId`

`CFrameWndEx::GetDockingManager`

`CFrameWndEx::GetMenuBar`

`CFrameWndEx::GetPane`

`CFrameWndEx::GetRibbonBar`

`CFrameWndEx::GetTearOffBars`

`CFrameWndEx::GetToolbarButtonToolTipText`

`CFrameWndEx::InsertPane`

`CFrameWndEx::IsFullScreen`

`CFrameWndEx::IsMenuBarAvailable`

`CFrameWndEx::IsPointNearDockSite`

`CFrameWndEx::IsPrintPreview`

`CFrameWndEx::LoadFrame`

`CFrameWndEx::NegotiateBorderSpace`

`CFrameWndEx::OnActivate`

`CFrameWndEx::OnActivateApp`

`CFrameWndEx::OnChangeVisualManager`

`CFrameWndEx::OnClose`

`CFrameWndEx::OnCloseDockingPane`

`CFrameWndEx::OnCloseMiniFrame`

`CFrameWndEx::OnClosePopupMenu`

`CFrameWndEx::OnCmdMsg`

`CFrameWndEx::OnContextHelp`

`CFrameWndEx::OnCreate`

`CFrameWndEx::OnDestroy`

`CFrameWndEx::OnDrawMenuImage`

`CFrameWndEx::OnDrawMenuLogo`

`CFrameWndEx::OnDWMCompositionChanged`

`CFrameWndEx::OnExitSizeMove`

`CFrameWndEx::OnGetMinMaxInfo`

`CFrameWndEx::OnIdleUpdateCmdUI`

`CFrameWndEx::OnLButtonDown`

`CFrameWndEx::OnLButtonUp`

`CFrameWndEx::OnMenuButtonToolHitTest`