Share via


CFrameWndEx-klasse

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Implementeert de functionaliteit van een windows-venster met één documentinterface (SDI) dat overlapt of pop-upframevenster en biedt leden voor het beheren van het venster. De klasse wordt uitgebreid CFrameWnd .

Syntaxis

class CFrameWndEx : public CFrameWnd

Leden

Openbare methoden

Naam Description
CFrameWndEx::ActiveItemRecalcLayout Hiermee past u de indeling van het OLE-clientitem en het clientgebied van het frame aan.
CFrameWndEx::AddDockSite Deze methode wordt niet gebruikt.
CFrameWndEx::AddPane Registreert een besturingsbalk bij de dockingmanager.
CFrameWndEx::AdjustDockingLayout Berekent de indeling van alle deelvensters die zijn gekoppeld aan het framevenster.
CFrameWndEx::DelayUpdateFrameMenu Hiermee stelt u het framemenu in en werkt u het vervolgens bij wanneer de opdrachtverwerking inactief is.
CFrameWndEx::DockPane Hiermee wordt het opgegeven deelvenster gekoppeld aan het framevenster.
CFrameWndEx::DockPaneLeftOf Hiermee wordt het ene deelvenster aan de linkerkant van een ander deelvenster gekoppeld.
CFrameWndEx::EnableAutoHidePanes Hiermee schakelt u de modus voor automatisch verbergen voor de deelvensters in wanneer ze zijn vastgezet aan de opgegeven zijden van het hoofdframevenster.
CFrameWndEx::EnableDocking Hiermee schakelt u het dokken van de deelvensters die deel uitmaken van het framevenster.
CFrameWndEx::EnableFullScreenMainMenu Hiermee wordt het hoofdmenu in de modus Volledig scherm weergegeven of verborgen.
CFrameWndEx::EnableFullScreenMode Hiermee schakelt u de modus Volledig scherm in voor het framevenster.
CFrameWndEx::EnableLoadDockState Hiermee schakelt u het laden van de dockingstatus in of uit.
CFrameWndEx::EnablePaneMenu Hiermee schakelt u de automatische verwerking van het deelvenstermenu in of uit.
CFrameWndEx::GetActivePopup Hiermee wordt een aanwijzer geretourneerd naar het pop-upmenu dat momenteel wordt weergegeven.
CFrameWndEx::GetDefaultResId Retourneert de resource-id die u hebt opgegeven toen het framework het framevenster heeft geladen.
CFrameWndEx::GetDockingManager Hiermee wordt het CDockingManager klasseobject voor het framevenster opgehaald.
CFrameWndEx::GetMenuBar Hiermee wordt een aanwijzer geretourneerd naar het menubalkobject dat is gekoppeld aan het framevenster.
CFrameWndEx::GetPane Retourneert een aanwijzer naar het deelvenster met de opgegeven id.
CFrameWndEx::GetRibbonBar Hiermee haalt u het besturingselement op de lintbalk voor het frame op.
CFrameWndEx::GetTearOffBars Retourneert een lijst met deelvensterobjecten die de status Scheuren hebben.
CFrameWndEx::GetToolbarButtonToolTipText Aangeroepen door het framework wanneer de toepassing de knopinfo voor een werkbalk weergeeft.
CFrameWndEx::InsertPane Registreert een deelvenster met de dockingmanager.
CFrameWndEx::IsFullScreen Bepaalt of het framevenster zich in de modus Volledig scherm bevindt.
CFrameWndEx::IsMenuBarAvailable Bepaalt of de aanwijzer naar het menubalkobject geldig is.
CFrameWndEx::IsPointNearDockSite Geeft aan of het punt zich in een uitlijningszone bevindt.
CFrameWndEx::IsPrintPreview Geeft aan of het framevenster zich in de afdrukvoorbeeldmodus bevindt.
CFrameWndEx::LoadFrame Deze methode wordt na de constructie aangeroepen om het framevenster te maken en de bijbehorende resources te laden.
CFrameWndEx::NegotiateBorderSpace Implementeert OLE-clientrandonderhandeling.
CFrameWndEx::OnActivate Dit framework roept deze methode aan wanneer gebruikersinvoer wordt overgeschakeld naar of verwijderd van het frame.
CFrameWndEx::OnActivateApp Aangeroepen door het framework wanneer de toepassing is geselecteerd of gedeselecteerd.
CFrameWndEx::OnChangeVisualManager Aangeroepen door het framework wanneer een wijziging in het frame een wijziging in het frame vereist, is een wijziging in visualbeheer vereist.
CFrameWndEx::OnClose In het framework wordt deze methode aangeroepen om het frame te sluiten.
CFrameWndEx::OnCloseDockingPane Aangeroepen door het framework wanneer de gebruiker op de knop Sluiten in een dockingvenster klikt.
CFrameWndEx::OnCloseMiniFrame Aangeroepen door het framework wanneer de gebruiker op de knop Sluiten klikt in een zwevend miniframevenster.
CFrameWndEx::OnClosePopupMenu Aangeroepen door het framework wanneer een actief snelmenu een WM_DESTROY bericht verwerkt.
CFrameWndEx::OnCmdMsg Verzendt opdrachtberichten.
CFrameWndEx::OnContextHelp Aangeroepen door het framework om contextgerelateerde help weer te geven.
CFrameWndEx::OnCreate Aangeroepen door het framework nadat het frame is gemaakt.
CFrameWndEx::OnDestroy Aangeroepen door het framework wanneer het frame wordt vernietigd.
CFrameWndEx::OnDrawMenuImage Aangeroepen door het framework wanneer de toepassing de afbeelding tekent die is gekoppeld aan een menu-item.
CFrameWndEx::OnDrawMenuLogo Aangeroepen door het framework wanneer een CMFCPopupMenu object een WM_PAINT bericht verwerkt.
CFrameWndEx::OnDWMCompositionChanged Aangeroepen door het framework wanneer de samenstelling van Desktop Window Manager (DWM) is ingeschakeld of uitgeschakeld.
CFrameWndEx::OnExitSizeMove Aangeroepen door het framework wanneer het frame stopt met verplaatsen of het formaat ervan wijzigen.
CFrameWndEx::OnGetMinMaxInfo Aangeroepen door het framework wanneer het frame wordt aangepast om limieten voor vensterdimensie in te stellen.
CFrameWndEx::OnIdleUpdateCmdUI Wordt aangeroepen door het framework om de frameweergave bij te werken wanneer de opdrachtverwerking niet actief is.
CFrameWndEx::OnLButtonDown Dit framework roept deze methode aan wanneer de gebruiker op de linkermuisknop drukt.
CFrameWndEx::OnLButtonUp In het framework wordt deze methode aangeroepen wanneer de gebruiker de linkermuisknop loslaat.
CFrameWndEx::OnMenuButtonToolHitTest Aangeroepen door het framework wanneer een CMFCToolBarButton object een WM_NCHITTEST bericht verwerkt.
CFrameWndEx::OnMenuChar Aangeroepen door het framework wanneer een menu wordt weergegeven en de gebruiker op een toets drukt die niet overeenkomt met een opdracht.
CFrameWndEx::OnMouseMove Dit framework roept deze methode aan wanneer de aanwijzer wordt verplaatst.
CFrameWndEx::OnMoveMiniFrame Aangeroepen door het framework wanneer een deelvenstervenster wordt verplaatst.
CFrameWndEx::OnNcActivate Aangeroepen door het framework wanneer het niet-clientgebied van het frame opnieuw moet worden getekend om een wijziging in de actieve status aan te geven.
CFrameWndEx::OnNcCalcSize Aangeroepen door het framework wanneer de grootte en positie van het clientgebied moeten worden berekend.
CFrameWndEx::OnNcHitTest Aangeroepen door het framework wanneer de aanwijzer wordt verplaatst of wanneer een muisknop wordt ingedrukt of losgelaten.
CFrameWndEx::OnNcMouseMove Aangeroepen door het framework wanneer de aanwijzer in een niet-clientgebied wordt verplaatst.
CFrameWndEx::OnNcPaint Aangeroepen door het framework wanneer het niet-clientgebied moet worden geschilderd.
CFrameWndEx::OnPaneCheck Wordt aangeroepen door het framework om de zichtbaarheid van een deelvenster te beheren.
CFrameWndEx::OnPostPreviewFrame Aangeroepen door het framework wanneer de gebruiker de afdrukvoorbeeldmodus heeft gewijzigd.
CFrameWndEx::OnPowerBroadcast Wordt aangeroepen door het framework wanneer er een energiebeheer-gebeurtenis plaatsvindt.
CFrameWndEx::OnSetMenu Aangeroepen door het framework om het framevenstermenu te vervangen.
CFrameWndEx::OnSetPreviewMode Aangeroepen door het framework om de afdrukvoorbeeldmodus voor het frame in te stellen.
CFrameWndEx::OnSetText Aangeroepen door het framework om de tekst van een venster in te stellen.
CFrameWndEx::OnShowCustomizePane Aangeroepen door het framework wanneer een deelvenster snel aanpassen is ingeschakeld.
CFrameWndEx::OnShowPanes Aangeroepen door het framework om deelvensters weer te geven of te verbergen.
CFrameWndEx::OnShowPopupMenu Aangeroepen door het framework wanneer een snelmenu is ingeschakeld.
CFrameWndEx::OnSize In het framework wordt deze methode aangeroepen nadat de grootte van het frame is gewijzigd.
CFrameWndEx::OnSizing Dit framework roept deze methode aan wanneer de gebruiker de grootte van het frame wijzigt.
CFrameWndEx::OnSysColorChange Aangeroepen door het framework wanneer de systeemkleuren veranderen.
CFrameWndEx::OnTearOffMenu Aangeroepen door het framework wanneer een menu met een scheurbalk is ingeschakeld.
CFrameWndEx::OnToolbarContextMenu Wordt aangeroepen door het framework om een contextmenu op de werkbalk te maken.
CFrameWndEx::OnToolbarCreateNew In het framework wordt deze methode aangeroepen om een nieuwe werkbalk te maken.
CFrameWndEx::OnToolbarDelete Aangeroepen door het framework wanneer een werkbalk wordt verwijderd.
CFrameWndEx::OnUpdateFrameMenu Aangeroepen door het framework om het framemenu in te stellen.
CFrameWndEx::OnUpdateFrameTitle Dit framework roept deze methode aan om de titelbalk van het framevenster bij te werken.
CFrameWndEx::OnUpdatePaneMenu Aangeroepen door het framework om het deelvenstermenu bij te werken.
CFrameWndEx::OnWindowPosChanged Aangeroepen door het framework wanneer de framegrootte, positie of z-volgorde is gewijzigd vanwege een aanroep naar een vensterbeheermethode.
CFrameWndEx::PaneFromPoint Retourneert het dockingvenster dat het opgegeven punt bevat.
CFrameWndEx::PreTranslateMessage Hiermee worden specifieke vensterberichten verwerkt voordat ze worden verzonden.
CFrameWndEx::RecalcLayout Hiermee past u de indeling van het frame en de onderliggende vensters aan.
CFrameWndEx::RemovePaneFromDockManager Hiermee maakt u de registratie van een deelvenster ongedaan en verwijdert u het uit de interne lijst in het dockingbeheer.
CFrameWndEx::SetDockState Hiermee herstelt u de dockingindeling naar de dockingstatus die in het register is opgeslagen.
CFrameWndEx::SetPrintPreviewFrame Hiermee stelt u het venster afdrukvoorbeeldframe in.
CFrameWndEx::SetupToolbarMenu Hiermee voegt u door de gebruiker gedefinieerde opdrachten in een werkbalkmenu in.
CFrameWndEx::ShowFullScreen Hiermee schakelt u het hoofdframe tussen het volledige scherm en de normale modi.
CFrameWndEx::ShowPane Hiermee wordt het opgegeven deelvenster weergegeven of verborgen.
CFrameWndEx::UpdateCaption Wordt aangeroepen door het framework om het bijschrift van het vensterframe bij te werken.
CFrameWndEx::WinHelp Roept de help voor de WinHelp toepassing of context aan.

