Freigeben über

CFrameWndEx-Klasse

  • Artikel

Implementiert die Funktionalität eines Windows-SDI-Rahmenfensters (Single Document Interface), wobei es sich um ein überlappendes oder ein Popupfenster handeln kann. Ebenfalls bereitgestellt werden Member zum Verwalten des Fensters. Er erweitert die CFrameWnd Klasse.

Syntax

class CFrameWndEx : public CFrameWnd

Member

Öffentliche Methoden

Name Beschreibung
CFrameWndEx::ActiveItemRecalcLayout Passt das Layout des OLE-Clientelements und des Clientbereichs des Frames an.
CFrameWndEx::AddDockSite Diese Methode wird nicht verwendet.
CFrameWndEx::AddPane Registriert eine Steuerleiste beim Andock-Manager.
CFrameWndEx::AdjustDockingLayout Berechnet das Layout aller Bereiche neu, die an das Rahmenfenster angedockt sind.
CFrameWndEx::DelayUpdateFrameMenu Legt das Framemenü fest und aktualisiert es dann, wenn die Befehlsverarbeitung im Leerlauf erfolgt.
CFrameWndEx::DockPane Dockt den angegebenen Bereich an das Rahmenfenster an.
CFrameWndEx::DockPaneLeftOf Dockt einen Bereich auf der linken Seite eines anderen Bereichs an.
CFrameWndEx::EnableAutoHidePanes Aktiviert den Modus für das automatische Ausblenden für die Bereiche, wenn sie an die angegebenen Seiten des Hauptrahmenfensters angedockt sind.
CFrameWndEx::EnableDocking Aktiviert das Andocken der Bereiche, die zum Rahmenfenster gehören.
CFrameWndEx::EnableFullScreenMainMenu Blendet das Hauptmenü im Vollbildmodus ein oder aus.
CFrameWndEx::EnableFullScreenMode Aktiviert den Vollbildmodus für das Framefenster.
CFrameWndEx::EnableLoadDockState Aktiviert oder deaktiviert das Laden des Andockzustands.
CFrameWndEx::EnablePaneMenu Aktiviert oder deaktiviert die automatische Behandlung des Bereichsmenüs.
CFrameWndEx::GetActivePopup Gibt einen Zeiger auf das aktuell angezeigte Popupmenü zurück.
CFrameWndEx::GetDefaultResId Gibt die Ressourcen-ID zurück, die Sie angegeben haben, wenn das Framework das Framefenster geladen hat.
CFrameWndEx::GetDockingManager Ruft das CDockingManager Class - Objekt für das Framefenster ab.
CFrameWndEx::GetMenuBar Gibt einen Zeiger auf das Menüleistenobjekt zurück, das an das Rahmenfenster angefügt ist.
CFrameWndEx::GetPane Gibt einen Zeiger auf den Bereich zurück, der die angegebene ID aufweist.
CFrameWndEx::GetRibbonBar Ruft das Menübandleisten-Steuerelement für den Frame ab.
CFrameWndEx::GetTearOffBars Gibt eine Liste von Bereichsobjekten zurück, die sich in einem abtrennbaren Zustand befinden.
CFrameWndEx::GetToolbarButtonToolTipText Wird vom Framework aufgerufen, wenn die Anwendung die QuickInfo für eine Symbolleistenschaltfläche anzeigt.
CFrameWndEx::InsertPane Registriert einen Bereich mit dem Andock-Manager.
CFrameWndEx::IsFullScreen Bestimmt, ob sich das Framefenster im Vollbildmodus befindet.
CFrameWndEx::IsMenuBarAvailable Bestimmt, ob der Zeiger auf das Menüleistenobjekt gültig ist.
CFrameWndEx::IsPointNearDockSite Gibt an, ob sich der Punkt in einer Ausrichtungszone befindet.
CFrameWndEx::IsPrintPreview Gibt an, ob sich das Rahmenfenster im Druckvorschaumodus befindet.
CFrameWndEx::LoadFrame Diese Methode wird nach der Konstruktion aufgerufen, um das Framefenster zu erstellen und die zugehörigen Ressourcen zu laden.
CFrameWndEx::NegotiateBorderSpace Implementiert die OLE-Client-Border-Aushandlung.
CFrameWndEx::OnActivate Das Framework ruft diese Methode auf, wenn benutzereingaben in den Frame gewechselt oder weg vom Frame entfernt werden.
CFrameWndEx::OnActivateApp Wird vom Framework aufgerufen, wenn die Anwendung ausgewählt oder deaktiviert wird.
CFrameWndEx::OnChangeVisualManager Wird vom Framework aufgerufen, wenn eine Änderung an dem Frame eine Änderung an dem visuellen Manager erfordert.
CFrameWndEx::OnClose Das Framework ruft diese Methode auf, um den Frame zu schließen.
CFrameWndEx::OnCloseDockingPane Wird vom Framework aufgerufen, wenn der Benutzer auf die Schaltfläche "Schließen " in einem Andockbereich klickt.
CFrameWndEx::OnCloseMiniFrame Wird vom Framework aufgerufen, wenn der Benutzer auf die Schaltfläche "Schließen " in einem unverankerten Miniframefenster klickt.
CFrameWndEx::OnClosePopupMenu Wird vom Framework aufgerufen, wenn ein aktives Popupmenü eine WM_DESTROY Nachricht verarbeitet.
CFrameWndEx::OnCmdMsg Verteilt Befehlsmeldungen.
CFrameWndEx::OnContextHelp Vom Framework aufgerufen, um kontextbezogene Hilfe anzuzeigen.
CFrameWndEx::OnCreate Wird vom Framework aufgerufen, nachdem der Frame erstellt wurde.
CFrameWndEx::OnDestroy Wird vom Framework aufgerufen, wenn der Frame zerstört wird.
CFrameWndEx::OnDrawMenuImage Wird vom Framework aufgerufen, wenn die Anwendung das bild zeichnet, das einem Menüelement zugeordnet ist.
CFrameWndEx::OnDrawMenuLogo Wird vom Framework aufgerufen, wenn ein CMFCPopupMenu Objekt eine WM_PAINT Nachricht verarbeitet.
CFrameWndEx::OnDWMCompositionChanged Wird vom Framework aufgerufen, wenn die Komposition des Desktopfenster-Managers (DWM) aktiviert oder deaktiviert wurde.
CFrameWndEx::OnExitSizeMove Wird vom Framework aufgerufen, wenn das Verschieben oder Ändern der Größe des Frames beendet wird.
CFrameWndEx::OnGetMinMaxInfo Wird vom Framework aufgerufen, wenn die Größe des Frames geändert wird, um Größenbeschränkungen für Fensterdimensionen festzulegen.
CFrameWndEx::OnIdleUpdateCmdUI Wird vom Framework aufgerufen, um die Frameanzeige zu aktualisieren, wenn die Befehlsverarbeitung im Leerlauf erfolgt.
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 loslässt.
CFrameWndEx::OnMenuButtonToolHitTest Wird vom Framework aufgerufen, wenn ein CMFCToolBarButton Objekt eine WM_NCHITTEST Nachricht verarbeitet.
CFrameWndEx::OnMenuChar Wird vom Framework aufgerufen, wenn ein Menü angezeigt wird und der Benutzer eine Taste drückt, die keinem Befehl entspricht.
CFrameWndEx::OnMouseMove Das Framework ruft diese Methode auf, wenn der Zeiger verschoben wird.
CFrameWndEx::OnMoveMiniFrame Wird vom Framework aufgerufen, wenn ein Fensterfenster verschoben wird.
CFrameWndEx::OnNcActivate Wird vom Framework aufgerufen, wenn der Nicht-Clientbereich des Frames neu gezeichnet werden muss, um eine Änderung im aktiven Zustand anzuzeigen.
CFrameWndEx::OnNcCalcSize Wird vom Framework aufgerufen, wenn die Größe und Position des Clientbereichs berechnet werden müssen.
CFrameWndEx::OnNcHitTest Wird vom Framework aufgerufen, wenn der Zeiger bewegt oder eine Maustaste gedrückt oder losgelassen wird.
CFrameWndEx::OnNcMouseMove Wird vom Framework aufgerufen, wenn der Zeiger in einem Nicht-Client-Bereich verschoben wird.
CFrameWndEx::OnNcPaint Wird vom Framework aufgerufen, wenn der Nicht-Client-Bereich gezeichnet werden muss.
CFrameWndEx::OnPaneCheck Vom Framework aufgerufen, um die Sichtbarkeit eines Bereichs zu steuern.
CFrameWndEx::OnPostPreviewFrame Wird vom Framework aufgerufen, wenn der Benutzer den Druckvorschaumodus geändert hat.
CFrameWndEx::OnPowerBroadcast Wird vom Framework aufgerufen, wenn ein Energieverwaltungsereignis auftritt.
CFrameWndEx::OnSetMenu Vom Framework aufgerufen, um das Framefenstermenü zu ersetzen.
CFrameWndEx::OnSetPreviewMode Vom Framework aufgerufen, um den Druckvorschaumodus für den Frame festzulegen.
CFrameWndEx::OnSetText Vom Framework aufgerufen, um den Text eines Fensters festzulegen.
CFrameWndEx::OnShowCustomizePane Wird vom Framework aufgerufen, wenn ein Quick Customize-Bereich aktiviert ist.
CFrameWndEx::OnShowPanes Vom Framework aufgerufen, um Bereiche ein- oder auszublenden.
CFrameWndEx::OnShowPopupMenu Wird vom Framework aufgerufen, wenn ein Popupmenü aktiviert ist.
CFrameWndEx::OnSize Das Framework ruft diese Methode auf, nachdem sich die Größe des Frames geändert hat.
CFrameWndEx::OnSizing Das Framework ruft diese Methode auf, wenn der Benutzer die Größe des Frames ändert.
CFrameWndEx::OnSysColorChange Wird vom Framework aufgerufen, wenn sich die Systemfarben ändern.
CFrameWndEx::OnTearOffMenu Wird vom Framework aufgerufen, wenn ein Menü mit einer Abrissleiste aktiviert ist.
CFrameWndEx::OnToolbarContextMenu Vom Framework aufgerufen, um ein Symbolleistenkontextmenü zu erstellen.
CFrameWndEx::OnToolbarCreateNew Das Framework ruft diese Methode auf, um eine neue Symbolleiste zu erstellen.
CFrameWndEx::OnToolbarDelete Wird vom Framework aufgerufen, wenn eine Symbolleiste gelöscht wird.
CFrameWndEx::OnUpdateFrameMenu Vom Framework aufgerufen, um das Framemenü festzulegen.
CFrameWndEx::OnUpdateFrameTitle Das Framework ruft diese Methode auf, um die Titelleiste des Framefensters zu aktualisieren.
CFrameWndEx::OnUpdatePaneMenu Vom Framework aufgerufen, um das Bereichsmenü zu aktualisieren.
CFrameWndEx::OnWindowPosChanged Wird vom Framework aufgerufen, wenn sich die Framegröße, Position oder Z-Reihenfolge aufgrund eines Aufrufs einer Fensterverwaltungsmethode geändert hat.
CFrameWndEx::PaneFromPoint Gibt den Andockbereich zurück, der den angegebenen Punkt enthält.
CFrameWndEx::PreTranslateMessage Behandelt bestimmte Fenstermeldungen, bevor sie verteilt werden.
CFrameWndEx::RecalcLayout Passt das Layout des Rahmens und seiner untergeordneten Fenster an.
CFrameWndEx::RemovePaneFromDockManager Hebt die Registrierung eines Bereichs auf und entfernt ihn aus der internen Liste im Docking-Manager.
CFrameWndEx::SetDockState Stellt das Dockinglayout auf den in der Registrierung gespeicherten Andockzustand wieder her.
CFrameWndEx::SetPrintPreviewFrame Legt das Fenster für den Seitenvorschaurahmen fest.
CFrameWndEx::SetupToolbarMenu Fügt benutzerdefinierte Befehle in ein Symbolleistenmenü ein.
CFrameWndEx::ShowFullScreen Schaltet den Hauptrahmen zwischen dem Vollbildmodus und den normalen Modi um.
CFrameWndEx::ShowPane Blendet den angegebenen Bereich ein oder aus.
CFrameWndEx::UpdateCaption Vom Framework aufgerufen, um die Fensterrahmenbeschriftung zu aktualisieren.
CFrameWndEx::WinHelp Ruft entweder die WinHelp Anwendungs- oder kontextbezogene Hilfe auf.

