Classe di CFrameWndEx

Articolo
03/05/2013

Implementa la funzionalità di interfaccia a documento singolo (SDI) di Windows è sovrapposto o finestra cornice popup e fornisce membri per gestire la finestra.Estende la classe CFrameWnd.

class CFrameWndEx : public CFrameWnd

Membri

Metodi pubblici

Nome	Descrizione
CFrameWndEx::ActiveItemRecalcLayout	Regola il layout dell'elemento client OLE e dell'area client di frame.
CFrameWndEx::AddDockSite	Questo metodo non viene utilizzato.
CFrameWndEx::AddPane	Registra una barra di controllo con l'amministratore di ancoraggio.
CFrameWndEx::AdjustDockingLayout	Ricalcola il layout dei riquadri che sono ancorati alla finestra cornice.
CFrameWndEx::DelayUpdateFrameMenu	Imposta il menu e quindi gli aggiornamenti del frame durante l'elaborazione di comando è inattiva.
CFrameWndEx::DockPane	Nuovamente il riquadro specificato alla finestra cornice.
CFrameWndEx::DockPaneLeftOf	Ancoraggio il riquadro a sinistra di un altro riquadro.
CFrameWndEx::EnableAutoHidePanes	Attiva la modalità nascondi automaticamente per i riquadri quando vengono ancorati ai lati indicati della finestra cornice principale.
CFrameWndEx::EnableDocking	Consente l'ancoraggio dei riquadri che appartengono alla finestra cornice.
CFrameWndEx::EnableFullScreenMainMenu	Mostra o nasconde il menu principale in una modalità schermo intero.
CFrameWndEx::EnableFullScreenMode	Attiva la modalità schermo intero per la finestra cornice.
CFrameWndEx::EnableLoadDockState	Abilita o disabilita il caricamento dello stato di ancoraggio.
CFrameWndEx::EnablePaneMenu	Abilita o disabilita la gestione automatica dei menu del riquadro.
CFrameWndEx::GetActivePopup	Restituisce un puntatore al menu di scelta rapida attualmente visualizzate.
CFrameWndEx::GetDefaultResId	Restituisce l'id della risorsa specificata quando il framework caricare la finestra cornice.
CFrameWndEx::GetDockingManager	Recupera l'oggetto Classe di CDockingManager per la finestra cornice.
CFrameWndEx::GetMenuBar	Restituisce un puntatore a un oggetto barra dei menu collegato alla finestra cornice.
CFrameWndEx::GetPane	Restituisce un puntatore al riquadro con l'id specificato
CFrameWndEx::GetRibbonBar	Recupera il controllo della barra multifunzione per il frame.
CFrameWndEx::GetTearOffBars	Restituisce un elenco di oggetti riquadro che si trovano nello stato di sradicamento.
CFrameWndEx::GetToolbarButtonToolTipText	Chiamato dal framework quando l'applicazione visualizza la descrizione comandi per un pulsante della barra degli strumenti.
CFrameWndEx::InsertPane	Registra un riquadro con l'amministratore di ancoraggio.
CFrameWndEx::IsFullScreen	Determina se la finestra cornice in modalità schermo intero.
CFrameWndEx::IsMenuBarAvailable	Determina se il puntatore all'oggetto barra dei menu è valido.
CFrameWndEx::IsPointNearDockSite	Indica se il punto si trova in una zona di allineamento.
CFrameWndEx::IsPrintPreview	Indica se la finestra cornice in modalità anteprima di stampa.
CFrameWndEx::LoadFrame	Questo metodo viene chiamato dopo la costruzione per creare la finestra cornice e per caricare le risorse.
CFrameWndEx::NegotiateBorderSpace	Negoziazione client del bordo di risorse OLE.
CFrameWndEx::OnActivate	Il framework chiama questo metodo quando l'input viene passato a o a partire dal frame.
CFrameWndEx::OnActivateApp	Chiamato dal framework quando l'applicazione viene selezionata o deselezionata.
CFrameWndEx::OnChangeVisualManager	Chiamato dal framework quando una modifica al frame richiede una modifica al gestore visualizzazione.
CFrameWndEx::OnClose	Il framework chiama questo metodo per chiudere il frame.
CFrameWndEx::OnCloseDockingPane	Chiamato dal framework quando l'utente fa clic sul pulsante Chiudi in un riquadro ancorato.
CFrameWndEx::OnCloseMiniFrame	Chiamato dal framework quando l'utente fa clic sul pulsante Chiudi su una mini finestra cornice mobile.
CFrameWndEx::OnClosePopupMenu	Chiamato dal framework quando un menu di scelta rapida attivo elabora un messaggio di WM_DESTROY.
CFrameWndEx::OnCmdMsg	Invia i messaggi di comando.
CFrameWndEx::OnContextHelp	Chiamato dal framework al contesto di visualizzazione è correlato la guida.
CFrameWndEx::OnCreate	Chiamato dal framework dopo il frame viene creato.
CFrameWndEx::OnDestroy	Chiamato dal framework quando il frame viene eliminato.
CFrameWndEx::OnDrawMenuImage	Chiamato dal framework quando l'applicazione consente di disegnare l'immagine associata a una voce di menu.
CFrameWndEx::OnDrawMenuLogo	Chiamato dal framework quando un oggetto CMFCPopupMenu elabora un messaggio WM_PAINT.
CFrameWndEx::OnDWMCompositionChanged	Chiamato dal framework quando la composizione di (DWM) di Gestione finestre desktop è stata abilitata o disabilitata.
CFrameWndEx::OnExitSizeMove	Chiamato dal framework quando il frame smette di spostare o ridimensionare.
CFrameWndEx::OnGetMinMaxInfo	Chiamato dal framework quando il frame viene ridimensionato per impostare i limiti di dimensioni della finestra.
CFrameWndEx::OnIdleUpdateCmdUI	Chiamato dal framework per aggiornare la visualizzazione del frame durante l'elaborazione di comando è inattiva.
CFrameWndEx::OnLButtonDown	Il framework chiama questo metodo quando viene premuto il pulsante sinistro del mouse.
CFrameWndEx::OnLButtonUp	Il framework chiama questo metodo quando l'utente rilascia il pulsante sinistro del mouse.
CFrameWndEx::OnMenuButtonToolHitTest	Chiamato dal framework quando un oggetto CMFCToolBarButton elabora un messaggio WM_NCHITTEST.
CFrameWndEx::OnMenuChar	Chiamato dal framework quando un menu visualizzati e dall'utente preme un tasto non corrisponde a un comando.
CFrameWndEx::OnMouseMove	Il framework chiama questo metodo quando il puntatore viene spostato.
CFrameWndEx::OnMoveMiniFrame	Chiamato dal framework quando una finestra del riquadro viene spostato.
CFrameWndEx::OnNcActivate	Chiamato dal framework quando l'area non client del frame ridisegnare per indicare una modifica nello stato attivo.
CFrameWndEx::OnNcCalcSize	Chiamato dal framework quando la dimensione e la posizione dell'area client devono essere calcolate.
CFrameWndEx::OnNcHitTest	Chiamato dal framework quando il puntatore viene spostato oppure quando si preme un pulsante del mouse o rilasciato.
CFrameWndEx::OnNcMouseMove	Chiamato dal framework quando il puntatore viene spostato in un'altra area non client.
CFrameWndEx::OnNcPaint	Chiamato dal framework quando l'area non client deve essere disegnato.
CFrameWndEx::OnPaneCheck	Chiamato dal framework per controllare la visibilità di un riquadro.
CFrameWndEx::OnPostPreviewFrame	Chiamato dal framework quando l'utente ha modificato la modalità anteprima di stampa.
CFrameWndEx::OnPowerBroadcast	Chiamato dal framework quando un evento di risparmio energia disponibili si verifica.
CFrameWndEx::OnSetMenu	Chiamato dal framework per sostituire il menu della finestra cornice.
CFrameWndEx::OnSetPreviewMode	Chiamato dal framework per impostare la modalità anteprima di stampa per il frame.
CFrameWndEx::OnSetText	Chiamato dal framework per impostare il testo di una finestra.
CFrameWndEx::OnShowCustomizePane	Chiamato dal framework quando un rapido personalizzare il riquadro è abilitato.
CFrameWndEx::OnShowPanes	Chiamato dal framework per visualizzare o nascondere i riquadri.
CFrameWndEx::OnShowPopupMenu	Chiamato dal framework quando un menu di scelta rapida viene abilitato.
CFrameWndEx::OnSize	Il framework chiama il metodo dopo le modifiche della dimensione del frame.
CFrameWndEx::OnSizing	Il framework chiama questo metodo quando l'utente ridimensiona il frame.
CFrameWndEx::OnSysColorChange	Chiamato dal framework quando la modifica di colori di sistema.
CFrameWndEx::OnTearOffMenu	Chiamato dal framework quando un menu con una barra di sradicamento è abilitato.
CFrameWndEx::OnToolbarContextMenu	Chiamato dal framework per compilare un menu di scelta rapida della barra degli strumenti.
CFrameWndEx::OnToolbarCreateNew	Il framework chiama questo metodo per creare una nuova barra degli strumenti.
CFrameWndEx::OnToolbarDelete	Chiamato dal framework quando una barra degli strumenti viene eliminato.
CFrameWndEx::OnUpdateFrameMenu	Chiamato dal framework per impostare il menu di frame.
CFrameWndEx::OnUpdateFrameTitle	Il framework chiama questo metodo per aggiornare la didascalia della finestra cornice.
CFrameWndEx::OnUpdatePaneMenu	Chiamato dal framework per aggiornare il menu del riquadro.
CFrameWndEx::OnWindowPosChanged	Chiamato dal framework quando la dimensione di frame, il percorso, o l'ordine z di modifica a causa di una chiamata a un metodo di gestione della finestra.
CFrameWndEx::PaneFromPoint	Restituisce il riquadro ancorato contenente il punto specificato.
CFrameWndEx::PreTranslateMessage	Messaggi specifici della finestra di handle prima che vengano inviati.
CFrameWndEx::RecalcLayout	Regola il layout del frame e le relative finestre figlio.
CFrameWndEx::RemovePaneFromDockManager	Annulla la registrazione di un riquadro e lo rimuove dall'interno dell'amministratore di ancoraggio.
CFrameWndEx::SetDockState	Ripristina il layout di ancoraggio lo stato di ancoraggio memorizzato nel Registro di sistema.
CFrameWndEx::SetPrintPreviewFrame	Imposta la finestra cornice anteprima di stampa.
CFrameWndEx::SetupToolbarMenu	Inserisce i controlli definiti dall'utente in un menu della barra degli strumenti.
CFrameWndEx::ShowFullScreen	Passa la cornice principale tra le modalità schermo intero e normali.
CFrameWndEx::ShowPane	Mostra o nasconde il riquadro specificato.
CFrameWndEx::UpdateCaption	Chiamato dal framework per aggiornare la didascalia della struttura della finestra.
CFrameWndEx::WinHelp	Richiamare l'applicazione WinHelp o la guida relativo contesto.

Esempio

Nell'esempio seguente viene illustrato come ereditare una classe dalla classe CFrameWndEx.Nell'esempio sono illustrate le firme del metodo nella sottoclasse e come eseguire l'override del metodo OnShowPopupMenu.Questo frammento di codice fa parte Esempio di cuscinetto di Word.

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

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

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

    void OnChangeLook ();

// Overrides
    // ClassWizard generated virtual function overrides
    //{{AFX_VIRTUAL(CMainFrame)
    public:
    virtual void ActivateFrame(int nCmdShow = -1);
    virtual BOOL LoadFrame(UINT nIDResource, DWORD dwDefaultStyle = WS_OVERLAPPEDWINDOW | FWS_ADDTOTITLE, CWnd* pParentWnd = NULL, CCreateContext* pContext = NULL);
    protected:
    virtual BOOL PreCreateWindow(CREATESTRUCT& cs);
    virtual BOOL OnCommand(WPARAM wParam, LPARAM lParam);
    //}}AFX_VIRTUAL

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

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

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

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

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

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


...


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

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

    return bRes;
}