Example

In het volgende voorbeeld ziet u hoe u een klasse kunt overnemen van de CFrameWndEx klasse. In het voorbeeld ziet u de methodehandtekeningen in de subklasse en hoe u de OnShowPopupMenu methode overschrijft. Dit codefragment maakt deel uit van het Word Pad-voorbeeld.

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

Overnamehiërarchie

CObject

CCmdTarget

CWnd

CFrameWnd

CFrameWndEx

Requirements

Rubriek:afxframewndex.h

CFrameWndEx::ActiveItemRecalcLayout

Hiermee past u de indeling van het OLE-clientitem en het clientgebied van het frame aan.

void ActiveItemRecalcLayout();

Opmerkingen

CFrameWndEx::AddPane

Registreert een besturingsbalk bij de dockingmanager.

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

Parameterwaarden

pControlBar
[in] Een deelvenster van de besturingsbalk om te registreren.

bTail
[in] TRUE als u het deelvenster van de besturingsbalk wilt toevoegen aan het einde van de lijst; FALSE Anders.

Retourwaarde

TRUE als de besturingsbalk is geregistreerd; FALSE Anders.

CFrameWndEx::AdjustDockingLayout

Berekent de indeling van alle deelvensters die zijn gekoppeld aan het framevenster.

virtual void AdjustDockingLayout(HDWP hdwp=NULL);

Parameterwaarden

hdwp
Een greep naar een structuur die de posities van meerdere vensters bevat. .

Opmerkingen

De structuur van het guw wordt geïnitialiseerd door de BeginDeferWindowPos methode.

CFrameWndEx::DelayUpdateFrameMenu

Hiermee stelt u het framemenu in en werkt u het vervolgens bij wanneer de opdrachtverwerking inactief is.

virtual void DelayUpdateFrameMenu(HMENU hMenuAlt);

Parameterwaarden

hMenuAlt
[in] Greep naar een alternatief menu.

Opmerkingen

CFrameWndEx::DockPane

Hiermee wordt het opgegeven deelvenster gekoppeld aan het framevenster.

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

Parameterwaarden

pBar
[in] Een aanwijzer naar de besturingsbalk die moet worden vastgezet.

nDockBarID
[in] De id van de zijkant van het framevenster waaraan moet worden vastgeslagen.

lpRect
[in] Een aanwijzer naar een constante Rect structuur die de schermpositie en -grootte van het venster aangeeft.