Beispiel

Das folgende Beispiel veranschaulicht, wie eine Klasse von der CFrameWndEx Klasse geerbt wird. Das Beispiel veranschaulicht die Methodensignaturen in der Unterklasse und das Überschreiben der OnShowPopupMenu Methode. Dieser Codeausschnitt ist Teil des WordPad-Beispiels.

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

Vererbungshierarchie

CObject

CCmdTarget

CWnd

CFrameWnd

CFrameWndEx

Anforderungen

Header: afxframewndex.h

CFrameWndEx::ActiveItemRecalcLayout

Passt das Layout des OLE-Clientelements und des Clientbereichs des Frames an.

void ActiveItemRecalcLayout();

Hinweise

CFrameWndEx::AddPane

Registriert eine Steuerleiste beim Andock-Manager.

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

Parameter

pControlBar
[in] Ein Zu registrierende Steuerelementleistenbereich.

bTail
[in] TRUE wenn Sie den Steuerelementleistenbereich am Ende der Liste hinzufügen möchten; FALSE sonst.

Rückgabewert

TRUE wenn die Kontrollleiste erfolgreich registriert wurde; FALSE sonst.

CFrameWndEx::AdjustDockingLayout

Berechnet das Layout aller Bereiche neu, die an das Rahmenfenster angedockt sind.

virtual void AdjustDockingLayout(HDWP hdwp=NULL);

Parameter

hdwp
Ein Handle für eine Struktur, die die Positionen mehrerer Fenster enthält. .

Hinweise

Die HDWP-Struktur wird von der BeginDeferWindowPos Methode initialisiert.

CFrameWndEx::DelayUpdateFrameMenu

Legt das Framemenü fest und aktualisiert es dann, wenn die Befehlsverarbeitung im Leerlauf erfolgt.

virtual void DelayUpdateFrameMenu(HMENU hMenuAlt);

Parameter

hMenuAlt
[in] Behandeln sie ein alternatives Menü.

Hinweise

CFrameWndEx::DockPane

Dockt den angegebenen Bereich an das Rahmenfenster an.

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

Parameter

pBar
[in] Ein Zeiger auf die steuerleiste, die angedockt werden soll.

nDockBarID
[in] Die ID der Seite des Rahmenfensters, an die angedockt werden soll.

lpRect
[in] Ein Zeiger auf eine konstante Rect Struktur, die die Bildschirmposition und Größe des Fensters angibt.

Hinweise

