CFrameWndEx-Klasse

Artikel
06/10/2015

Implementiert die Funktion eines Windows-SingleDocument Interface (SDI) nicht überschnitt oder von Popups Rahmenfenster und Bereitstellen Member zum Verwalten des Fensters. Es CFrameWnd erweitert die Klasse.

class CFrameWndEx : public CFrameWnd

Mitglieder

Öffentliche Methoden

Name	Description
CFrameWndEx::ActiveItemRecalcLayout	Passt das Layout des OLE-Clientelements und des Clientbereichs des Frames.
CFrameWndEx::AddDockSite	Diese Methode wird nicht verwendet.
CFrameWndEx::AddPane	Registriert eine Steuerleiste mit dem Andocken Manager.
CFrameWndEx::AdjustDockingLayout	Berechnet das Layout aller Bereiche neu die im Rahmenfenster angedockt werden.
CFrameWndEx::DelayUpdateFrameMenu	Legt das Framemenü und dann -Updates es fest, wenn das Befehlsverarbeiten im Leerlauf befindet.
CFrameWndEx::DockPane	Dockt den angegebenen Bereich an das Rahmenfenster an.
CFrameWndEx::DockPaneLeftOf	wird ein Bereich auf der linken Seite eines anderen Bereichs.
CFrameWndEx::EnableAutoHidePanes	Aktiviert den Modus "Automatisches Ausblenden" für die Bereiche, wenn sie angegebenen Seiten des Hauptrahmenfensters angedockt werden.
CFrameWndEx::EnableDocking	Ermöglicht das Andocken der Bereiche, die dem Rahmenfenster gehören.
CFrameWndEx::EnableFullScreenMainMenu	In oder aus dem Hauptmenü in einem Ganzseitenmodus.
CFrameWndEx::EnableFullScreenMode	Aktiviert den Ganzseitenmodus für das Rahmenfenster.
CFrameWndEx::EnableLoadDockState	Aktiviert oder deaktiviert das Laden des angedockten Zustand.
CFrameWndEx::EnablePaneMenu	Aktiviert oder deaktiviert die automatische Behandlung des Bereichsmenü.
CFrameWndEx::GetActivePopup	Gibt einen Zeiger auf aktuell angezeigten Popupmenü zurück.
CFrameWndEx::GetDefaultResId	Gibt das diese Ressourcen-ID Sie zurück, als das Framework Rahmenfenster geladen wurde.
CFrameWndEx::GetDockingManager	Ruft das Objekt CDockingManager-Klasse für das Rahmenfenster ab.
CFrameWndEx::GetMenuBar	Gibt einen Zeiger auf Menüleistenobjekt zurück, das an das Rahmenfenster angefügt wird.
CFrameWndEx::GetPane	Gibt einen Zeiger auf Bereich zurück, der die angegebene ID besitzt
CFrameWndEx::GetRibbonBar	Ruft das Menübandleistesteuerelement für die Frames ab.
CFrameWndEx::GetTearOffBars	Gibt eine Liste von Bereichsobjekten zurück, die in einem Tearoffen Zustand sind.
CFrameWndEx::GetToolbarButtonToolTipText	Aufgerufen vom Framework, wenn die Anwendung die QuickInfo für eine Symbolleisten-Schaltfläche anzeigt.
CFrameWndEx::InsertPane	Registriert einen Bereich mit dem Andocken Manager.
CFrameWndEx::IsFullScreen	Bestimmt, ob das Rahmenfenster im Ganzseitenmodus ist.
CFrameWndEx::IsMenuBarAvailable	Bestimmt, ob der Zeiger auf Menüleistenobjekt gültig ist.
CFrameWndEx::IsPointNearDockSite	Gibt an, ob der Punkt in einer Ausrichtungszone ist.
CFrameWndEx::IsPrintPreview	Gibt an, ob das Rahmenfenster in der Seitenansicht ist.
CFrameWndEx::LoadFrame	Diese Methode wird nach Konstruktion aufgerufen, um das Rahmenfenster zu erstellen und seine Ressourcen zu laden.
CFrameWndEx::NegotiateBorderSpace	Client-Rahmenaushandlung implementiert der OLE.
CFrameWndEx::OnActivate	Das Framework ruft diese Methode auf, wenn Benutzereingaben oder vom auf Frames gewechselt wird.
CFrameWndEx::OnActivateApp	Aufgerufen vom Framework, wenn die Anwendung entweder aktiviert oder deaktiviert wird.
CFrameWndEx::OnChangeVisualManager	Aufgerufen vom Framework, wenn eine Änderung an den Frames eine Änderung am visuellen Manager erfordert.
CFrameWndEx::OnClose	Das Framework ruft diese Methode auf, um die Frames zu schließen.
CFrameWndEx::OnCloseDockingPane	Aufgerufen vom Framework, wenn der Benutzer auf die Schaltfläche Schließen auf einem Hauptandockbereich klickt.
CFrameWndEx::OnCloseMiniFrame	Aufgerufen vom Framework, wenn der Benutzer auf die Schaltfläche Schließen auf einem beweglichen Minirahmenfenster klickt.
CFrameWndEx::OnClosePopupMenu	Aufgerufen vom Framework ausgelöst, wenn ein aktives Popupmenü eine WM_DESTROY-Meldung verarbeitet.
CFrameWndEx::OnCmdMsg	Dispatchbefehlsmeldungen.
CFrameWndEx::OnContextHelp	Aufgerufen vom Framework dem Anzeigekontext verknüpfte Hilfe.
CFrameWndEx::OnCreate	Aufgerufen durch das Framework nach dem Frame wird erstellt.
CFrameWndEx::OnDestroy	Aufgerufen vom Framework, wenn der Frame zerstört werden.
CFrameWndEx::OnDrawMenuImage	Aufgerufen vom Framework, wenn die Anwendung das Bild zeichnet, das einem Menüelement zugeordnet ist.
CFrameWndEx::OnDrawMenuLogo	Aufgerufen vom Framework ausgelöst, wenn ein CMFCPopupMenu-Objekt eine WM_PAINT Meldung verarbeitet.
CFrameWndEx::OnDWMCompositionChanged	Aufgerufen vom Framework, wenn Komposition des Desktopfenster-Managers (DWM) aktiviert oder deaktiviert wurde.
CFrameWndEx::OnExitSizeMove	Aufgerufen vom Framework, wenn der Frame verschoben beenden oder Größe zu ändern.
CFrameWndEx::OnGetMinMaxInfo	Aufgerufen vom Framework, wenn der Frame angepasst werden, um Fensterdimensionsgrenzen bewerten.
CFrameWndEx::OnIdleUpdateCmdUI	Aufgerufen vom Framework, um die Frameanzeige, wenn das Befehlsverarbeiten aktualisieren im Leerlauf befindet.
CFrameWndEx::OnLButtonDown	Das Framework ruft diese Methode auf, wenn der Benutzer die linke Maustaste drückt.
CFrameWndEx::OnLButtonUp	Das Framework ruft diese Methode auf, wenn der Benutzer die linke Maustaste los.
CFrameWndEx::OnMenuButtonToolHitTest	Aufgerufen vom Framework ausgelöst, wenn ein CMFCToolBarButton-Objekt eine WM_NCHITTEST Meldung verarbeitet.
CFrameWndEx::OnMenuChar	Aufgerufen vom Framework ausgelöst, wenn ein Menü angezeigt wird und der Benutzer Drücken einer Taste, die nicht zu einem Befehl entspricht.
CFrameWndEx::OnMouseMove	Das Framework ruft diese Methode auf, wenn der Mauszeiger bewegt.
CFrameWndEx::OnMoveMiniFrame	Aufgerufen vom Framework ausgelöst, wenn ein Bereichsfenster bewegt.
CFrameWndEx::OnNcActivate	Aufgerufen vom Framework, wenn der Nicht-Clientbereich der Rahmen neu gezeichnet werden muss, um eine Änderung im aktiven Zustand anzugeben.
CFrameWndEx::OnNcCalcSize	Aufgerufen vom Framework, wenn die Größe und die Position des Clientbereichs abgeleitet werden müssen.
CFrameWndEx::OnNcHitTest	Aufgerufen vom Framework, wenn der Mauszeiger bewegt wird, oder wenn eine Maustaste gedrückt wird oder nicht.
CFrameWndEx::OnNcMouseMove	Aufgerufen vom Framework, wenn der Zeiger in einen Nicht-Clientbereich bewegt.
CFrameWndEx::OnNcPaint	Aufgerufen vom Framework, wenn der Nicht-Clientbereich gezeichnet werden muss.
CFrameWndEx::OnPaneCheck	Aufgerufen vom Framework, um die Sichtbarkeit eines Bereichs zu steuern.
CFrameWndEx::OnPostPreviewFrame	Aufgerufen vom Framework, wenn der Benutzer den Seitenansichtsmodus geändert hat.
CFrameWndEx::OnPowerBroadcast	Aufgerufen vom Framework ausgelöst, wenn ein Energieverwaltungsereignis auftritt.
CFrameWndEx::OnSetMenu	Aufgerufen vom Framework, um das Rahmenfenstermenü zu ersetzen.
CFrameWndEx::OnSetPreviewMode	Aufgerufen vom Framework, um den Seitenansichtsmodus für den Frame festzulegen.
CFrameWndEx::OnSetText	Aufgerufen vom Framework, um den Text eines Fensters festzulegen.
CFrameWndEx::OnShowCustomizePane	Aufgerufen vom Framework ausgelöst, wenn ein schnelles anpassen, wird Bereich aktiviert.
CFrameWndEx::OnShowPanes	Aufgerufen durch das Framework, um Bereiche anzuzeigen oder auszublenden.
CFrameWndEx::OnShowPopupMenu	Aufgerufen vom Framework ausgelöst, wenn ein Popupmenü aktiviert ist.
CFrameWndEx::OnSize	Das Framework ruft diese Methode auf, nachdem die Größe der Rahmen ändert.
CFrameWndEx::OnSizing	Das Framework ruft diese Methode auf, wenn der Benutzer die Frames Größe ändert.
CFrameWndEx::OnSysColorChange	Aufgerufen vom Framework, wenn die Systemfarben ändern.
CFrameWndEx::OnTearOffMenu	Aufgerufen vom Framework ausgelöst, wenn ein Menü, das eine Tearoffe Leiste hat, aktiviert ist.
CFrameWndEx::OnToolbarContextMenu	Aufgerufen vom Framework, um ein Symbolleistenkontextmenü zu erstellen.
CFrameWndEx::OnToolbarCreateNew	Das Framework ruft diese Methode auf, um eine neue Symbolleiste zu erstellen.
CFrameWndEx::OnToolbarDelete	Aufgerufen vom Framework, wenn eine Symbolleiste gelöscht wird.
CFrameWndEx::OnUpdateFrameMenu	Aufgerufen vom Framework, um das Framemenü festzulegen.
CFrameWndEx::OnUpdateFrameTitle	Das Framework ruft diese Methode auf, um die Titelleiste des Rahmenfensters zu aktualisieren.
CFrameWndEx::OnUpdatePaneMenu	Aufgerufen vom Framework, um das Bereichsmenü zu aktualisieren.
CFrameWndEx::OnWindowPosChanged	Aufgerufen vom Framework, wenn die Framegröße, die Position oder die Z-Reihenfolge aufgrund eines Anrufs einer Fensterverwaltungsmethode geändert hat.
CFrameWndEx::PaneFromPoint	Gibt den Hauptandockbereich zurück, der den angegebenen Punkt enthält.
CFrameWndEx::PreTranslateMessage	Bestimmte Fenstermeldungen der Handles, bevor sie weitergeleitet werden.
CFrameWndEx::RecalcLayout	Passt das Layout der Rahmen und der untergeordneten Fenster.
CFrameWndEx::RemovePaneFromDockManager	Hebt einen Bereich Registrierung auf und entfernt sie aus der internen Liste im Andocken Manager.
CFrameWndEx::SetDockState	Stellt das andockbare Layout im angedockten Zustand zurück, der in der Registrierung gespeichert wird.
CFrameWndEx::SetPrintPreviewFrame	Legt das Seitenansichtsrahmenfenster fest.
CFrameWndEx::SetupToolbarMenu	Fügt benutzerdefinierte Befehle in ein Symbolleistenmenü ein.
CFrameWndEx::ShowFullScreen	Schaltet den Hauptframes zwischen dem Bildschirm und reguläre Modi um.
CFrameWndEx::ShowPane	In oder aus der angegebene Bereich.
CFrameWndEx::UpdateCaption	Aufgerufen vom Framework, um die Fensterrahmenbeschriftung zu aktualisieren.
CFrameWndEx::WinHelp	Ruft entweder die WinHelp Anwendung oder Kontext verknüpfte Hilfe zu.

Beispiel

Das folgende Beispiel zeigt, wie eine Klasse von der CFrameWndEx-Klasse erbt. Das Beispiel veranschaulicht die Methodensignaturen in der Unterklasse und wie die OnShowPopupMenu-Methode überschreibt. Dieser Codeausschnitt ist Teil Word-Auflagenbeispiel.

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


...


BOOL CMainFrame::OnShowPopupMenu (CMFCPopupMenu* pMenuPopup)
{
    BOOL bRes = CFrameWndEx::OnShowPopupMenu (pMenuPopup);

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

    return bRes;
}