Opmerkingen

De nDockBarID parameter kan een van de volgende waarden hebben:

  • AFX_IDW_DOCKBAR_TOP

  • AFX_IDW_DOCKBAR_BOTTOM

  • AFX_IDW_DOCKBAR_LEFT

  • AFX_IDW_DOCKBAR_RIGHT

CFrameWndEx::DockPaneLeftOf

Hiermee wordt het opgegeven deelvenster aan de linkerkant van een ander deelvenster vastgesloten.

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

Parameterwaarden

pBar
[in] Een aanwijzer naar het deelvensterobject dat moet worden vastgezet.

pLeftOf
[in] Een aanwijzer naar het deelvenster links waarvan het deelvenster moet worden vastgesloten dat is opgegeven door pBar.

Retourwaarde

TRUE als pBar het vastgezet is. FALSE anders.

Opmerkingen

De methode gebruikt de werkbalk die is opgegeven door de pBar parameter en dockt deze aan de linkerkant van de werkbalk die is opgegeven door pLeftOf de parameter.

CFrameWndEx::EnableAutoHidePanes

Hiermee schakelt u de modus voor automatisch verbergen voor het deelvenster in wanneer het is gekoppeld aan de opgegeven zijde van het hoofdframevenster.

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

Parameterwaarden

dwDockStyle
[in] Hiermee geeft u de zijkant van het hoofdframevenster waaraan het deelvenster moet worden gedokt.

Retourwaarde

TRUE als een staafvenster is gekoppeld aan de framevensterzijde die is opgegeven door dwDockStyle, FALSE anders.

Opmerkingen

dwDockStyle kan een van de volgende waarden hebben:

  • CBRS_ALIGN_TOP: hiermee kan de besturingsbalk boven aan het clientgebied van een framevenster worden gedokt.

  • CBRS_ALIGN_BOTTOM: hiermee kan de besturingsbalk onder aan het clientgebied van een framevenster worden gedokt.

  • CBRS_ALIGN_LEFT: hiermee kan de besturingsbalk aan de linkerkant van het clientgebied van een framevenster worden gedokt.

  • CBRS_ALIGN_RIGHT: hiermee kan de besturingsbalk aan de rechterkant van het clientgebied van een framevenster worden gedokt.

CFrameWndEx::EnableDocking

Hiermee schakelt u het dokken van de deelvensters van het framevenster in.

BOOL EnableDocking(DWORD dwDockStyle);

Parameterwaarden

dwDockStyle
[in] Hiermee geeft u de zijkant van het hoofdframevenster waar de deelvensterbalk wordt vastgeslagen.

Retourwaarde

TRUE als een staafvenster aan de opgegeven zijde kan worden gedokt. FALSE anders.

Opmerkingen

De dwDockStyle parameter kan een van de volgende waarden hebben:

  • CBRS_ALIGN_TOP

  • CBRS_ALIGN_BOTTOM

  • CBRS_ALIGN_LEFT

  • CBRS_ALIGN_RIGHT

CFrameWndEx::EnableFullScreenMainMenu

Hiermee wordt het hoofdmenu in de modus Volledig scherm weergegeven of verborgen.

void EnableFullScreenMainMenu(BOOL bEnableMenu);

Parameterwaarden

bEnableMenu
[in] TRUE om het hoofdmenu weer te geven in de modus Volledig scherm, FALSE anders.

CFrameWndEx::EnableFullScreenMode

Hiermee schakelt u de modus Volledig scherm in voor het framevenster.

void EnableFullScreenMode(UINT uiFullScreenCmd);

Parameterwaarden

uiFullScreenCmd
[in] De id van een opdracht waarmee de modus volledig scherm wordt ingeschakeld en uitgeschakeld.

Opmerkingen

In de modus Volledig scherm worden alle dockingbesturingselementbalken, werkbalken en menu's verborgen en wordt de actieve weergave aangepast om het volledige scherm te bezetten.

Wanneer u de modus Volledig scherm inschakelt, moet u een id opgeven van de opdracht waarmee de modus volledig scherm wordt ingeschakeld of uitgeschakeld. U kunt aanroepen EnableFullScreenMode vanuit de functie van OnCreate het hoofdframe. Wanneer een framevenster wordt overgeschakeld naar een modus volledig scherm, maakt het framework een zwevende werkbalk met één knop met de opgegeven opdracht-id.

Als u het hoofdmenu op het scherm wilt behouden, belt CFrameWndEx::EnableFullScreenMainMenuu.

CFrameWndEx::EnableLoadDockState

Hiermee schakelt u het laden van de dockingstatus in of uit.

void EnableLoadDockState(BOOL bEnable=TRUE);

Parameterwaarden

bEnable
[in] TRUE om het laden van de dockingstatus in te schakelen, FALSE om het laden van de dockingstatus uit te schakelen.

CFrameWndEx::EnablePaneMenu

Hiermee schakelt u de automatische verwerking van het deelvenstermenu in of uit.

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

Parameterwaarden

bEnable
[in] TRUE om automatische verwerking van de pop-upmenu's van de besturingsbalk mogelijk te maken; FALSE om de automatische verwerking van de pop-upmenu's van de besturingsbalk uit te schakelen.

uiCustomizeCmd
[in] De opdracht-id van het menu-item Aanpassen .

strCustomizeLabel
[in] Het label dat moet worden weergegeven voor het menu-item Aanpassen

uiViewToolbarsMenuEntryID
[in] De id van een menu-item op de werkbalk waarmee het snelmenu op de besturingsbalk wordt geopend.

bContextMenuShowsToolbarsOnly
[in] Als TRUEin het contextmenu van de besturingsbalk alleen de lijst met werkbalken wordt weergegeven. Als FALSE, in het menu wordt de lijst met de werkbalken en de dockingbalken weergegeven.

bViewMenuShowsToolbarsOnly
[in] Als TRUEin het menu van de besturingsbalk alleen de lijst met werkbalken wordt weergegeven. Als FALSE, in het menu wordt de lijst met de werkbalken en de dockingbalken weergegeven.

CFrameWndEx::GetActivePopup

Hiermee wordt een aanwijzer geretourneerd naar het pop-upmenu dat momenteel wordt weergegeven.

CMFCPopupMenu* GetActivePopup() const;

Retourwaarde

Een aanwijzer naar het pop-upmenu dat momenteel wordt weergegeven; anders NULL.

CFrameWndEx::GetDefaultResId

Retourneert de resource-id die u hebt opgegeven toen het framework het framevenster heeft geladen.

UINT GetDefaultResId() const;

Retourwaarde

De resource-id-waarde die de gebruiker heeft opgegeven toen het framework het framevenster laadde. Nul als het framevenster geen menubalk heeft.

CFrameWndEx::GetDockingManager

Hiermee wordt het CDockingManager klasseobject voor het framevenster opgehaald.

CDockingManager* GetDockingManager();

Retourwaarde

Een aanwijzer naar de CDockingManager klas.

Opmerkingen

In het framevenster wordt een CDockingManager klasseobject gemaakt en gebruikt voor het beheren van docking van onderliggende vensters.

CFrameWndEx::GetMenuBar

Hiermee wordt een aanwijzer geretourneerd naar het menubalkobject dat is gekoppeld aan het framevenster.