Der nDockBarID Parameter kann einen der folgenden Werte aufweisen:

  • AFX_IDW_DOCKBAR_TOP

  • AFX_IDW_DOCKBAR_BOTTOM

  • AFX_IDW_DOCKBAR_LEFT

  • AFX_IDW_DOCKBAR_RIGHT

CFrameWndEx::DockPaneLeftOf

Dockt den angegebenen Bereich links neben einem anderen Bereich an.

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

Parameter

pBar
[in] Ein Zeiger auf das Bereichsobjekt, das angedockt werden soll.

pLeftOf
[in] Ein Zeiger auf den Bereich links, von dem der bereich angedockt werden soll, der durch pBar.

Rückgabewert

TRUE wenn pBar erfolgreich angedockt wird. Andernfalls FALSE.

Hinweise

Die Methode verwendet die durch den pBar Parameter angegebene Symbolleiste und dockt sie an der linken Seite der symbolleiste an, die durch pLeftOf den Parameter angegeben wird.

CFrameWndEx::EnableAutoHidePanes

Aktiviert den Modus für das automatische Ausblenden für den Bereich, wenn er an die angegebene Seite des Hauptrahmenfensters angedockt wird.

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

Parameter

dwDockStyle
[in] Gibt die Seite des Hauptrahmenfensters an, an die der Bereich angedockt werden soll.

Rückgabewert

TRUE wenn ein Balkenbereich erfolgreich an die Rahmenfensterseite angedockt wurde, die von dwDockStyle, FALSE andernfalls angegeben wird.

Hinweise

dwDockStyle kann einen der folgenden Werte aufweisen:

  • CBRS_ALIGN_TOP: Ermöglicht es der Steuerelementleiste, am oberen Rand des Clientbereichs eines Framefensters anzudocken.

  • CBRS_ALIGN_BOTTOM: Ermöglicht es der Steuerungsleiste, am unteren Rand des Clientbereichs eines Rahmenfensters anzudocken.

  • CBRS_ALIGN_LEFT: Ermöglicht es der Steuerleiste, an die linke Seite des Clientbereichs eines Rahmenfensters anzudocken.

  • CBRS_ALIGN_RIGHT: Ermöglicht es der Steuerungsleiste, auf der rechten Seite des Clientbereichs eines Rahmenfensters anzudocken.

CFrameWndEx::EnableDocking

Aktiviert das Andocken der Bereiche des Rahmenfensters.

BOOL EnableDocking(DWORD dwDockStyle);

Parameter

dwDockStyle
[in] Gibt die Seite des Hauptrahmenfensters an, in dem die Bereichsleiste verankert ist.

Rückgabewert

TRUE wenn ein Balkenbereich erfolgreich an der angegebenen Seite angedockt werden kann. Andernfalls FALSE.

Hinweise

Der dwDockStyle Parameter kann einen der folgenden Werte aufweisen:

  • CBRS_ALIGN_TOP

  • CBRS_ALIGN_BOTTOM

  • CBRS_ALIGN_LEFT

  • CBRS_ALIGN_RIGHT

CFrameWndEx::EnableFullScreenMainMenu

Blendet das Hauptmenü im Vollbildmodus ein oder aus.

void EnableFullScreenMainMenu(BOOL bEnableMenu);

Parameter

bEnableMenu
[in] TRUE um das Hauptmenü im Vollbildmodus anzuzeigen, FALSE andernfalls.

CFrameWndEx::EnableFullScreenMode

Aktiviert den Vollbildmodus für das Framefenster.

void EnableFullScreenMode(UINT uiFullScreenCmd);

Parameter

uiFullScreenCmd
[in] Die ID eines Befehls, der den Vollbildmodus aktiviert und deaktiviert.

Hinweise

Im Vollbildmodus sind alle Andocksteuerungsleisten, Symbolleisten und Menüs ausgeblendet, und die aktive Ansicht wird so geändert, dass sie den Vollbildmodus einnimmt.

Wenn Sie den Vollbildmodus aktivieren, müssen Sie eine ID des Befehls angeben, der den Vollbildmodus aktiviert oder deaktiviert. Sie können die Funktion des Hauptframes OnCreate aufrufenEnableFullScreenMode. Wenn ein Rahmenfenster in einen Vollbildmodus gewechselt wird, erstellt das Framework eine unverankerte Symbolleiste mit einer Schaltfläche mit der angegebenen Befehls-ID.

Wenn Sie das Hauptmenü auf dem Bildschirm beibehalten möchten, rufen Sie CFrameWndEx::EnableFullScreenMainMenuauf.

CFrameWndEx::EnableLoadDockState

Aktiviert oder deaktiviert das Laden des Andockzustands.

void EnableLoadDockState(BOOL bEnable=TRUE);

Parameter

bEnable
[in] TRUE um das Laden des Dockingzustands zu aktivieren, FALSE um das Laden des Dockingzustands zu deaktivieren.

CFrameWndEx::EnablePaneMenu

Aktiviert oder deaktiviert die automatische Behandlung des Bereichsmenüs.

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

Parameter

bEnable
[in] TRUE um die automatische Behandlung der Popupmenüs der Steuerelementleiste zu ermöglichen; FALSE um die automatische Behandlung der Popupmenüs der Steuerelementleiste zu deaktivieren.

uiCustomizeCmd
[in] Die Befehls-ID des Menüelements anpassen .

strCustomizeLabel
[in] Die Beschriftung, die für das Menüelement "Anpassen" angezeigt werden soll

uiViewToolbarsMenuEntryID
[in] Die ID eines Symbolleistenmenüelements, das das Popupmenü in der Steuerelementleiste öffnet.

bContextMenuShowsToolbarsOnly
[in] Wenn TRUE, zeigt das Kontextmenü der Steuerelementleiste nur die Liste der Symbolleisten an. Wenn FALSE, zeigt das Menü die Liste der Symbolleisten und der Andockleisten an.

bViewMenuShowsToolbarsOnly
[in] Wenn TRUE, zeigt das Menü der Steuerelementleiste nur die Liste der Symbolleisten an. Wenn FALSE, zeigt das Menü die Liste der Symbolleisten und der Andockleisten an.

CFrameWndEx::GetActivePopup

Gibt einen Zeiger auf das aktuell angezeigte Popupmenü zurück.

CMFCPopupMenu* GetActivePopup() const;

Rückgabewert

Ein Zeiger auf das aktuell angezeigte Popupmenü; andernfalls NULL.

CFrameWndEx::GetDefaultResId

Gibt die Ressourcen-ID zurück, die Sie angegeben haben, wenn das Framework das Framefenster geladen hat.

UINT GetDefaultResId() const;

Rückgabewert

Der Ressourcen-ID-Wert, den der Benutzer beim Laden des Framefensters angegeben hat. Null, wenn im Rahmenfenster keine Menüleiste vorhanden ist.

CFrameWndEx::GetDockingManager

Ruft das CDockingManager Class - Objekt für das Framefenster ab.

CDockingManager* GetDockingManager();

Rückgabewert

Ein Zeiger auf die CDockingManager Klasse.

Hinweise

Das Framefenster erstellt und verwendet ein CDockingManager Class-Objekt zum Verwalten des andocken untergeordneten Fensters.

CFrameWndEx::GetMenuBar

Gibt einen Zeiger auf das Menüleistenobjekt zurück, das an das Rahmenfenster angefügt ist.

const CMFCMenuBar* GetMenuBar() const;

Rückgabewert

Ein Zeiger auf das Menüleistenobjekt, das an das Rahmenfenster angefügt ist.

CFrameWndEx::GetPane

Gibt einen Zeiger auf den Bereich zurück, der die angegebene ID aufweist.

CBasePane* GetPane(UINT nID);