const CMFCMenuBar* GetMenuBar() const;

Retourwaarde

Een aanwijzer naar het menubalkobject dat is gekoppeld aan het framevenster.

CFrameWndEx::GetPane

Retourneert een aanwijzer naar het deelvenster met de opgegeven id.

CBasePane* GetPane(UINT nID);

Parameterwaarden

nID
[in] De besturingselement-id.

Retourwaarde

Een aanwijzer naar het deelvenster met de opgegeven id. NULL als er geen dergelijk deelvenster bestaat.

CFrameWndEx::GetRibbonBar

Hiermee haalt u het besturingselement op de lintbalk voor het frame op.

CMFCRibbonBar* GetRibbonBar();

Retourwaarde

Aanwijzer naar de CMFCRibbonBar klasse voor het frame.

Opmerkingen

CFrameWndEx::GetTearOffBars

Retourneert een lijst met deelvensterobjecten die de status Scheuren hebben.

const CObList& GetTearOffBars() const;

Retourwaarde

Een verwijzing naar CObList het object met een verzameling aanwijzers naar de deelvensterobjecten die zich in een scheurtoestand bevinden.

CFrameWndEx::GetToolbarButtonToolTipText

Aangeroepen door het framework wanneer de toepassing de knopinfo voor een werkbalk weergeeft.

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

Parameterwaarden

pButton
[in] Een aanwijzer naar een werkbalkknop.

strTTText
[in] De knopinfotekst die moet worden weergegeven voor de knop.

Retourwaarde

TRUE als de knopinfo is weergegeven. FALSE anders.

Opmerkingen

Deze methode doet standaard niets. Overschrijf deze methode als u de knopinfo voor de werkbalkknop wilt weergeven.

CFrameWndEx::InsertPane

Hiermee voegt u een deelvenster in een lijst met besturingsbalken in en registreert u het bij de dockingmanager.

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

Parameterwaarden

pControlBar
Een aanwijzer naar een besturingsbalk die moet worden ingevoegd in de lijst met besturingsbalken en geregistreerd bij de dockingmanager.

pTarget
Een aanwijzer naar een besturingsbalk voor of waarna het deelvenster moet worden ingevoegd.

bAfter
TRUEals u erna pTargetwilt invoegenpControlBar, FALSE anders.

Retourwaarde

TRUE als de besturingsbalk is ingevoegd en geregistreerd, FALSE anders.

Opmerkingen

U moet elke besturingsbalk registreren door de CDockingManager klasse te gebruiken om deel te nemen aan de dockingindeling.

CFrameWndEx::IsFullScreen

Bepaalt of het framevenster zich in de modus Volledig scherm bevindt.

BOOL IsFullScreen() const;

Retourwaarde

TRUE als het framevenster zich in de modus Volledig scherm bevindt; anders FALSE.

Opmerkingen

U kunt de modus volledig scherm instellen door de CFrameWndEx::EnableFullScreenMode methode aan te roepen.

CFrameWndEx::IsMenuBarAvailable

Bepaalt of de aanwijzer naar het menubalkobject geldig is.

BOOL IsMenuBarAvailable() const;

Retourwaarde

TRUE als het framevenster een menubalk heeft; anders FALSE.

CFrameWndEx::IsPointNearDockSite

Bepaalt of het punt zich in een uitlijningszone bevindt.

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

Parameterwaarden

point
[in] De positie van het punt.

dwBarAlignment
[uit] Waar het punt is uitgelijnd. Zie de tabel in de sectie Opmerkingen voor mogelijke waarden.

bOuterEdge
[uit] TRUE als het punt zich dicht bij de kaderrand bevindt; FALSE als het punt zich in een clientgebied bevindt.

Retourwaarde

TRUE als het punt zich in een uitlijningszone bevindt; anders, FALSE.

Opmerkingen

De volgende tabel bevat de mogelijke waarden voor de dwBarAlignment parameter.

Waarde Description
CBRS_ALIGN_TOP Uitgelijnd op de bovenkant.
CBRS_ALIGN_RIGHT Uitgelijnd aan de rechterkant.
CBRS_ALIGN_BOTTOM Uitgelijnd op de onderkant.
CBRS_ALIGN_LEFT Uitgelijnd aan de linkerkant.

CFrameWndEx::IsPrintPreview

Bepaalt of het framevenster zich in de afdrukvoorbeeldmodus bevindt.

BOOL IsPrintPreview();

Retourwaarde

TRUE als het framevenster zich in de afdrukvoorbeeldmodus bevindt; anders, FALSE.

Opmerkingen

CFrameWndEx::LoadFrame

Deze methode wordt na de constructie aangeroepen om het framevenster te maken en de bijbehorende resources te laden.

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

Parameterwaarden

nIDResource
[in] De resource-id die wordt gebruikt om alle frameresources te laden.

dwDefaultStyle
[in] De standaardstijl van het framevenster.

pParentWnd
[in] Aanwijzer naar het bovenliggende venster van het frame.

pContext
[in] Wijs een CCreateContext structuurklasse aan die wordt gebruikt door het framework tijdens het maken van de toepassing.

Retourwaarde

TRUE als de methode is geslaagd; anders, FALSE.

Opmerkingen

CFrameWndEx::NegotiateBorderSpace

Implementeert OLE-clientrandonderhandeling.

virtual BOOL NegotiateBorderSpace(
    UINT nBorderCmd,
    LPRECT lpRectBorder);

Parameterwaarden

nBorderCmd
[in] De opdracht grensonderhandeling. Zie de sectie Opmerkingen voor mogelijke waarden.

lpRectBorder
[in, uit] Afmetingen van de rand.

Retourwaarde

TRUE indien de indeling opnieuw moet worden berekend; anders, FALSE.

Opmerkingen

De volgende tabel bevat de mogelijke waarden voor de nBorderCmd parameter.

borderGet
Haal beschikbare OLE-clientruimte op.

borderRequest
OLE-clientruimte aanvragen.

borderSet
OLE-clientruimte instellen.

CFrameWndEx::OnActivate

Dit framework roept deze methode aan wanneer gebruikersinvoer wordt overgeschakeld naar of verwijderd van het frame.

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

Parameterwaarden

nState
[in] Of het frame actief of inactief is. Zie de tabel in de sectie Opmerkingen voor mogelijke waarden.

pWndOther
[in] Aanwijzer naar een ander venster dat gebruikersinvoer overschakelt met de huidige.

bMinimized
[in] De geminimaliseerde status van het frame. TRUE indien het frame wordt geminimaliseerd; anders, FALSE.

Opmerkingen

De volgende tabel bevat de mogelijke waarden voor de nState parameter.

Waarde Description
WA_ACTIVE Het frame wordt geselecteerd door een andere methode dan een muisklik.
WA_CLICKACTIVE Het frame wordt geselecteerd met een muisklik.
WA_INACTIVE Het frame is niet geselecteerd.

CFrameWndEx::OnActivateApp

Aangeroepen door het framework wanneer de toepassing is geselecteerd of gedeselecteerd.

afx_msg void OnActivateApp(
    BOOL bActive,
    DWORD dwThreadID);

Parameterwaarden

bActive
[in] TRUE als de toepassing is geselecteerd; FALSE als de toepassing niet is geselecteerd.