Parameter

nID
[in] Die Steuerelement-ID.

Rückgabewert

Ein Zeiger auf den Bereich mit der angegebenen ID. NULL wenn kein solcher Bereich vorhanden ist.

CFrameWndEx::GetRibbonBar

Ruft das Menübandleisten-Steuerelement für den Frame ab.

CMFCRibbonBar* GetRibbonBar();

Rückgabewert

Zeigen Sie auf die CMFCRibbonBar Klasse für den Frame.

Hinweise

CFrameWndEx::GetTearOffBars

Gibt eine Liste von Bereichsobjekten zurück, die sich in einem abtrennbaren Zustand befinden.

const CObList& GetTearOffBars() const;

Rückgabewert

Ein Verweis auf CObList ein Objekt, das eine Auflistung von Zeigern auf die Bereichsobjekte enthält, die sich in einem Abbruchzustand befinden.

CFrameWndEx::GetToolbarButtonToolTipText

Wird vom Framework aufgerufen, wenn die Anwendung die QuickInfo für eine Symbolleistenschaltfläche anzeigt.

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

Parameter

pButton
[in] Ein Zeiger auf eine Symbolleistenschaltfläche.

strTTText
[in] Der QuickInfo-Text, der für die Schaltfläche angezeigt werden soll.

Rückgabewert

TRUE wenn die QuickInfo angezeigt wurde. Andernfalls FALSE.

Hinweise

Standardmäßig hat diese Methode keine Auswirkungen. Überschreiben Sie diese Methode, wenn Sie die QuickInfo für die Symbolleistenschaltfläche anzeigen möchten.

CFrameWndEx::InsertPane

Setzt einen Bereich in eine Liste von Steuerleisten ein und registriert ihn beim Dock-Manager.

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

Parameter

pControlBar
Ein Zeiger auf eine Steuerleiste, die in die Liste der Steuerleisten eingefügt und beim Dock-Manager registriert werden soll.

pTarget
Ein Zeiger auf eine Steuerleiste vor oder hinter der der Bereich eingefügt werden soll.

bAfter
TRUEwenn Sie nach pTarget, FALSE andernfalls einfügen pControlBar möchten.

Rückgabewert

TRUE wenn die Steuerleiste erfolgreich eingefügt und registriert wurde, FALSE andernfalls.

Hinweise

Sie müssen jede Steuerleiste registrieren, indem Sie die CDockingManager Klasse verwenden, um an dem Andocklayout teilzunehmen.

CFrameWndEx::IsFullScreen

Bestimmt, ob sich das Framefenster im Vollbildmodus befindet.

BOOL IsFullScreen() const;

Rückgabewert

TRUE wenn sich das Rahmenfenster im Vollbildmodus befindet; andernfalls FALSE.

Hinweise

Sie können den Vollbildmodus festlegen, indem Sie die CFrameWndEx::EnableFullScreenMode Methode aufrufen.

CFrameWndEx::IsMenuBarAvailable

Bestimmt, ob der Zeiger auf das Menüleistenobjekt gültig ist.

BOOL IsMenuBarAvailable() const;

Rückgabewert

TRUE wenn das Rahmenfenster eine Menüleiste aufweist; andernfalls FALSE.

CFrameWndEx::IsPointNearDockSite

Bestimmt, ob sich der Punkt in einer Ausrichtungszone befindet.

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

Parameter

point
[in] Die Position des Punkts.

dwBarAlignment
[out] An der Stelle, an der der Punkt ausgerichtet ist. Mögliche Werte finden Sie in der Tabelle im Abschnitt "Hinweise ".

bOuterEdge
[out] TRUE wenn sich der Punkt in der Nähe des Rahmenrahmens befindet; FALSE wenn sich der Punkt in einem Clientbereich befindet.

Rückgabewert

TRUEwenn sich der Punkt in einer Ausrichtungszone befindet; andernfalls . FALSE

Hinweise

In der folgenden Tabelle sind die möglichen Werte für den dwBarAlignment Parameter aufgeführt.

Wert Beschreibung
CBRS_ALIGN_TOP Oben ausgerichtet.
CBRS_ALIGN_RIGHT Rechtsbündig ausgerichtet.
CBRS_ALIGN_BOTTOM Am unteren Rand ausgerichtet.
CBRS_ALIGN_LEFT Linksbündig ausgerichtet.

CFrameWndEx::IsPrintPreview

Bestimmt, ob sich das Rahmenfenster im Druckvorschaumodus befindet.

BOOL IsPrintPreview();

Rückgabewert

TRUEwenn sich das Rahmenfenster im Druckvorschaumodus befindet; andernfalls . FALSE

Hinweise

CFrameWndEx::LoadFrame

Diese Methode wird nach der Konstruktion aufgerufen, um das Framefenster zu erstellen und die zugehörigen Ressourcen zu laden.

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

Parameter

nIDResource
[in] Die Ressourcen-ID, die zum Laden aller Frameressourcen verwendet wird.

dwDefaultStyle
[in] Die Standardformatvorlage für Rahmenfenster.

pParentWnd
[in] Zeigen Sie auf das übergeordnete Fenster des Frames.

pContext
[in] Zeigen Sie auf eine CCreateContext Structure-Klasse , die während der Anwendungserstellung vom Framework verwendet wird.

Rückgabewert

TRUE, wenn die Methode erfolgreich ausgeführt wurde, andernfalls FALSE.

Hinweise

CFrameWndEx::NegotiateBorderSpace

Implementiert die OLE-Client-Border-Aushandlung.

virtual BOOL NegotiateBorderSpace(
    UINT nBorderCmd,
    LPRECT lpRectBorder);

Parameter

nBorderCmd
[in] Der Befehl "Rahmenverhandlungen". Mögliche Werte finden Sie im Abschnitt "Hinweise ".

lpRectBorder
[in, out] Abmessungen des Rahmens.

Rückgabewert

TRUEwenn das Layout neu berechnet werden muss; andernfalls . FALSE

Hinweise

In der folgenden Tabelle sind die möglichen Werte für den nBorderCmd Parameter aufgeführt.

borderGet
Abrufen des verfügbaren OLE-Clientspeicherplatzes.

borderRequest
Anfordern des OLE-Clientspeicherplatzes.

borderSet
Legen Sie den OLE-Clientbereich fest.

CFrameWndEx::OnActivate

Das Framework ruft diese Methode auf, wenn benutzereingaben in den Frame gewechselt oder weg vom Frame entfernt werden.

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

Parameter

nState
[in] Gibt an, ob der Frame aktiv oder inaktiv ist. Mögliche Werte finden Sie in der Tabelle im Abschnitt "Hinweise ".

pWndOther
[in] Zeigen Sie auf ein anderes Fenster, in dem benutzereingaben mit dem aktuellen Fenster gewechselt werden.

bMinimized
[in] Der minimierte Zustand des Frames. TRUEwenn der Rahmen minimiert ist; andernfalls . FALSE

Hinweise

In der folgenden Tabelle sind die möglichen Werte für den nState Parameter aufgeführt.

Wert Beschreibung
WA_ACTIVE Der Frame wird von einer anderen Methode als einem Mausklick ausgewählt.
WA_CLICKACTIVE Der Frame wird mit einem Mausklick ausgewählt.
WA_INACTIVE Der Frame ist nicht ausgewählt.

CFrameWndEx::OnActivateApp

Wird vom Framework aufgerufen, wenn die Anwendung ausgewählt oder deaktiviert wird.

afx_msg void OnActivateApp(
    BOOL bActive,
    DWORD dwThreadID);

Parameter