dwThreadID
[in] Deze parameter wordt niet gebruikt.

Opmerkingen

CFrameWndEx::OnChangeVisualManager

Aangeroepen door het framework wanneer een wijziging in het frame een wijziging in het frame vereist, is een wijziging in visualbeheer vereist.

afx_msg LRESULT OnChangeVisualManager(
    WPARAM wParam,
    LPARAM lParam);

Parameterwaarden

wParam
[in] Deze parameter wordt niet gebruikt.

lParam
[in] Deze parameter wordt niet gebruikt.

Retourwaarde

Geeft altijd 0 terug.

Opmerkingen

CFrameWndEx::OnClose

In het framework wordt deze methode aangeroepen om het frame te sluiten.

afx_msg void OnClose();

Opmerkingen

Als het frame zich in de afdrukvoorbeeldmodus bevindt, wordt er een Windows-bericht verzonden om het afdrukvoorbeeld te sluiten; als het frame als host fungeert voor een OLE-client, wordt de client gedeactiveerd.

CFrameWndEx::OnCloseDockingPane

Aangeroepen door het framework wanneer de gebruiker op de knop Sluiten in een dockingvenster klikt.

virtual BOOL OnCloseDockingPane(CDockablePane* pPane);

Retourwaarde

TRUE als de dockingbalk kan worden gesloten. anders FALSE

Opmerkingen

De standaard geïmplementeerde implementatie doet niets. Overschrijf deze methode als u het verbergen van de dockingbalk wilt afhandelen.

CFrameWndEx::OnCloseMiniFrame

Aangeroepen door het framework wanneer de gebruiker op de knop Sluiten klikt in een zwevend miniframevenster.

virtual BOOL OnCloseMiniFrame(CPaneFrameWnd* pWnd);

Retourwaarde

TRUE als een zwevend miniframevenster kan worden gesloten. FALSE anders.

Opmerkingen

De standaard implementatie doet niets. Overschrijf deze methode als u het verbergen van een zwevend miniframevenster wilt verwerken.

CFrameWndEx::OnClosePopupMenu

Aangeroepen door het framework wanneer een actief snelmenu een WM_DESTROY bericht verwerkt.

virtual void OnClosePopupMenu(CMFCPopupMenu* pMenuPopup);

Parameterwaarden

pMenuPopup
Een aanwijzer naar een snelmenu.

Opmerkingen

Het framework verzendt een WM_DESTROY bericht wanneer het venster bijna wordt gesloten. Overschrijf deze methode als u meldingen wilt verwerken van objecten die deel uitmaken van CMFCPopupMenu het framevenster wanneer een CMFCPopupMenu object een WM_DESTROY bericht verwerkt dat door het framework wordt verzonden wanneer het venster wordt gesloten.

CFrameWndEx::OnCmdMsg

Verzendt opdrachtberichten.

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

Parameterwaarden

nID
[in] De opdracht-id.

nCode
[in] Opdrachtberichtcategorie.

pExtra
[in, uit] Aanwijzer naar een opdrachtobject.

pHandlerInfo
[in, uit] Wijs een opdrachthandlerstructuur aan.

Retourwaarde

TRUE als het opdrachtbericht is verwerkt; anders, FALSE.

Opmerkingen

CFrameWndEx::OnContextHelp

Aangeroepen door het framework om contextgerelateerde help weer te geven.

afx_msg void OnContextHelp();

Opmerkingen

CFrameWndEx::OnCreate

Aangeroepen door het framework nadat het frame is gemaakt.

afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);

Parameterwaarden

lpCreateStruct
[in] Een aanwijzer naar de CREATESTRUCT structuur voor het nieuwe frame.

Retourwaarde

0 om door te gaan met het maken van het frame; -1 om het frame te vernietigen.

Opmerkingen

CFrameWndEx::OnDestroy

Aangeroepen door het framework wanneer het frame wordt vernietigd.

afx_msg void OnDestroy();

Opmerkingen

De acceleratortabel en alle vensters worden vernietigd.

CFrameWndEx::OnDrawMenuImage

Aangeroepen door het framework wanneer de toepassing de afbeelding tekent die is gekoppeld aan een menu-item.

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

Parameterwaarden

pDC
[in] Een aanwijzer naar een apparaatcontext.

pMenuButton
[in] Een aanwijzer naar een menuknop waarvan de afbeelding wordt weergegeven.

rectImage
[in] Een aanwijzer naar een Rect structuur die de schermpositie en grootte van de afbeelding aangeeft.

Retourwaarde

TRUE als het framework de afbeelding correct weergeeft; FALSE Anders.

Opmerkingen

Overschrijf deze methode als u de weergave van de afbeelding wilt aanpassen voor de menu-items die deel uitmaken van de menubalk die eigendom is van het CFrameWndEx afgeleide object.

Aangeroepen door het framework wanneer een CMFCPopupMenu object een WM_PAINT bericht verwerkt.

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

Parameterwaarden

pDC
[in] Een aanwijzer naar een apparaatcontext.

pMenu
[in] Een aanwijzer naar het menu-item.

rectLogo
[in] Een verwijzing naar een constante CRect structuur die de schermpositie en grootte van het menulogo aangeeft.

Opmerkingen

Overschrijf deze functie als u een logo wilt weergeven in het snelmenu dat deel uitmaakt van de menubalk die eigendom is van het CFrameWndEx afgeleide object.

CFrameWndEx::OnDWMCompositionChanged

Aangeroepen door het framework wanneer de samenstelling van Desktop Window Manager (DWM) is ingeschakeld of uitgeschakeld.

afx_msg LRESULT OnDWMCompositionChanged(
    WPARAM wp,
    LPARAM lp);

Parameterwaarden

wp
[in] Deze parameter wordt niet gebruikt.

lp
[in] Deze parameter wordt niet gebruikt.

Retourwaarde

Geeft altijd 0 terug.

Opmerkingen

CFrameWndEx::OnExitSizeMove

Aangeroepen door het framework wanneer het frame stopt met verplaatsen of het formaat ervan wijzigen.

LRESULT OnExitSizeMove(
    WPARAM wp,
    LPARAM lp);

Parameterwaarden

wp
[in] Deze parameter wordt niet gebruikt.

lp
[in] Deze parameter wordt niet gebruikt.

Retourwaarde

Geeft altijd 0 terug.

Opmerkingen

CFrameWndEx::OnGetMinMaxInfo

Aangeroepen door het framework wanneer het frame wordt aangepast om limieten voor vensterdimensie in te stellen.

afx_msg void OnGetMinMaxInfo(MINMAXINFO FAR* lpMMI);

Parameterwaarden

lpMMI
[in] Wijs een MINMAXINFO structuur aan.

Opmerkingen

CFrameWndEx::OnIdleUpdateCmdUI

Wordt aangeroepen door het framework om de frameweergave bij te werken wanneer de opdrachtverwerking niet actief is.

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

Parameterwaarden

wParam
[in] Deze parameter wordt niet gebruikt.

lParam
[in] Deze parameter wordt niet gebruikt.

Retourwaarde

Geeft altijd 0 terug.

Opmerkingen

CFrameWndEx::OnLButtonDown

Dit framework roept deze methode aan wanneer de gebruiker op de linkermuisknop drukt.