bActive
[in] TRUE wenn die Anwendung ausgewählt ist; FALSE wenn die Anwendung nicht ausgewählt ist.

dwThreadID
[in] Dieser Parameter wird nicht verwendet.

Hinweise

CFrameWndEx::OnChangeVisualManager

Wird vom Framework aufgerufen, wenn eine Änderung an dem Frame eine Änderung an dem visuellen Manager erfordert.

afx_msg LRESULT OnChangeVisualManager(
    WPARAM wParam,
    LPARAM lParam);

Parameter

wParam
[in] Dieser Parameter wird nicht verwendet.

lParam
[in] Dieser Parameter wird nicht verwendet.

Rückgabewert

Es wird immer 0 zurückgegeben.

Hinweise

CFrameWndEx::OnClose

Das Framework ruft diese Methode auf, um den Frame zu schließen.

afx_msg void OnClose();

Hinweise

Wenn sich der Frame im Druckvorschaumodus befindet, sendet er eine Windows-Nachricht, um die Seitenansicht zu schließen. andernfalls wird der Client deaktiviert, wenn der Frame einen OLE-Client hosten soll.

CFrameWndEx::OnCloseDockingPane

Wird vom Framework aufgerufen, wenn der Benutzer auf die Schaltfläche "Schließen " in einem Andockbereich klickt.

virtual BOOL OnCloseDockingPane(CDockablePane* pPane);

Rückgabewert

TRUE wenn die Andockleiste geschlossen werden kann. Andernfalls FALSE

Hinweise

Die Standardimplementierer implementieren nichts. Überschreiben Sie diese Methode, wenn Sie das Ausblenden der Andockleiste behandeln möchten.

CFrameWndEx::OnCloseMiniFrame

Wird vom Framework aufgerufen, wenn der Benutzer auf die Schaltfläche "Schließen " in einem unverankerten Miniframefenster klickt.

virtual BOOL OnCloseMiniFrame(CPaneFrameWnd* pWnd);

Rückgabewert

TRUE wenn ein unverankerte Minirahmenfenster geschlossen werden kann. Andernfalls FALSE.

Hinweise

Bei der Standardimplementierung wird keine Aktion ausgeführt. Überschreiben Sie diese Methode, wenn Sie das Ausblenden eines unverankerten Miniframefensters verarbeiten möchten.

CFrameWndEx::OnClosePopupMenu

Wird vom Framework aufgerufen, wenn ein aktives Popupmenü eine WM_DESTROY Nachricht verarbeitet.

virtual void OnClosePopupMenu(CMFCPopupMenu* pMenuPopup);

Parameter

pMenuPopup
Ein Zeiger auf ein Popupmenü.

Hinweise

Das Framework sendet eine WM_DESTROY Nachricht, wenn es darum geht, das Fenster zu schließen. Überschreiben Sie diese Methode, wenn Sie Benachrichtigungen von CMFCPopupMenu Objekten behandeln möchten, die zum Framefenster gehören, wenn ein CMFCPopupMenu Objekt eine WM_DESTROY Nachricht verarbeitet, die vom Framework gesendet wird, wenn das Fenster geschlossen wird.

CFrameWndEx::OnCmdMsg

Verteilt Befehlsmeldungen.

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

Parameter

nID
[in] Die Befehls-ID.

nCode
[in] Befehlsnachrichtenkategorie.

pExtra
[in, out] Zeiger auf ein Befehlsobjekt.

pHandlerInfo
[in, out] Zeiger auf eine Befehlshandlerstruktur.

Rückgabewert

TRUEwenn die Befehlsnachricht behandelt wurde; andernfalls . FALSE

Hinweise

CFrameWndEx::OnContextHelp

Vom Framework aufgerufen, um kontextbezogene Hilfe anzuzeigen.

afx_msg void OnContextHelp();

Hinweise

CFrameWndEx::OnCreate

Wird vom Framework aufgerufen, nachdem der Frame erstellt wurde.

afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);

Parameter

lpCreateStruct
[in] Ein Zeiger auf die CREATESTRUCT Struktur für den neuen Frame.

Rückgabewert

0, um mit der Frameerstellung fortzufahren; -1, um den Rahmen zu zerstören.

Hinweise

CFrameWndEx::OnDestroy

Wird vom Framework aufgerufen, wenn der Frame zerstört wird.

afx_msg void OnDestroy();

Hinweise

Die Zugriffstastentabelle und alle Fenster werden zerstört.

CFrameWndEx::OnDrawMenuImage

Wird vom Framework aufgerufen, wenn die Anwendung das bild zeichnet, das einem Menüelement zugeordnet ist.

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

Parameter

pDC
[in] Ein Zeiger auf einen Gerätekontext.

pMenuButton
[in] Ein Zeiger auf eine Menüschaltfläche, deren Bild gerendert wird.

rectImage
[in] Ein Zeiger auf eine Rect Struktur, die die Bildschirmposition und die Größe des Bilds angibt.

Rückgabewert

TRUE wenn das Framework das Bild erfolgreich rendert; FALSE sonst.

Hinweise

Überschreiben Sie diese Methode, wenn Sie das Bildrendering für die Menüelemente anpassen möchten, die zur Menüleiste gehören, die dem CFrameWndEx abgeleiteten Objekt gehört.

Wird vom Framework aufgerufen, wenn ein CMFCPopupMenu Objekt eine WM_PAINT Nachricht verarbeitet.

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

Parameter

pDC
[in] Ein Zeiger auf einen Gerätekontext.

pMenu
[in] Ein Zeiger auf das Menüelement.

rectLogo
[in] Ein Verweis auf eine konstante CRect Struktur, die die Bildschirmposition und die Größe des Menülogos angibt.

Hinweise

Überschreiben Sie diese Funktion, wenn Sie ein Logo im Popupmenü anzeigen möchten, das zur Menüleiste gehört, die dem CFrameWndEx abgeleiteten Objekt gehört.

CFrameWndEx::OnDWMCompositionChanged

Wird vom Framework aufgerufen, wenn die Komposition des Desktopfenster-Managers (DWM) aktiviert oder deaktiviert wurde.

afx_msg LRESULT OnDWMCompositionChanged(
    WPARAM wp,
    LPARAM lp);

Parameter

wp
[in] Dieser Parameter wird nicht verwendet.

lp
[in] Dieser Parameter wird nicht verwendet.

Rückgabewert

Es wird immer 0 zurückgegeben.

Hinweise

CFrameWndEx::OnExitSizeMove

Wird vom Framework aufgerufen, wenn das Verschieben oder Ändern der Größe des Frames beendet wird.

LRESULT OnExitSizeMove(
    WPARAM wp,
    LPARAM lp);

Parameter

wp
[in] Dieser Parameter wird nicht verwendet.

lp
[in] Dieser Parameter wird nicht verwendet.

Rückgabewert

Es wird immer 0 zurückgegeben.

Hinweise

CFrameWndEx::OnGetMinMaxInfo

Wird vom Framework aufgerufen, wenn die Größe des Frames geändert wird, um Größenbeschränkungen für Fensterdimensionen festzulegen.

afx_msg void OnGetMinMaxInfo(MINMAXINFO FAR* lpMMI);

Parameter

lpMMI
[in] Zeiger auf eine MINMAXINFO Struktur.

Hinweise

CFrameWndEx::OnIdleUpdateCmdUI

Wird vom Framework aufgerufen, um die Frameanzeige zu aktualisieren, wenn die Befehlsverarbeitung im Leerlauf erfolgt.

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

Parameter

wParam
[in] Dieser Parameter wird nicht verwendet.