afx_msg void OnLButtonDown(
    UINT nFlags,
    CPoint point);

Parameterwaarden

nFlags
[in] Geeft aan of de gebruiker op wijzigingstoetsen heeft gedrukt. Zie de parameter wParam in WM_LBUTTONDOWN Notification voor mogelijke waarden.

point
[in] Hiermee geeft u de x- en y-coördinaten van de aanwijzer, ten opzichte van de linkerbovenhoek van het venster.

Opmerkingen

CFrameWndEx::OnLButtonUp

In het framework wordt deze methode aangeroepen wanneer de gebruiker de linkermuisknop loslaat.

afx_msg void OnLButtonUp(
    UINT nFlags,
    CPoint point);

Parameterwaarden

nFlags
[in] Geeft aan of de gebruiker op wijzigingstoetsen heeft gedrukt. Zie de parameter wParam in WM_LBUTTONUP Notification voor mogelijke waarden.

point
[in] Hiermee geeft u de x- en y-coördinaten van de aanwijzer, ten opzichte van de linkerbovenhoek van het venster.

Opmerkingen

CFrameWndEx::OnMenuButtonToolHitTest

Aangeroepen door het framework wanneer een CMFCToolBarButton object een WM_NCHITTEST bericht verwerkt.

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

Parameterwaarden

pButton
[in] Een aanwijzer naar de knop met de werkbalk.

pTI
[uit] Een aanwijzer naar een informatiestructuur van een hulpmiddel.

Retourwaarde

TRUE als de toepassing de pTI parameter vult. FALSE anders.

Opmerkingen

Overschrijf deze methode als u knopinfo wilt opgeven over een specifiek menu-item.

CFrameWndEx::OnMenuChar

Aangeroepen door het framework wanneer een menu wordt weergegeven en de gebruiker op een toets drukt die niet overeenkomt met een opdracht.

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

Parameterwaarden

nChar
[in] Tekencode van de ingedrukte toets.

nFlags
[in] Bevat de MF_POPUP vlag als het weergegeven menu een submenu is; bevat de MF_SYSMENU vlag als het weergegeven menu een besturingselementmenu is.

pMenu
[in] Aanwijzer naar een menu.

Retourwaarde

Het woord met hoge volgorde moet een van de volgende waarden zijn.

Waarde Description
0 Het framework moet de toetsaanslag negeren.
1 Het framework moet het menu sluiten.
2 Het framework moet een van de items selecteren die in het menu worden weergegeven. Het woord met lage volgorde bevat de id van de opdracht die u wilt selecteren.

CFrameWndEx::OnMouseMove

Dit framework roept deze methode aan wanneer de aanwijzer wordt verplaatst.

afx_msg void OnMouseMove(
    UINT nFlags,
    CPoint point);

Parameterwaarden

nFlags
[in] Geeft aan of een gebruiker op wijzigingstoetsen heeft gedrukt. Zie de parameter wParam in WM_MOUSEMOVE Notification voor mogelijke waarden.

point
[in] Hiermee geeft u de x en y coördinaten van de aanwijzer ten opzichte van de linkerbovenhoek van het venster.

Opmerkingen

CFrameWndEx::OnMoveMiniFrame

Aangeroepen door het framework wanneer een deelvenstervenster wordt verplaatst.

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

Parameterwaarden

pFrame
[in] Aanwijzer naar het CPaneFrameWnd venster Klasvenster .

Retourwaarde

TRUE als het deelvenstervenster niet is gedokt; FALSE als het deelvenstervenster is gedokt.

Opmerkingen

CFrameWndEx::OnNcActivate

Aangeroepen door het framework wanneer het niet-clientgebied van het frame opnieuw moet worden getekend om een wijziging in de actieve status aan te geven.

afx_msg BOOL OnNcActivate(BOOL bActive);

Parameterwaarden

bActive
[in] TRUE om het frame actief te tekenen; FALSE om het frame inactief te tekenen.

Retourwaarde

Nonzero om door te gaan met standaardverwerking; 0 om te voorkomen dat het niet-clientgebied wordt gedeactiveerd.

Opmerkingen

CFrameWndEx::OnNcCalcSize

Aangeroepen door het framework wanneer de grootte en positie van het clientgebied moeten worden berekend.

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

Parameterwaarden

bCalcValidRects
[in] TRUE wanneer de toepassing een geldig clientgebied moet opgeven; anders, FALSE.

lpncsp
[in] Wijs een NCCALCSIZE_PARAMS structuur aan die framedimensiewijzigingen bevat.

Opmerkingen

CFrameWndEx::OnNcHitTest

Aangeroepen door het framework wanneer de aanwijzer wordt verplaatst of wanneer een muisknop wordt ingedrukt of losgelaten.

afx_msg LRESULT OnNcHitTest(CPoint point);

Parameterwaarden

point
[in] De locatie van de aanwijzer in schermcoördinaten.

Retourwaarde

Een aanwijzer heeft een opsommingswaarde bereikt. Zie Melding voor een lijst met mogelijke waardenWM_NCHITTEST.

Opmerkingen

CFrameWndEx::OnNcMouseMove

Aangeroepen door het framework wanneer de aanwijzer in een niet-clientgebied wordt verplaatst.

afx_msg void OnNcMouseMove(
    UINT nHitTest,
    CPoint point);

Parameterwaarden

nHitTest
[in] Een aanwijzer heeft een opsommingswaarde bereikt. Zie Melding voor een lijst met mogelijke waardenWM_NCHITTEST.

point
[in] De locatie van de aanwijzer in schermcoördinaten.

Opmerkingen

CFrameWndEx::OnNcPaint

Aangeroepen door het framework wanneer het niet-clientgebied moet worden geschilderd.

afx_msg void OnNcPaint();

Opmerkingen

CFrameWndEx::OnPaneCheck

Wordt aangeroepen door het framework om de zichtbaarheid van een deelvenster te beheren.

afx_msg BOOL OnPaneCheck(UINT nID);

Parameterwaarden

nID
[in] Besturingselement-id van een deelvenster.

Retourwaarde

TRUE als de opdracht is verwerkt; FALSE om door te gaan met de verwerking van opdrachten.

Opmerkingen

CFrameWndEx::OnPostPreviewFrame

Aangeroepen door het framework wanneer de gebruiker de afdrukvoorbeeldmodus wijzigt.

afx_msg LRESULT OnPostPreviewFrame(
    WPARAM wParam,
    LPARAM lParam);

Parameterwaarden

wParam
[in] Deze parameter wordt niet gebruikt.

lParam
[in] TRUE wanneer het frame zich in de afdrukvoorbeeldmodus bevindt; FALSE wanneer de afdrukvoorbeeldmodus is uitgeschakeld.

Retourwaarde

Geeft altijd 0 terug.

Opmerkingen

CFrameWndEx::OnPowerBroadcast

Wordt aangeroepen door het framework wanneer er een energiebeheer-gebeurtenis plaatsvindt.

afx_msg LRESULT OnPowerBroadcast(
    WPARAM wp,
    LPARAM lp);

Parameterwaarden

wp
[in] De energiebeheer-gebeurtenis. Zie Bericht voor een lijst met mogelijke waardenWM_POWERBROADCAST.

lp
[in] Deze parameter wordt niet gebruikt.