lParam
[in] Dieser Parameter wird nicht verwendet.

Rückgabewert

Es wird immer 0 zurückgegeben.

Hinweise

CFrameWndEx::OnLButtonDown

Das Framework ruft diese Methode auf, wenn der Benutzer die linke Maustaste drückt.

afx_msg void OnLButtonDown(
    UINT nFlags,
    CPoint point);

Parameter

nFlags
[in] Gibt an, ob der Benutzer Zusatztasten gedrückt hat. Mögliche Werte finden Sie im Parameter wParam in WM_LBUTTONDOWN "Notification".

point
[in] Gibt die X- und Y-Koordinaten des Zeigers relativ zur oberen linken Ecke des Fensters an.

Hinweise

CFrameWndEx::OnLButtonUp

Das Framework ruft diese Methode auf, wenn der Benutzer die linke Maustaste loslässt.

afx_msg void OnLButtonUp(
    UINT nFlags,
    CPoint point);

Parameter

nFlags
[in] Gibt an, ob der Benutzer Zusatztasten gedrückt hat. Mögliche Werte finden Sie im Parameter wParam in WM_LBUTTONUP "Notification".

point
[in] Gibt die X- und Y-Koordinaten des Zeigers relativ zur oberen linken Ecke des Fensters an.

Hinweise

CFrameWndEx::OnMenuButtonToolHitTest

Wird vom Framework aufgerufen, wenn ein CMFCToolBarButton Objekt eine WM_NCHITTEST Nachricht verarbeitet.

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

Parameter

pButton
[in] Ein Zeiger auf die Symbolleistenschaltfläche.

pTI
[out] Ein Zeiger auf eine Toolinformationsstruktur.

Rückgabewert

TRUE wenn die Anwendung den pTI Parameter ausfüllt. Andernfalls FALSE.

Hinweise

Überschreiben Sie diese Methode, wenn Sie eine QuickInfo-Informationen zu einem bestimmten Menüelement bereitstellen möchten.

CFrameWndEx::OnMenuChar

Wird vom Framework aufgerufen, wenn ein Menü angezeigt wird und der Benutzer eine Taste drückt, die keinem Befehl entspricht.

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

Parameter

nChar
[in] Zeichencode der gedrückten Taste.

nFlags
[in] Enthält das MF_POPUP Kennzeichen, wenn das angezeigte Menü ein Untermenü ist. Enthält das MF_SYSMENU Flag, wenn das angezeigte Menü ein Steuerelementmenü ist.

pMenu
[in] Zeigen Sie auf ein Menü.

Rückgabewert

Das Wort mit hoher Reihenfolge muss einen der folgenden Werte aufweisen.

Wert Beschreibung
0 Das Framework sollte die Tastenfolge ignorieren.
1 Das Framework sollte das Menü schließen.
2 Das Framework sollte eines der im Menü angezeigten Elemente auswählen. Das Wort mit niedriger Reihenfolge enthält die ID des auszuwählenden Befehls.

CFrameWndEx::OnMouseMove

Das Framework ruft diese Methode auf, wenn der Zeiger verschoben wird.

afx_msg void OnMouseMove(
    UINT nFlags,
    CPoint point);

Parameter

nFlags
[in] Gibt an, ob ein Benutzer Zusatztasten gedrückt hat. Mögliche Werte finden Sie im Parameter wParam in WM_MOUSEMOVE "Notification".

point
[in] Gibt die x Koordinaten des y Zeigers relativ zur oberen linken Ecke des Fensters an.

Hinweise

CFrameWndEx::OnMoveMiniFrame

Wird vom Framework aufgerufen, wenn ein Fensterfenster verschoben wird.

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

Parameter

pFrame
[in] Zeigen Sie auf das CPaneFrameWnd Fenster "Kursbereich ".

Rückgabewert

TRUE wenn das Fensterfenster nicht angedockt wurde; FALSE wenn das Fensterfenster angedockt wurde.

Hinweise

CFrameWndEx::OnNcActivate

Wird vom Framework aufgerufen, wenn der Nicht-Clientbereich des Frames neu gezeichnet werden muss, um eine Änderung im aktiven Zustand anzuzeigen.

afx_msg BOOL OnNcActivate(BOOL bActive);

Parameter

bActive
[in] TRUE um den Rahmen aktiv zu zeichnen; FALSE um den Frame inaktiv zu zeichnen.

Rückgabewert

Nonzero, um mit der Standardverarbeitung fortzufahren; 0, um zu verhindern, dass der Nicht-Client-Bereich deaktiviert wird.

Hinweise

CFrameWndEx::OnNcCalcSize

Wird vom Framework aufgerufen, wenn die Größe und Position des Clientbereichs berechnet werden müssen.

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

Parameter

bCalcValidRects
[in] TRUE wenn die Anwendung einen gültigen Clientbereich angeben muss; andernfalls . FALSE

lpncsp
[in] Zeigen Sie auf eine NCCALCSIZE_PARAMS Struktur, die Framedimensionsänderungen enthält.

Hinweise

CFrameWndEx::OnNcHitTest

Wird vom Framework aufgerufen, wenn der Zeiger bewegt oder eine Maustaste gedrückt oder losgelassen wird.

afx_msg LRESULT OnNcHitTest(CPoint point);

Parameter

point
[in] Die Position des Zeigers in Bildschirmkoordinaten.

Rückgabewert

Ein Zeiger trifft auf den aufgezählten Wert. Eine Liste der möglichen Werte finden Sie unter WM_NCHITTEST Benachrichtigung.

Hinweise

CFrameWndEx::OnNcMouseMove

Wird vom Framework aufgerufen, wenn der Zeiger in einem Nicht-Client-Bereich verschoben wird.

afx_msg void OnNcMouseMove(
    UINT nHitTest,
    CPoint point);

Parameter

nHitTest
[in] Ein Zeiger trifft auf den aufgezählten Wert. Eine Liste der möglichen Werte finden Sie unter WM_NCHITTEST Benachrichtigung.

point
[in] Die Position des Zeigers in Bildschirmkoordinaten.

Hinweise

CFrameWndEx::OnNcPaint

Wird vom Framework aufgerufen, wenn der Nicht-Client-Bereich gezeichnet werden muss.

afx_msg void OnNcPaint();

Hinweise

CFrameWndEx::OnPaneCheck

Vom Framework aufgerufen, um die Sichtbarkeit eines Bereichs zu steuern.

afx_msg BOOL OnPaneCheck(UINT nID);

Parameter

nID
[in] Steuerelement-ID eines Bereichs.

Rückgabewert

TRUE wenn der Befehl behandelt wurde; FALSE um mit der Befehlsverarbeitung fortzufahren.

Hinweise

CFrameWndEx::OnPostPreviewFrame

Wird vom Framework aufgerufen, wenn der Benutzer den Druckvorschaumodus ändert.

afx_msg LRESULT OnPostPreviewFrame(
    WPARAM wParam,
    LPARAM lParam);

Parameter

wParam
[in] Dieser Parameter wird nicht verwendet.

lParam
[in] TRUE wenn sich der Frame im Druckvorschaumodus befindet; FALSE wenn der Druckvorschaumodus deaktiviert ist.

Rückgabewert

Es wird immer 0 zurückgegeben.

Hinweise

CFrameWndEx::OnPowerBroadcast

Wird vom Framework aufgerufen, wenn ein Energieverwaltungsereignis auftritt.

afx_msg LRESULT OnPowerBroadcast(
    WPARAM wp,
    LPARAM lp);

Parameter

wp
[in] Das Energieverwaltungsereignis. Eine Liste der möglichen Werte finden Sie unter WM_POWERBROADCAST "Nachricht".

lp
[in] Dieser Parameter wird nicht verwendet.

Rückgabewert

Ergebnis des Aufrufs der Standardfensterprozedur.

Hinweise

CFrameWndEx::OnSetMenu

Vom Framework aufgerufen, um das Framefenstermenü zu ersetzen.

afx_msg LRESULT OnSetMenu(
    WPARAM wp,
    LPARAM lp);

BOOL OnSetMenu(HMENU hmenu);

Parameter

wp
[in] Behandeln Sie das neue Framefenstermenü.

lp
[in] Behandeln sie das neue Fenstermenü.

hmenu
[in] Behandeln Sie das neue Framefenstermenü.

Rückgabewert

LRESULT ist das Ergebnis des Aufrufens der Standardfensterprozedur.

BOOL ist TRUE , wenn das Ereignis behandelt wurde; andernfalls FALSE.

Hinweise

CFrameWndEx::OnSetPreviewMode

Vom Framework aufgerufen, um den Druckvorschaumodus für den Frame festzulegen.

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

Parameter

bPreview
[in] TRUE um die Seitenansicht zu aktivieren; FALSE um die Seitenansicht zu deaktivieren.

pState
[in] Zeiger auf eine CPrintPreviewState Framezustandsstruktur.

Hinweise

CFrameWndEx::OnSetText

Vom Framework aufgerufen, um den Text eines Fensters festzulegen.

afx_msg LRESULT OnSetText(
    WPARAM wParam,
    LPARAM lParam);

Parameter

wParam
[in] Dieser Parameter wird nicht verwendet.

lParam
[in] Zeigen Sie auf den Text für das Fenster.

Rückgabewert

Rückgabewert aus einem Aufruf von DefWindowProc.

Hinweise

CFrameWndEx::OnShowCustomizePane

Wird vom Framework aufgerufen, wenn ein QuickCustomizePane.

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

Parameter

pMenuPane
[in] Ein Zeiger auf den Bereich "Schnell anpassen".

uiToolbarID
[in] Die Steuerelement-ID der zu anpassenden Symbolleiste.

Rückgabewert

Diese Methode gibt immer TRUE zurück.

Hinweise

Das Menü "Schnell anpassen" ist ein Popupmenü, das angezeigt wird, wenn Sie auf die Schaltfläche "Anpassen" der Symbolleiste klicken.

CFrameWndEx::OnShowPanes

Vom Framework aufgerufen, um Bereiche ein- oder auszublenden.

virtual BOOL OnShowPanes(BOOL bShow);

Parameter

bShow
[in] TRUE wenn die Anwendung die Bereiche anzeigt; FALSE sonst.

Rückgabewert

Diese Methode gibt immer FALSE zurück.

Hinweise

In der Standardimplementierung werden die Bereiche angezeigt, sofern bShow und TRUE die Bereiche ausgeblendet sind oder wann bShow FALSE und welche Bereiche sichtbar sind.

Die Standardimplementierung blendet die Bereiche aus, wenn bShow ja TRUE , und die Bereiche sind sichtbar oder wann bShow FALSE und die Bereiche ausgeblendet sind.

Überschreiben Sie diese Methode in einer abgeleiteten Klasse, um benutzerdefinierten Code auszuführen, wenn das Framework Bereiche ein- oder ausblendet.

CFrameWndEx::OnShowPopupMenu

Wird vom Framework aufgerufen, wenn ein Popupmenü angezeigt wird.

virtual BOOL OnShowPopupMenu(CMFCPopupMenu* pMenu);

Parameter

pMenu
[in] Ein Zeiger auf ein Popupmenü.

Rückgabewert

TRUE wenn das Popupmenü sichtbar ist; andernfalls FALSE.

Hinweise

Überschreiben Sie diese Methode in einer abgeleiteten Klasse, um benutzerdefinierten Code auszuführen, wenn das Framework ein Popupmenü anzeigt. Überschreiben Sie diese Methode beispielsweise, um die Hintergrundfarbe der Befehle in einem Popupmenü zu ändern.

CFrameWndEx::OnSize

Wird vom Framework aufgerufen, nachdem sich die Größe des Frames geändert hat.

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

Parameter

nType
[in] Der Typ der Größenänderung. Mögliche Werte finden Sie im Parameter wParam in WM_SIZE Notification.

cx
[in] Neue Breite des Frames in Pixeln.

cy
[in] Neue Höhe des Frames in Pixeln.

Hinweise

CFrameWndEx::OnSizing

Wird vom Framework aufgerufen, wenn der Benutzer die Größe des Frames ändert.

afx_msg void OnSizing(
    UINT fwSide,
    LPRECT pRect);

Parameter

fwSide
[in] Der Rand des rahmens, der verschoben wird. Siehe den Parameter wParam in WM_SIZING "Notification".

pRect
[in, out] Zeigen Sie auf eine CRect oder RECT eine Struktur, die die Koordinaten des Frames enthält.

Hinweise

CFrameWndEx::OnSysColorChange

Wird vom Framework aufgerufen, wenn sich die Systemfarben ändern.

void OnSysColorChange();

Hinweise

CFrameWndEx::OnTearOffMenu

Wird vom Framework aufgerufen, wenn die Anwendung ein Menü mit einer Abreißleiste anzeigt.

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

Parameter

pMenuPopup
[in] Ein Zeiger auf ein Popupmenü.

pBar
[in] Ein Zeiger auf einen Abrissbalken.

Rückgabewert

TRUE wenn das Popupmenü mit der Reißleiste aktiviert ist; andernfalls FALSE.

Hinweise

Überschreiben Sie diese Methode in einer abgeleiteten Klasse, um benutzerdefinierten Code auszuführen, wenn das Framework eine Steuerelementleiste anzeigt.

Die Standardimplementierung führt nichts aus und gibt zurück TRUE.

CFrameWndEx::OnToolbarContextMenu

Vom Framework aufgerufen, um ein Popupmenü für symbolleisten zu erstellen.

afx_msg LRESULT OnToolbarContextMenu(
    WPARAM wp,
    LPARAM lp);

Parameter

wp
[in] Dieser Parameter wird nicht verwendet.

lp
[in] Dieser Parameter wird nicht verwendet.

Rückgabewert

Gibt immer 1 zurück.

Hinweise

CFrameWndEx::OnToolbarCreateNew

Das Framework ruft diese Methode auf, um eine neue Symbolleiste zu erstellen.

afx_msg LRESULT OnToolbarCreateNew(
    WPARAM wp,
    LPARAM lp);

Parameter

wp
[in] Dieser Parameter wird nicht verwendet.

lp
[in] Zeigen Sie auf den Text für die Titelleiste der Symbolleiste.

Rückgabewert

Zeiger auf die neue Symbolleiste; oder NULL wenn keine Symbolleiste erstellt wurde.

Hinweise

CFrameWndEx::OnToolbarDelete

Wird vom Framework aufgerufen, wenn eine Symbolleiste gelöscht wird.

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

Parameter

unused
[in] Dieser Parameter wird nicht verwendet.

lp
[in] Zeiger auf eine Symbolleiste.

Rückgabewert

TRUEwenn die Symbolleiste gelöscht wurde; andernfalls . FALSE

Hinweise

CFrameWndEx::OnUpdateFrameMenu

Vom Framework aufgerufen, um das Framemenü festzulegen.

virtual void OnUpdateFrameMenu(HMENU hMenuAlt);

Parameter

hMenuAlt
[in] Behandeln Sie das alternative Menü.

Hinweise