Retourwaarde

Resultaat van het aanroepen van de standaardvensterprocedure.

Opmerkingen

CFrameWndEx::OnSetMenu

Aangeroepen door het framework om het framevenstermenu te vervangen.

afx_msg LRESULT OnSetMenu(
    WPARAM wp,
    LPARAM lp);

BOOL OnSetMenu(HMENU hmenu);

Parameterwaarden

wp
[in] Greep naar het menu van het nieuwe framevenster.

lp
[in] Greep naar het nieuwe venstermenu.

hmenu
[in] Greep naar het menu van het nieuwe framevenster.

Retourwaarde

LRESULT is het resultaat van het aanroepen van de standaardvensterprocedure.

BOOL is TRUE als de gebeurtenis is verwerkt; anders. FALSE

Opmerkingen

CFrameWndEx::OnSetPreviewMode

Aangeroepen door het framework om de afdrukvoorbeeldmodus voor het frame in te stellen.

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

Parameterwaarden

bPreview
[in] TRUE afdrukvoorbeeld inschakelen; FALSE om het afdrukvoorbeeld uit te schakelen.

pState
[in] Aanwijzer naar een CPrintPreviewState framestatusstructuur.

Opmerkingen

CFrameWndEx::OnSetText

Aangeroepen door het framework om de tekst van een venster in te stellen.

afx_msg LRESULT OnSetText(
    WPARAM wParam,
    LPARAM lParam);

Parameterwaarden

wParam
[in] Deze parameter wordt niet gebruikt.

lParam
[in] Wijs de tekst voor het venster aan.

Retourwaarde

Retourwaarde van een aanroep naar DefWindowProc.

Opmerkingen

CFrameWndEx::OnShowCustomizePane

Aangeroepen door het framework wanneer een QuickCustomizePane.

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

Parameterwaarden

pMenuPane
[in] Een aanwijzer naar het deelvenster Snel aanpassen.

uiToolbarID
[in] De besturings-id van de werkbalk die moet worden aangepast.

Retourwaarde

Deze methode retourneert TRUEaltijd .

Opmerkingen

Het snelmenu aanpassen is een snelmenu dat wordt weergegeven wanneer u op de knop Aanpassen van de werkbalk klikt

CFrameWndEx::OnShowPanes

Aangeroepen door het framework om deelvensters weer te geven of te verbergen.

virtual BOOL OnShowPanes(BOOL bShow);

Parameterwaarden

bShow
[in] TRUE als de toepassing de deelvensters weergeeft; FALSE Anders.

Retourwaarde

Deze methode retourneert FALSEaltijd .

Opmerkingen

In de standaard implementatie worden de deelvensters weergegeven als bShow dat het is TRUE en of de deelvensters verborgen zijn of wanneer bShowFALSE en de deelvensters zichtbaar zijn.

De standaard implementatie verbergt de deelvensters zo ja bShowTRUE, en de deelvensters zijn zichtbaar of wanneer FALSEbShow en de deelvensters zijn verborgen.

Overschrijf deze methode in een afgeleide klasse om aangepaste code uit te voeren wanneer het framework deelvensters weergeeft of verbergt.

CFrameWndEx::OnShowPopupMenu

Aangeroepen door het framework wanneer er een pop-upmenu wordt weergegeven.

virtual BOOL OnShowPopupMenu(CMFCPopupMenu* pMenu);

Parameterwaarden

pMenu
[in] Een aanwijzer naar een snelmenu.

Retourwaarde

TRUE als het pop-upmenu zichtbaar is; anders FALSE.

Opmerkingen

Overschrijf deze methode in een afgeleide klasse om aangepaste code uit te voeren wanneer in het framework een snelmenu wordt weergegeven. Overschrijf deze methode bijvoorbeeld om de achtergrondkleur van de opdrachten in een snelmenu te wijzigen.

CFrameWndEx::OnSize

Aangeroepen door het framework nadat de grootte van het frame is gewijzigd.

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

Parameterwaarden

nType
[in] Het type formaat wijzigen. Zie de parameter wParam in WM_SIZE Notification voor mogelijke waarden.

cx
[in] Nieuwe breedte van het frame in pixels.

cy
[in] Nieuwe hoogte van het frame in pixels.

Opmerkingen

CFrameWndEx::OnSizing

Aangeroepen door het framework wanneer de gebruiker de grootte van het frame wijzigt.

afx_msg void OnSizing(
    UINT fwSide,
    LPRECT pRect);

Parameterwaarden

fwSide
[in] De rand van het frame dat wordt verplaatst. Zie de parameter wParam in WM_SIZING Notification.

pRect
[in, uit] Wijs een CRect of RECT structuur aan die de coördinaten van het frame bevat.

Opmerkingen

CFrameWndEx::OnSysColorChange

Aangeroepen door het framework wanneer de systeemkleuren veranderen.

void OnSysColorChange();

Opmerkingen

CFrameWndEx::OnTearOffMenu

Aangeroepen door het framework wanneer de toepassing een menu met een scheurbalk weergeeft.

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

Parameterwaarden

pMenuPopup
[in] Een aanwijzer naar een snelmenu.

pBar
[in] Een aanwijzer naar een scheurbalk.

Retourwaarde

TRUE als het snelmenu met de scheurbalk is ingeschakeld; anders FALSE.

Opmerkingen

Overschrijf deze methode in een afgeleide klasse om aangepaste code uit te voeren wanneer in het framework een besturingsbalk wordt weergegeven.

De standaard implementatie doet niets en retourneert TRUE.

CFrameWndEx::OnToolbarContextMenu

Wordt aangeroepen door het framework om een snelmenu voor de werkbalk te maken.

afx_msg LRESULT OnToolbarContextMenu(
    WPARAM wp,
    LPARAM lp);

Parameterwaarden

wp
[in] Deze parameter wordt niet gebruikt.

lp
[in] Deze parameter wordt niet gebruikt.

Retourwaarde

Geeft altijd 1 terug.

Opmerkingen

CFrameWndEx::OnToolbarCreateNew

In het framework wordt deze methode aangeroepen om een nieuwe werkbalk te maken.

afx_msg LRESULT OnToolbarCreateNew(
    WPARAM wp,
    LPARAM lp);

Parameterwaarden

wp
[in] Deze parameter wordt niet gebruikt.

lp
[in] Aanwijzer naar de tekst voor de titelbalk van de werkbalk.

Retourwaarde

Aanwijzer naar de nieuwe werkbalk; of NULL als er geen werkbalk is gemaakt.

Opmerkingen

CFrameWndEx::OnToolbarDelete

Aangeroepen door het framework wanneer een werkbalk wordt verwijderd.

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

Parameterwaarden

unused
[in] Deze parameter wordt niet gebruikt.

lp
[in] Aanwijzer naar een werkbalk.

Retourwaarde

TRUE als de werkbalk is verwijderd; anders, FALSE.

Opmerkingen

CFrameWndEx::OnUpdateFrameMenu

Aangeroepen door het framework om het framemenu in te stellen.

virtual void OnUpdateFrameMenu(HMENU hMenuAlt);

Parameterwaarden

hMenuAlt
[in] Greep naar het alternatieve menu.

Opmerkingen

CFrameWndEx::OnUpdateFrameTitle