CFrameWndEx::OnUpdateFrameTitle

Das Framework ruft diese Methode auf, um die Titelleiste des Framefensters zu aktualisieren.

virtual void OnUpdateFrameTitle(BOOL bAddToTitle);

Parameter

bAddToTitle
[in] TRUE um den aktiven Dokumenttitel zur Titelleiste des Rahmenfensters hinzuzufügen; andernfalls FALSE.

Hinweise

CFrameWndEx::OnUpdatePaneMenu

Vom Framework aufgerufen, um das Bereichsmenü zu aktualisieren.

afx_msg void OnUpdatePaneMenu(CCmdUI* pCmdUI);

Parameter

pCmdUI
[in] Zeigen Sie auf das Benutzeroberflächenobjekt des Bereichs.

Hinweise

CFrameWndEx::OnWindowPosChanged

Wird vom Framework aufgerufen, wenn sich die Framegröße, Position oder Z-Reihenfolge aufgrund eines Aufrufs einer Fensterverwaltungsmethode geändert hat.

afx_msg void OnWindowPosChanged(WINDOWPOS FAR* lpwndpos);

Parameter

lpwndpos
[in] Zeigen Sie auf eine WINDOWPOS Struktur, die die neue Größe und Position enthält.

Hinweise

CFrameWndEx::PaneFromPoint

Durchsucht jeden Bereich nach dem angegebenen Punkt.

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

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

Parameter

point
[in] Die Bildschirmkoordinaten des zu überprüfenden Punkts.

nSensitivity
[in] Erweitern Sie das umgebende Rechteck jeder Steuerelementleiste um diesen Betrag, wenn Sie nach Punkt suchen.

bExactBar
[in] TRUE um den nSensitivity Parameter zu ignorieren; andernfalls FALSE.

pRTCBarType
[in] Wenn nicht NULL, durchsucht die Methode nur die Steuerelementleisten des angegebenen Typs.

dwAlignment
[out] Bei erfolgreicher Ausführung enthält dieser Parameter die Seite der Steuerelementleiste, die dem angegebenen Punkt am nächsten kommt. Andernfalls wird dieser Parameter nicht initialisiert.

Rückgabewert

Ein Zeiger auf eine Steuerelementleiste, die den point; NULL enthält, wenn kein Steuerelement gefunden wird.

Hinweise

Diese Methode durchsucht alle Steuerleisten in Ihrer Anwendung nach einem point.

Wird verwendet nSensitivity , um die Größe des Suchbereichs zu erhöhen. Wird verwendet pRTCBarType , um die Typen von Steuerelementleisten einzuschränken, die von der Methode durchsucht werden.

CFrameWndEx::PreTranslateMessage

Behandelt bestimmte Fenstermeldungen, bevor sie verteilt werden.

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parameter

pMsg
[in] Ein Zeiger auf eine MSG Struktur, die die zu verarbeitende Nachricht enthält.

Rückgabewert

Ungleich Null, wenn die Nachricht verarbeitet wurde und nicht verteilt werden sollte; 0, wenn die Nachricht nicht verarbeitet wurde und verteilt werden soll.

Hinweise

CFrameWndEx::RecalcLayout

Passt das Layout des Rahmens und seiner untergeordneten Fenster an.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parameter

bNotify
[in] Gibt an, ob das OLE-Clientelement über die Layoutänderung benachrichtigt werden soll.

Hinweise

Diese Methode wird aufgerufen, wenn sich die Größe des Rahmenfensters geändert hat oder wenn Steuerleisten angezeigt oder ausgeblendet werden.

CFrameWndEx::RemovePaneFromDockManager

Hebt die Registrierung eines Bereichs auf und entfernt ihn aus dem Docking-Manager.

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

Parameter

pControlBar
[in] Ein Zeiger auf den zu entfernenden Steuerelementleistenbereich.

bDestroy
[in] TRUE die Kontrollleiste nach dem Entfernen zu zerstören; FALSE sonst.

bAdjustLayout
[in] TRUE um das Andocklayout anzupassen; FALSE sonst.

bAutoHide
[in] TRUE wenn sich die Steuerleiste im Modus "Automatisches Ausblenden" befindet; FALSE sonst.

pBarReplacement
[in] Ein Zeiger auf einen Bereich, der den entfernten Bereich ersetzt.

Hinweise

Verwenden Sie diese Methode, um eine Steuerleiste aus dem Andocklayout des Rahmenfensters zu entfernen.

Die CDockingManager Klasse behandelt das Layout von Steuerleisten. Sie müssen jede Steuerleiste mit dem Docking-Manager mithilfe der CFrameWndEx::AddPane Methode oder der CFrameWndEx::InsertPane Methode registrieren.

CFrameWndEx::SetDockState

Stellt das Dockinglayout auf den in der Registrierung gespeicherten Andockzustand wieder her.

void SetDockState(const CDockState& state);

Parameter

state
Der Andockzustand. Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil und einem kulturspezifischen Format in die entsprechende 32-Bit-Ganzzahl mit Vorzeichen.

CFrameWndEx::SetPrintPreviewFrame

Legt das Fenster für den Seitenvorschaurahmen fest.

void SetPrintPreviewFrame(CFrameWnd* pWnd);

Parameter

pWnd
[in] Zeigen Sie auf ein Seitenansichtsrahmenfenster.

Hinweise

CFrameWndEx::SetupToolbarMenu

Fügt benutzerdefinierte Befehle in ein Symbolleistenmenü ein.

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

Parameter

menu
[in] Ein CMenu zu ändernde Objekt.

uiViewUserToolbarCmdFirst
[in] Der erste benutzerdefinierte Befehl.

uiViewUserToolbarCmdLast
[in] Der letzte benutzerdefinierte Befehl.

Hinweise

Das Framework speichert benutzerdefinierte Befehle in einer Liste. Verwenden uiViewUserToolbarCmdFirst Sie die Einfügebefehle und uiViewUserToolbarCmdList geben Sie die Indizes der einzufügenden Befehle an.

CFrameWndEx::ShowFullScreen

Schaltet den Hauptrahmen zwischen Vollbildmodus und normaler Modus um.

void ShowFullScreen();

CFrameWndEx::ShowPane

Blendet den angegebenen Bereich ein oder aus.

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

Parameter

pBar
[in] Ein Zeiger auf die Steuerleiste zum Ein- oder Ausblenden.

bShow
[in] Wenn TRUEdie Anwendung die Steuerelementleiste anzeigt. Andernfalls blendet die Anwendung die Steuerelementleiste aus.

bDelay
[in] Wenn TRUE, verzögern Sie die Anpassung des Docking-Layouts, bis das Framework aufruft CFrameWndEx::AdjustDockingLayout. Andernfalls müssen Sie das Andocklayout sofort neu berechnen.

bActivate
[in] Wenn TRUE, machen Sie die Steuerleiste aktiv. Andernfalls wird die Steuerleiste in einem inaktiven Zustand angezeigt.

CFrameWndEx::UpdateCaption

Vom Framework aufgerufen, um die Fensterrahmenbeschriftung zu aktualisieren.

void UpdateCaption();

Hinweise

CFrameWndEx::WinHelp

Ruft entweder die WinHelp-Anwendung oder kontextbezogene Hilfe auf.

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

Parameter

dwData
Daten, die vom nCmd Parameter abhängen. Eine Liste der möglichen Werte finden Sie unter WinHelp.

nCmd
Der Hilfebefehl. Eine Liste der möglichen Werte finden Sie unter WinHelp.

Hinweise

Weitere Informationen

Hierarchiediagramm
Klassen
CFrameWnd