Dit framework roept deze methode aan om de titelbalk van het framevenster bij te werken.

virtual void OnUpdateFrameTitle(BOOL bAddToTitle);

Parameterwaarden

bAddToTitle
[in] TRUE om de actieve documenttitel toe te voegen aan de titelbalk van het framevenster; anders FALSE.

Opmerkingen

CFrameWndEx::OnUpdatePaneMenu

Aangeroepen door het framework om het deelvenstermenu bij te werken.

afx_msg void OnUpdatePaneMenu(CCmdUI* pCmdUI);

Parameterwaarden

pCmdUI
[in] Aanwijzer naar het deelvenster van het gebruikersinterfaceobject.

Opmerkingen

CFrameWndEx::OnWindowPosChanged

Aangeroepen door het framework wanneer de framegrootte, positie of z-volgorde is gewijzigd vanwege een aanroep naar een vensterbeheermethode.

afx_msg void OnWindowPosChanged(WINDOWPOS FAR* lpwndpos);

Parameterwaarden

lpwndpos
[in] Wijs een WINDOWPOS structuur aan die de nieuwe grootte en positie bevat.

Opmerkingen

CFrameWndEx::PaneFromPoint

Hiermee wordt in elk deelvenster gezocht naar het opgegeven punt.

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

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

Parameterwaarden

point
[in] De schermcoördinaten van het punt dat moet worden gecontroleerd.

nSensitivity
[in] Vouw de begrenzingsrechthoek van elke besturingsbalk met deze hoeveelheid uit wanneer u naar een punt zoekt.

bExactBar
[in] TRUE om de nSensitivity parameter te negeren; anders. FALSE

pRTCBarType
[in] Als dat niet het probleem is NULL, doorzoekt de methode alleen de besturingsbalken van het opgegeven type.

dwAlignment
[uit] Als dit lukt, bevat deze parameter de zijkant van de besturingsbalk die zich het dichtst bij het opgegeven punt bevindt. Anders wordt deze parameter niet geïnitialiseerd.

Retourwaarde

Een aanwijzer naar een besturingsbalk met de point; NULL als er geen besturingselement wordt gevonden.

Opmerkingen

Met deze methode wordt in alle besturingsbalken in uw toepassing gezocht naar een point.

Gebruik nSensitivity dit om de grootte van het zoekgebied te vergroten. Gebruik pRTCBarType dit om de typen besturingsbalken te beperken die door de methode worden gezocht.

CFrameWndEx::PreTranslateMessage

Hiermee worden specifieke vensterberichten verwerkt voordat ze worden verzonden.

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parameterwaarden

pMsg
[in] Een aanwijzer naar een MSG structuur die het bericht bevat dat moet worden verwerkt.

Retourwaarde

Niet-nul als het bericht is verwerkt en niet moet worden verzonden; 0 als het bericht niet is verwerkt en moet worden verzonden.

Opmerkingen

CFrameWndEx::RecalcLayout

Hiermee past u de indeling van het frame en de onderliggende vensters aan.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parameterwaarden

bNotify
[in] Hiermee geeft u op of het OLE-clientitem moet worden geïnformeerd over de indelingswijziging.

Opmerkingen

Deze methode wordt aangeroepen wanneer de grootte van het framevenster is gewijzigd of wanneer besturingsbalken worden weergegeven of verborgen.

CFrameWndEx::RemovePaneFromDockManager

Hiermee maakt u de registratie van een deelvenster ongedaan en verwijdert u het uit de dockingmanager.

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

Parameterwaarden

pControlBar
[in] Een aanwijzer naar het deelvenster van de besturingsbalk die u wilt verwijderen.

bDestroy
[in] TRUE om de controlebalk te vernietigen nadat deze is verwijderd; FALSE Anders.

bAdjustLayout
[in] TRUE om de dockingindeling aan te passen; FALSE Anders.

bAutoHide
[in] TRUE als de besturingsbalk zich in de modus automatisch verbergen bevindt; FALSE Anders.

pBarReplacement
[in] Een aanwijzer naar een deelvenster dat het verwijderde deelvenster vervangt.

Opmerkingen

Gebruik deze methode om een besturingsbalk te verwijderen uit de dockingindeling van het framevenster.

De CDockingManager klasse verwerkt de indeling van besturingsbalken. U moet elke besturingsbalk registreren bij de dockingmanager met behulp van de CFrameWndEx::AddPane methode of de CFrameWndEx::InsertPane methode.

CFrameWndEx::SetDockState

Hiermee herstelt u de dockingindeling naar de dockingstatus die in het register is opgeslagen.

void SetDockState(const CDockState& state);

Parameterwaarden

state
De dockingstatus. Deze parameter wordt genegeerd.

CFrameWndEx::SetPrintPreviewFrame

Hiermee stelt u het venster afdrukvoorbeeldframe in.

void SetPrintPreviewFrame(CFrameWnd* pWnd);

Parameterwaarden

pWnd
[in] Aanwijzer naar een afdrukvoorbeeldvenster.

Opmerkingen

CFrameWndEx::SetupToolbarMenu

Hiermee voegt u door de gebruiker gedefinieerde opdrachten in een werkbalkmenu in.

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

Parameterwaarden

menu
[in] Een CMenu object dat moet worden gewijzigd.

uiViewUserToolbarCmdFirst
[in] De eerste door de gebruiker gedefinieerde opdracht.

uiViewUserToolbarCmdLast
[in] De laatste door de gebruiker gedefinieerde opdracht.

Opmerkingen

In het framework worden door de gebruiker gedefinieerde opdrachten opgeslagen in een lijst. Gebruik uiViewUserToolbarCmdFirst en uiViewUserToolbarCmdList geef de indexen op van de opdrachten die moeten worden ingevoegd.

CFrameWndEx::ShowFullScreen

Hiermee schakelt u het hoofdframe tussen de modus Volledig scherm en de normale modus.

void ShowFullScreen();

CFrameWndEx::ShowPane

Hiermee wordt het opgegeven deelvenster weergegeven of verborgen.

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

Parameterwaarden

pBar
[in] Een aanwijzer naar de besturingsbalk om weer te geven of te verbergen.

bShow
[in] Als TRUEde toepassing de besturingsbalk weergeeft. Anders verbergt de toepassing de besturingsbalk.

bDelay
[in] Als TRUE, vertraging van de aanpassing van de dockingindeling tot het framework aanroept CFrameWndEx::AdjustDockingLayout. Anders kunt u de dockingindeling onmiddellijk opnieuw berekenen.

bActivate
[in] Als TRUE, maakt u de besturingsbalk actief. Anders geeft u de besturingsbalk weer in een inactieve status.

CFrameWndEx::UpdateCaption

Wordt aangeroepen door het framework om het bijschrift van het vensterframe bij te werken.

void UpdateCaption();

Opmerkingen

CFrameWndEx::WinHelp

Roept de WinHelp-toepassing of contextgerelateerde Help aan.

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

Parameterwaarden

dwData
Gegevens die afhankelijk zijn van de nCmd parameter. Zie voor een lijst met mogelijke waarden WinHelp.

nCmd
De Help-opdracht. Zie voor een lijst met mogelijke waarden WinHelp.

Opmerkingen

Zie ook

Hiërarchiegrafiek
Klassen
CFrameWnd