Condividi tramite

Classe CFrameWndEx

  • Articolo

Implementa la funzionalità di un'interfaccia a documento singolo (SDI) di Windows sovrapposta o di una finestra cornice popup e fornisce i membri per gestire la finestra. Estende la CFrameWnd classe .

Sintassi

class CFrameWndEx : public CFrameWnd

Membri

Metodi pubblici

Nome Descrizione
CFrameWndEx::ActiveItemRecalcLayout Regola il layout dell'elemento client OLE e dell'area client del frame.
CFrameWndEx::AddDockSite Questo metodo non viene usato.
CFrameWndEx::AddPane Registra una barra di controllo con il gestore di ancoraggio.
CFrameWndEx::AdjustDockingLayout Ricalcola il layout di tutti i riquadri ancorati alla finestra cornice.
CFrameWndEx::DelayUpdateFrameMenu Imposta il menu cornice e quindi lo aggiorna quando l'elaborazione dei comandi è inattiva.
CFrameWndEx::DockPane Ancora il riquadro specificato alla finestra cornice.
CFrameWndEx::DockPaneLeftOf Ancora un riquadro a sinistra di un altro riquadro.
CFrameWndEx::EnableAutoHidePanes Abilita la modalità nascondi automaticamente per i riquadri quando vengono ancorati ai lati specificati della finestra cornice principale.
CFrameWndEx::EnableDocking Abilita l'ancoraggio dei riquadri che appartengono alla finestra cornice.
CFrameWndEx::EnableFullScreenMainMenu Mostra o nasconde il menu principale in modalità schermo intero.
CFrameWndEx::EnableFullScreenMode Abilita 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 del menu del riquadro.
CFrameWndEx::GetActivePopup Restituisce un puntatore al menu a comparsa attualmente visualizzato.
CFrameWndEx::GetDefaultResId Restituisce l'ID risorsa specificato quando il framework ha caricato la finestra cornice.
CFrameWndEx::GetDockingManager Recupera l'oggetto CDockingManager Class per la finestra cornice.
CFrameWndEx::GetMenuBar Restituisce un puntatore all'oggetto della barra dei menu collegato alla finestra cornice.
CFrameWndEx::GetPane Restituisce un puntatore al riquadro con l'ID specificato.
CFrameWndEx::GetRibbonBar Recupera il controllo barra multifunzione per il frame.
CFrameWndEx::GetTearOffBars Restituisce un elenco di oggetti del riquadro che si trovano in uno stato a comparsa.
CFrameWndEx::GetToolbarButtonToolTipText Chiamato dal framework quando l'applicazione visualizza la descrizione comando per un pulsante della barra degli strumenti.
CFrameWndEx::InsertPane Registra un riquadro con il gestore 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 caricarne le risorse.
CFrameWndEx::NegotiateBorderSpace Implementa la negoziazione del bordo del client OLE.
CFrameWndEx::OnActivate Il framework chiama questo metodo quando l'input dell'utente viene passato o lontano dal frame.
CFrameWndEx::OnActivateApp Chiamato dal framework quando l'applicazione è selezionata o deselezionata.
CFrameWndEx::OnChangeVisualManager Chiamato dal framework quando una modifica al frame richiede una modifica al gestore visivo.
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 di ancoraggio.
CFrameWndEx::OnCloseMiniFrame Chiamato dal framework quando l'utente fa clic sul pulsante Chiudi in una finestra di mini frame mobile.
CFrameWndEx::OnClosePopupMenu Chiamato dal framework quando un menu a comparsa attivo elabora un WM_DESTROY messaggio.
CFrameWndEx::OnCmdMsg Invia messaggi di comando.
CFrameWndEx::OnContextHelp Chiamato dal framework per visualizzare la Guida correlata al contesto.
CFrameWndEx::OnCreate Chiamato dal framework dopo la creazione del frame.
CFrameWndEx::OnDestroy Chiamato dal framework quando il frame viene eliminato definitivamente.
CFrameWndEx::OnDrawMenuImage Chiamato dal framework quando l'applicazione disegna l'immagine associata a una voce di menu.
CFrameWndEx::OnDrawMenuLogo Chiamato dal framework quando un CMFCPopupMenu oggetto elabora un WM_PAINT messaggio.
CFrameWndEx::OnDWMCompositionChanged Chiamato dal framework quando la composizione di Desktop Window Manager (DWM) è stata abilitata o disabilitata.
CFrameWndEx::OnExitSizeMove Chiamato dal framework quando il frame smette di spostarsi o ridimensionare.
CFrameWndEx::OnGetMinMaxInfo Chiamato dal framework quando il frame viene ridimensionato per impostare i limiti delle dimensioni della finestra.
CFrameWndEx::OnIdleUpdateCmdUI Chiamato dal framework per aggiornare la visualizzazione del frame quando l'elaborazione dei comandi è inattiva.
CFrameWndEx::OnLButtonDown Il framework chiama questo metodo quando l'utente preme 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 CMFCToolBarButton oggetto elabora un WM_NCHITTEST messaggio.
CFrameWndEx::OnMenuChar Chiamato dal framework quando viene visualizzato un menu e l'utente preme un tasto che non corrisponde a un comando.
CFrameWndEx::OnMouseMove Il framework chiama questo metodo quando si sposta il puntatore.
CFrameWndEx::OnMoveMiniFrame Chiamato dal framework quando si sposta una finestra del riquadro.
CFrameWndEx::OnNcActivate Chiamato dal framework quando l'area non client del frame deve essere ridisegnata per indicare una modifica nello stato attivo.
CFrameWndEx::OnNcCalcSize Chiamato dal framework quando è necessario calcolare le dimensioni e la posizione dell'area client.
CFrameWndEx::OnNcHitTest Chiamato dal framework quando il puntatore si sposta o quando viene premuto o rilasciato un pulsante del mouse.
CFrameWndEx::OnNcMouseMove Chiamato dal framework quando il puntatore si sposta in un'area non client.
CFrameWndEx::OnNcPaint Chiamato dal framework quando è necessario disegnare l'area non client.
CFrameWndEx::OnPaneCheck Chiamato dal framework per controllare la visibilità di un riquadro.
CFrameWndEx::OnPostPreviewFrame Chiamato dal framework quando l'utente ha modificato la modalità di anteprima di stampa.
CFrameWndEx::OnPowerBroadcast Chiamato dal framework quando si verifica un evento di risparmio energia.
CFrameWndEx::OnSetMenu Chiamato dal framework per sostituire il menu della finestra cornice.
CFrameWndEx::OnSetPreviewMode Chiamato dal framework per impostare la modalità di anteprima di stampa per il frame.
CFrameWndEx::OnSetText Chiamato dal framework per impostare il testo di una finestra.
CFrameWndEx::OnShowCustomizePane Chiamato dal framework quando è abilitato un riquadro di personalizzazione rapido.
CFrameWndEx::OnShowPanes Chiamato dal framework per visualizzare o nascondere i riquadri.
CFrameWndEx::OnShowPopupMenu Chiamato dal framework quando è abilitato un menu a comparsa.
CFrameWndEx::OnSize Il framework chiama questo metodo dopo la modifica delle dimensioni del frame.
CFrameWndEx::OnSizing Il framework chiama questo metodo quando l'utente ridimensiona il frame.
CFrameWndEx::OnSysColorChange Chiamato dal framework quando i colori di sistema cambiano.
CFrameWndEx::OnTearOffMenu Chiamato dal framework quando è abilitato un menu con una barra di disinstallazione.
CFrameWndEx::OnToolbarContextMenu Chiamato dal framework per creare 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 viene eliminata una barra degli strumenti.
CFrameWndEx::OnUpdateFrameMenu Chiamato dal framework per impostare il menu cornice.
CFrameWndEx::OnUpdateFrameTitle Il framework chiama questo metodo per aggiornare la barra del titolo della finestra cornice.
CFrameWndEx::OnUpdatePaneMenu Chiamato dal framework per aggiornare il menu del riquadro.
CFrameWndEx::OnWindowPosChanged Chiamato dal framework quando le dimensioni del frame, la posizione o l'ordine z sono cambiate a causa di una chiamata a un metodo di gestione delle finestre.
CFrameWndEx::PaneFromPoint Restituisce il riquadro di ancoraggio che contiene il punto specificato.
CFrameWndEx::PreTranslateMessage Gestisce messaggi di finestra specifici prima che vengano inviati.
CFrameWndEx::RecalcLayout Regola il layout della cornice e le relative finestre figlio.
CFrameWndEx::RemovePaneFromDockManager Annulla la registrazione di un riquadro e lo rimuove dall'elenco interno nel gestore di ancoraggio.
CFrameWndEx::SetDockState Ripristina lo stato di ancoraggio archiviato nel Registro di sistema.
CFrameWndEx::SetPrintPreviewFrame Imposta la finestra cornice di anteprima di stampa.
CFrameWndEx::SetupToolbarMenu Inserisce i comandi definiti dall'utente in un menu della barra degli strumenti.
CFrameWndEx::ShowFullScreen Passa il fotogramma principale tra lo schermo intero e le modalità normali.
CFrameWndEx::ShowPane Visualizza o nasconde il riquadro specificato.
CFrameWndEx::UpdateCaption Chiamato dal framework per aggiornare la didascalia della cornice della finestra.
CFrameWndEx::WinHelp Richiama l'applicazione o la WinHelp Guida correlata al contesto.

Esempio

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

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

Gerarchia di ereditarietà

CObject

CCmdTarget

CWnd

CFrameWnd

CFrameWndEx

Requisiti

Intestazione: afxframewndex.h

CFrameWndEx::ActiveItemRecalcLayout

Regola il layout dell'elemento client OLE e dell'area client del frame.

void ActiveItemRecalcLayout();

Osservazioni:

CFrameWndEx::AddPane

Registra una barra di controllo con il gestore di ancoraggio.

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

Parametri

pControlBar
[in] Riquadro della barra di controllo da registrare.

bTail
[in] TRUE se si desidera aggiungere il riquadro della barra di controllo alla fine dell'elenco; FALSE altrimenti.

Valore restituito

TRUE se la barra di controllo è stata registrata correttamente; FALSE altrimenti.

CFrameWndEx::AdjustDockingLayout

Ricalcola il layout di tutti i riquadri ancorati alla finestra cornice.

virtual void AdjustDockingLayout(HDWP hdwp=NULL);

Parametri

hdwp
Handle di una struttura che contiene le posizioni di più finestre. .

Osservazioni:

La struttura hdwp viene inizializzata dal BeginDeferWindowPos metodo .

CFrameWndEx::DelayUpdateFrameMenu

Imposta il menu cornice e quindi lo aggiorna quando l'elaborazione dei comandi è inattiva.

virtual void DelayUpdateFrameMenu(HMENU hMenuAlt);

Parametri

hMenuAlt
[in] Handle in un menu alternativo.

Osservazioni:

CFrameWndEx::DockPane

Ancora il riquadro specificato alla finestra cornice.

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

Parametri

pBar
[in] Puntatore alla barra di controllo da ancorare.

nDockBarID
[in] ID del lato della finestra cornice a cui ancorare.

lpRect
[in] Puntatore a una struttura costante Rect che specifica la posizione e le dimensioni dello schermo della finestra.

Osservazioni:

Il nDockBarID parametro può avere uno dei valori seguenti:

  • AFX_IDW_DOCKBAR_TOP

  • AFX_IDW_DOCKBAR_BOTTOM

  • AFX_IDW_DOCKBAR_LEFT

  • AFX_IDW_DOCKBAR_RIGHT

CFrameWndEx::DockPaneLeftOf

Ancora il riquadro specificato a sinistra di un altro riquadro.

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

Parametri

pBar
[in] Puntatore all'oggetto riquadro da ancorare.

pLeftOf
[in] Puntatore al riquadro a sinistra del quale ancorare il riquadro specificato da pBar.

Valore restituito

TRUE se pBar è ancorato correttamente. In caso contrario, FALSE.

Osservazioni:

Il metodo accetta la barra degli strumenti specificata dal pBar parametro e la ancora sul lato sinistro della barra degli strumenti specificata dal pLeftOf parametro .

CFrameWndEx::EnableAutoHidePanes

Abilita la modalità nascondi automaticamente per il riquadro quando è ancorata al lato specificato della finestra cornice principale.

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

Parametri

dwDockStyle
[in] Specifica il lato della finestra cornice principale a cui ancorare il riquadro.

Valore restituito

TRUE se un riquadro della barra è ancorato correttamente al lato della finestra cornice specificato da dwDockStyle, FALSE in caso contrario.

Osservazioni:

dwDockStyle può avere uno dei valori seguenti:

  • CBRS_ALIGN_TOP: consente di ancorare la barra di controllo all'inizio dell'area client di una finestra cornice.

  • CBRS_ALIGN_BOTTOM: consente di ancorare la barra di controllo nella parte inferiore dell'area client di una finestra cornice.

  • CBRS_ALIGN_LEFT: consente di ancorare la barra di controllo sul lato sinistro dell'area client di una finestra cornice.

  • CBRS_ALIGN_RIGHT: consente di ancorare la barra di controllo sul lato destro dell'area client di una finestra cornice.

CFrameWndEx::EnableDocking

Abilita l'ancoraggio dei riquadri della finestra cornice.

BOOL EnableDocking(DWORD dwDockStyle);

Parametri

dwDockStyle
[in] Specifica il lato della finestra cornice principale in cui la barra del riquadro è ancorata.

Valore restituito

TRUE se un riquadro della barra può essere ancorato correttamente sul lato specificato. In caso contrario, FALSE.

Osservazioni:

Il dwDockStyle parametro può avere uno dei valori seguenti:

  • CBRS_ALIGN_TOP

  • CBRS_ALIGN_BOTTOM

  • CBRS_ALIGN_LEFT

  • CBRS_ALIGN_RIGHT

CFrameWndEx::EnableFullScreenMainMenu

Mostra o nasconde il menu principale in modalità schermo intero.

void EnableFullScreenMainMenu(BOOL bEnableMenu);

Parametri

bEnableMenu
[in] TRUE per visualizzare il menu principale in modalità schermo intero, FALSE in caso contrario.

CFrameWndEx::EnableFullScreenMode

Abilita la modalità schermo intero per la finestra cornice.

void EnableFullScreenMode(UINT uiFullScreenCmd);

Parametri

uiFullScreenCmd
[in] ID di un comando che abilita e disabilita la modalità schermo intero.

Osservazioni:

Nella modalità schermo intero, tutte le barre dei controlli di ancoraggio, le barre degli strumenti e il menu sono nascosti e la visualizzazione attiva viene ridimensionata per occupare l'intero schermo.

Quando si abilita la modalità schermo intero, è necessario specificare un ID del comando che abilita o disabilita la modalità schermo intero. È possibile chiamare EnableFullScreenMode dalla funzione del OnCreate frame principale. Quando una finestra cornice passa a una modalità schermo intero, il framework crea una barra degli strumenti mobile con un pulsante con l'ID comando specificato.

Se si desidera mantenere il menu principale sullo schermo, chiamare CFrameWndEx::EnableFullScreenMainMenu.

CFrameWndEx::EnableLoadDockState

Abilita o disabilita il caricamento dello stato di ancoraggio.

void EnableLoadDockState(BOOL bEnable=TRUE);

Parametri

bEnable
[in] TRUE per abilitare il caricamento dello stato di ancoraggio, FALSE per disabilitare il caricamento dello stato di ancoraggio.

CFrameWndEx::EnablePaneMenu

Abilita o disabilita la gestione automatica del menu del riquadro.

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

Parametri

bEnable
[in] TRUE per abilitare la gestione automatica dei menu a comparsa della barra di controllo; FALSE per disabilitare la gestione automatica dei menu a comparsa della barra di controllo.

uiCustomizeCmd
[in] ID comando della voce di menu Personalizza .

strCustomizeLabel
[in] Etichetta da visualizzare per la voce di menu Personalizza

uiViewToolbarsMenuEntryID
[in] ID di una voce di menu della barra degli strumenti che apre il menu a comparsa nella barra dei controlli.

bContextMenuShowsToolbarsOnly
[in] Se TRUE, il menu di scelta rapida della barra dei controlli visualizza solo l'elenco delle barre degli strumenti. Se FALSE, il menu visualizza l'elenco delle barre degli strumenti e delle barre di ancoraggio.

bViewMenuShowsToolbarsOnly
[in] Se TRUE, il menu della barra dei controlli visualizza solo l'elenco delle barre degli strumenti. Se FALSE, il menu visualizza l'elenco delle barre degli strumenti e delle barre di ancoraggio.

CFrameWndEx::GetActivePopup

Restituisce un puntatore al menu a comparsa attualmente visualizzato.

CMFCPopupMenu* GetActivePopup() const;

Valore restituito

Puntatore al menu a comparsa attualmente visualizzato; in caso contrario NULL, .

CFrameWndEx::GetDefaultResId

Restituisce l'ID risorsa specificato quando il framework ha caricato la finestra cornice.

UINT GetDefaultResId() const;

Valore restituito

Valore dell'ID risorsa specificato dall'utente quando il framework ha caricato la finestra cornice. Zero se la finestra cornice non ha una barra dei menu.

CFrameWndEx::GetDockingManager

Recupera l'oggetto CDockingManager Class per la finestra cornice.

CDockingManager* GetDockingManager();

Valore restituito

Puntatore alla CDockingManager classe.

Osservazioni:

La finestra cornice crea e usa un oggetto Class per gestire l'ancoraggio CDockingManager della finestra figlio.

CFrameWndEx::GetMenuBar

Restituisce un puntatore all'oggetto della barra dei menu collegato alla finestra cornice.

const CMFCMenuBar* GetMenuBar() const;

Valore restituito

Puntatore all'oggetto barra dei menu collegato alla finestra cornice.

CFrameWndEx::GetPane

Restituisce un puntatore al riquadro con l'ID specificato.

CBasePane* GetPane(UINT nID);

Parametri

nID
[in] ID del controllo.

Valore restituito

Puntatore al riquadro con l'ID specificato. NULL se non esiste un riquadro di questo tipo.

CFrameWndEx::GetRibbonBar

Recupera il controllo barra multifunzione per il frame.

CMFCRibbonBar* GetRibbonBar();

Valore restituito

Puntatore alla CMFCRibbonBar classe per il frame.

Osservazioni:

CFrameWndEx::GetTearOffBars

Restituisce un elenco di oggetti del riquadro che si trovano in uno stato a comparsa.

const CObList& GetTearOffBars() const;

Valore restituito

Riferimento all'oggetto CObList che contiene una raccolta di puntatori agli oggetti riquadro che si trovano in uno stato di disattivazione.

CFrameWndEx::GetToolbarButtonToolTipText

Chiamato dal framework quando l'applicazione visualizza la descrizione comando per un pulsante della barra degli strumenti.

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

Parametri

pButton
[in] Puntatore a un pulsante della barra degli strumenti.

strTTText
[in] Testo della descrizione comando da visualizzare per il pulsante.

Valore restituito

TRUE se la descrizione comando è stata visualizzata. In caso contrario, FALSE.

Osservazioni:

Per impostazione predefinita, questo metodo non effettua alcuna operazione. Eseguire l'override di questo metodo se si desidera visualizzare la descrizione comando per il pulsante della barra degli strumenti.

CFrameWndEx::InsertPane

Inserisce un riquadro in un elenco di barre di controllo e lo registra con il gestore di ancoraggio.

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

Parametri

pControlBar
Puntatore a una barra di controllo da inserire nell'elenco di barre di controllo e registrare con il gestore di ancoraggio.

pTarget
Puntatore a una barra di controllo prima o dopo cui inserire il riquadro.

bAfter
TRUE se si desidera inserire pControlBar dopo pTarget, FALSE in caso contrario.

Valore restituito

TRUE se la barra di controllo è stata inserita e registrata correttamente, FALSE in caso contrario.

Osservazioni:

È necessario registrare ogni barra di controllo usando la CDockingManager classe per partecipare al layout di ancoraggio.

CFrameWndEx::IsFullScreen

Determina se la finestra cornice è in modalità schermo intero.

BOOL IsFullScreen() const;

Valore restituito

TRUE se la finestra cornice è in modalità schermo intero; in caso contrario FALSE, .

Osservazioni:

È possibile impostare la modalità schermo intero chiamando il CFrameWndEx::EnableFullScreenMode metodo .

CFrameWndEx::IsMenuBarAvailable

Determina se il puntatore all'oggetto barra dei menu è valido.

BOOL IsMenuBarAvailable() const;

Valore restituito

TRUE se la finestra cornice ha una barra dei menu; in caso contrario FALSE, .

CFrameWndEx::IsPointNearDockSite

Determina se il punto si trova in una zona di allineamento.

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

Parametri

point
[in] Posizione del punto.

dwBarAlignment
[out] Posizione in cui il punto è allineato. Per i valori possibili, vedere la tabella nella sezione Osservazioni.

bOuterEdge
[out] TRUE se il punto si trova vicino al bordo cornice; FALSE se il punto si trova in un'area client.

Valore restituito

TRUE se il punto si trova in una zona di allineamento; in caso contrario, FALSE.

Osservazioni:

Nella tabella seguente sono elencati i valori possibili per il dwBarAlignment parametro .

valore Descrizione
CBRS_ALIGN_TOP Allineato all'inizio.
CBRS_ALIGN_RIGHT Allineato a destra.
CBRS_ALIGN_BOTTOM Allineato alla parte inferiore.
CBRS_ALIGN_LEFT Allineato a sinistra.

CFrameWndEx::IsPrintPreview

Determina se la finestra cornice è in modalità anteprima di stampa.

BOOL IsPrintPreview();

Valore restituito

TRUE se la finestra cornice è in modalità anteprima di stampa; in caso contrario, FALSE.

Osservazioni:

CFrameWndEx::LoadFrame

Questo metodo viene chiamato dopo la costruzione per creare la finestra cornice e caricarne le risorse.

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

Parametri

nIDResource
[in] ID risorsa usato per caricare tutte le risorse frame.

dwDefaultStyle
[in] Stile della finestra cornice predefinito.

pParentWnd
[in] Puntatore alla finestra padre del frame.

pContext
[in] Puntatore a una CCreateContext classe Structure usata dal framework durante la creazione dell'applicazione.

Valore restituito

TRUE se il metodo riesce. In caso contrario, FALSE.

Osservazioni:

CFrameWndEx::NegotiateBorderSpace

Implementa la negoziazione del bordo del client OLE.

virtual BOOL NegotiateBorderSpace(
    UINT nBorderCmd,
    LPRECT lpRectBorder);

Parametri

nBorderCmd
[in] Comando di negoziazione del bordo. Per i valori possibili, vedere la sezione Osservazioni.

lpRectBorder
[in, out] Dimensioni del bordo.

Valore restituito

TRUE se il layout deve essere ricalcolato; in caso contrario, FALSE.

Osservazioni:

Nella tabella seguente sono elencati i valori possibili per il nBorderCmd parametro .

borderGet
Ottenere lo spazio client OLE disponibile.

borderRequest
Richiedere lo spazio client OLE.

borderSet
Impostare lo spazio client OLE.

CFrameWndEx::OnActivate

Il framework chiama questo metodo quando l'input dell'utente viene passato o lontano dal frame.

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

Parametri

nState
[in] Indica se il frame è attivo o inattivo. Per i valori possibili, vedere la tabella nella sezione Osservazioni.

pWndOther
[in] Puntatore a un'altra finestra che sta cambiando l'input dell'utente con quello corrente.

bMinimized
[in] Stato ridotto al minimo del frame. TRUE se la cornice è ridotta a icona; in caso contrario, FALSE.

Osservazioni:

Nella tabella seguente sono elencati i valori possibili per il nState parametro .

valore Descrizione
WA_ACTIVE La cornice viene selezionata da un metodo diverso da un clic del mouse.
WA_CLICKACTIVE La cornice viene selezionata con un clic del mouse.
WA_INACTIVE La cornice non è selezionata.

CFrameWndEx::OnActivateApp

Chiamato dal framework quando l'applicazione è selezionata o deselezionata.

afx_msg void OnActivateApp(
    BOOL bActive,
    DWORD dwThreadID);

Parametri

bActive
[in] TRUE se l'applicazione è selezionata; FALSE se l'applicazione non è selezionata.

dwThreadID
[in] Questo parametro non viene usato.

Osservazioni:

CFrameWndEx::OnChangeVisualManager

Chiamato dal framework quando una modifica al frame richiede una modifica al gestore visivo.

afx_msg LRESULT OnChangeVisualManager(
    WPARAM wParam,
    LPARAM lParam);

Parametri

wParam
[in] Questo parametro non viene usato.

lParam
[in] Questo parametro non viene usato.

Valore restituito

Restituisce sempre 0.

Osservazioni:

CFrameWndEx::OnClose

Il framework chiama questo metodo per chiudere il frame.

afx_msg void OnClose();

Osservazioni:

Se il frame è in modalità anteprima di stampa, invia un messaggio di Windows per chiudere l'anteprima di stampa; in caso contrario, se il frame ospita un client OLE, il client viene disattivato.

CFrameWndEx::OnCloseDockingPane

Chiamato dal framework quando l'utente fa clic sul pulsante Chiudi in un riquadro di ancoraggio.

virtual BOOL OnCloseDockingPane(CDockablePane* pPane);

Valore restituito

TRUE se la barra di ancoraggio può essere chiusa. In caso contrario, FALSE

Osservazioni:

L'implementazione predefinita non esegue alcuna operazione. Eseguire l'override di questo metodo se si desidera gestire il nascondiglio della barra di ancoraggio.

CFrameWndEx::OnCloseMiniFrame

Chiamato dal framework quando l'utente fa clic sul pulsante Chiudi in una finestra di mini frame mobile.

virtual BOOL OnCloseMiniFrame(CPaneFrameWnd* pWnd);

Valore restituito

TRUE se una finestra a mini frame mobile può essere chiusa. In caso contrario, FALSE.

Osservazioni:

L'implementazione predefinita non esegue alcuna operazione. Eseguire l'override di questo metodo se si desidera elaborare il nascondimento di una finestra con mini frame mobile.

CFrameWndEx::OnClosePopupMenu

Chiamato dal framework quando un menu a comparsa attivo elabora un WM_DESTROY messaggio.

virtual void OnClosePopupMenu(CMFCPopupMenu* pMenuPopup);

Parametri

pMenuPopup
Puntatore a un menu a comparsa.

Osservazioni:

Il framework invia un WM_DESTROY messaggio quando sta per chiudere la finestra. Eseguire l'override di questo metodo se si desidera gestire le notifiche da CMFCPopupMenu oggetti appartenenti alla finestra cornice quando un CMFCPopupMenu oggetto elabora un WM_DESTROY messaggio inviato dal framework quando la finestra viene chiusa.

CFrameWndEx::OnCmdMsg

Invia messaggi di comando.

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

Parametri

nID
[in] ID comando.

nCode
[in] Categoria di messaggi di comando.

pExtra
[in, out] Puntatore a un oggetto comando.

pHandlerInfo
[in, out] Puntatore a una struttura del gestore comandi.

Valore restituito

TRUE se il messaggio di comando è stato gestito; in caso contrario, FALSE.

Osservazioni:

CFrameWndEx::OnContextHelp

Chiamato dal framework per visualizzare la Guida correlata al contesto.

afx_msg void OnContextHelp();

Osservazioni:

CFrameWndEx::OnCreate

Chiamato dal framework dopo la creazione del frame.

afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);

Parametri

lpCreateStruct
[in] Puntatore alla CREATESTRUCT struttura per il nuovo frame.

Valore restituito

0 per continuare con la creazione del frame; -1 per distruggere il fotogramma.

Osservazioni:

CFrameWndEx::OnDestroy

Chiamato dal framework quando il frame viene eliminato definitivamente.

afx_msg void OnDestroy();

Osservazioni:

La tabella dell'acceleratore e tutte le finestre vengono eliminate definitivamente.

CFrameWndEx::OnDrawMenuImage

Chiamato dal framework quando l'applicazione disegna l'immagine associata a una voce di menu.

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

Parametri

pDC
[in] Puntatore a un contesto di dispositivo.

pMenuButton
[in] Puntatore a un pulsante di menu di cui viene eseguito il rendering dell'immagine.

rectImage
[in] Puntatore a una Rect struttura che specifica la posizione e le dimensioni dello schermo dell'immagine.

Valore restituito

TRUE se il framework esegue correttamente il rendering dell'immagine; FALSE altrimenti.

Osservazioni:

Eseguire l'override di questo metodo se si desidera personalizzare il rendering dell'immagine per le voci di menu appartenenti alla barra dei menu di proprietà dell'oggetto CFrameWndEx derivato.

Chiamato dal framework quando un CMFCPopupMenu oggetto elabora un WM_PAINT messaggio.

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

Parametri

pDC
[in] Puntatore a un contesto di dispositivo.

pMenu
[in] Puntatore alla voce di menu.

rectLogo
[in] Riferimento a una struttura costante CRect che specifica la posizione e le dimensioni dello schermo del logo del menu.

Osservazioni:

Eseguire l'override di questa funzione se si desidera visualizzare un logo nel menu a comparsa che appartiene alla barra dei menu di proprietà dell'oggetto CFrameWndEx derivato.

CFrameWndEx::OnDWMCompositionChanged

Chiamato dal framework quando la composizione di Desktop Window Manager (DWM) è stata abilitata o disabilitata.

afx_msg LRESULT OnDWMCompositionChanged(
    WPARAM wp,
    LPARAM lp);

Parametri

wp
[in] Questo parametro non viene usato.

lp
[in] Questo parametro non viene usato.

Valore restituito

Restituisce sempre 0.

Osservazioni:

CFrameWndEx::OnExitSizeMove

Chiamato dal framework quando il frame smette di spostarsi o ridimensionare.

LRESULT OnExitSizeMove(
    WPARAM wp,
    LPARAM lp);

Parametri

wp
[in] Questo parametro non viene usato.

lp
[in] Questo parametro non viene usato.

Valore restituito

Restituisce sempre 0.

Osservazioni:

CFrameWndEx::OnGetMinMaxInfo

Chiamato dal framework quando il frame viene ridimensionato per impostare i limiti delle dimensioni della finestra.

afx_msg void OnGetMinMaxInfo(MINMAXINFO FAR* lpMMI);

Parametri

lpMMI
[in] Puntatore a una MINMAXINFO struttura.

Osservazioni:

CFrameWndEx::OnIdleUpdateCmdUI

Chiamato dal framework per aggiornare la visualizzazione del frame quando l'elaborazione dei comandi è inattiva.

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

Parametri

wParam
[in] Questo parametro non viene usato.

lParam
[in] Questo parametro non viene usato.

Valore restituito

Restituisce sempre 0.

Osservazioni:

CFrameWndEx::OnLButtonDown

Il framework chiama questo metodo quando l'utente preme il pulsante sinistro del mouse.

afx_msg void OnLButtonDown(
    UINT nFlags,
    CPoint point);

Parametri

nFlags
[in] Indica se l'utente ha premuto i tasti di modifica. Per i valori possibili, vedere il parametro wParam in WM_LBUTTONDOWN Notifica.

point
[in] Specifica le coordinate x e y del puntatore, rispetto all'angolo superiore sinistro della finestra.

Osservazioni:

CFrameWndEx::OnLButtonUp

Il framework chiama questo metodo quando l'utente rilascia il pulsante sinistro del mouse.

afx_msg void OnLButtonUp(
    UINT nFlags,
    CPoint point);

Parametri

nFlags
[in] Indica se l'utente ha premuto i tasti di modifica. Per i valori possibili, vedere il parametro wParam in WM_LBUTTONUP Notifica.

point
[in] Specifica le coordinate x e y del puntatore, rispetto all'angolo superiore sinistro della finestra.

Osservazioni:

CFrameWndEx::OnMenuButtonToolHitTest

Chiamato dal framework quando un CMFCToolBarButton oggetto elabora un WM_NCHITTEST messaggio.

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

Parametri

pButton
[in] Puntatore al pulsante della barra degli strumenti.

pTI
[out] Puntatore a una struttura di informazioni sugli strumenti.

Valore restituito

TRUE se l'applicazione riempie il pTI parametro. In caso contrario, FALSE.

Osservazioni:

Eseguire l'override di questo metodo se si desidera fornire informazioni sulla descrizione comando relative a una voce di menu specifica.

CFrameWndEx::OnMenuChar

Chiamato dal framework quando viene visualizzato un menu e l'utente preme un tasto che non corrisponde a un comando.

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

Parametri

nChar
[in] Codice carattere del tasto premuto.

nFlags
[in] Contiene il MF_POPUP flag se il menu visualizzato è un sottomenu; contiene il MF_SYSMENU flag se il menu visualizzato è un menu di controllo.

pMenu
[in] Puntatore a un menu.

Valore restituito

La parola di ordine elevato deve essere uno dei valori seguenti.

valore Descrizione
0 Il framework deve ignorare la sequenza di tasti.
1 Il framework deve chiudere il menu.
2 Il framework deve selezionare una delle voci visualizzate nel menu. La parola con ordine basso contiene l'ID del comando da selezionare.

CFrameWndEx::OnMouseMove

Il framework chiama questo metodo quando si sposta il puntatore.

afx_msg void OnMouseMove(
    UINT nFlags,
    CPoint point);

Parametri

nFlags
[in] Indica se un utente ha premuto i tasti di modifica. Per i valori possibili, vedere il parametro wParam in WM_MOUSEMOVE Notifica.

point
[in] Specifica le x coordinate e y del puntatore rispetto all'angolo superiore sinistro della finestra.

Osservazioni:

CFrameWndEx::OnMoveMiniFrame

Chiamato dal framework quando si sposta una finestra del riquadro.

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

Parametri

pFrame
[in] Puntatore alla finestra del CPaneFrameWnd riquadro Classe .

Valore restituito

TRUE se la finestra del riquadro non è ancorata; FALSE se la finestra del riquadro è stata ancorata.

Osservazioni:

CFrameWndEx::OnNcActivate

Chiamato dal framework quando l'area non client del frame deve essere ridisegnata per indicare una modifica nello stato attivo.

afx_msg BOOL OnNcActivate(BOOL bActive);

Parametri

bActive
[in] TRUE per disegnare la cornice attiva; FALSE per disegnare la cornice inattiva.

Valore restituito

Diverso da zero per continuare con l'elaborazione predefinita; 0 per impedire la disattivazione dell'area non client.

Osservazioni:

CFrameWndEx::OnNcCalcSize

Chiamato dal framework quando è necessario calcolare le dimensioni e la posizione dell'area client.

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

Parametri

bCalcValidRects
[in] TRUE quando l'applicazione deve specificare un'area client valida; in caso contrario, FALSE.

lpncsp
[in] Puntatore a una NCCALCSIZE_PARAMS struttura che contiene modifiche alla dimensione cornice.

Osservazioni:

CFrameWndEx::OnNcHitTest

Chiamato dal framework quando il puntatore si sposta o quando viene premuto o rilasciato un pulsante del mouse.

afx_msg LRESULT OnNcHitTest(CPoint point);

Parametri

point
[in] Posizione del puntatore nelle coordinate dello schermo.

Valore restituito

Un puntatore ha raggiunto il valore enumerato. Per un elenco dei valori possibili, vedere WM_NCHITTEST Notifica.

Osservazioni:

CFrameWndEx::OnNcMouseMove

Chiamato dal framework quando il puntatore si sposta in un'area non client.

afx_msg void OnNcMouseMove(
    UINT nHitTest,
    CPoint point);

Parametri

nHitTest
[in] Un puntatore ha raggiunto il valore enumerato. Per un elenco dei valori possibili, vedere WM_NCHITTEST Notifica.

point
[in] Posizione del puntatore nelle coordinate dello schermo.

Osservazioni:

CFrameWndEx::OnNcPaint

Chiamato dal framework quando è necessario disegnare l'area non client.

afx_msg void OnNcPaint();

Osservazioni:

CFrameWndEx::OnPaneCheck

Chiamato dal framework per controllare la visibilità di un riquadro.

afx_msg BOOL OnPaneCheck(UINT nID);

Parametri

nID
[in] ID di controllo di un riquadro.

Valore restituito

TRUE se il comando è stato gestito; FALSE per continuare con l'elaborazione dei comandi.

Osservazioni:

CFrameWndEx::OnPostPreviewFrame

Chiamato dal framework quando l'utente modifica la modalità di anteprima di stampa.

afx_msg LRESULT OnPostPreviewFrame(
    WPARAM wParam,
    LPARAM lParam);

Parametri

wParam
[in] Questo parametro non viene usato.

lParam
[in] TRUE quando il frame è in modalità anteprima di stampa; FALSE quando la modalità anteprima di stampa è disattivata.

Valore restituito

Restituisce sempre 0.

Osservazioni:

CFrameWndEx::OnPowerBroadcast

Chiamato dal framework quando si verifica un evento di risparmio energia.

afx_msg LRESULT OnPowerBroadcast(
    WPARAM wp,
    LPARAM lp);

Parametri

wp
[in] Evento di risparmio energia. Per un elenco dei valori possibili, vedere WM_POWERBROADCAST Messaggio.

lp
[in] Questo parametro non viene usato.

Valore restituito

Risultato della chiamata alla routine della finestra predefinita.

Osservazioni:

CFrameWndEx::OnSetMenu

Chiamato dal framework per sostituire il menu della finestra cornice.

afx_msg LRESULT OnSetMenu(
    WPARAM wp,
    LPARAM lp);

BOOL OnSetMenu(HMENU hmenu);

Parametri

wp
[in] Handle nel menu della nuova finestra cornice.

lp
[in] Handle per il menu della nuova finestra.

hmenu
[in] Handle nel menu della nuova finestra cornice.

Valore restituito

LRESULT è il risultato della chiamata alla routine della finestra predefinita.

BOOL è TRUE se l'evento è stato gestito; in caso contrario, FALSE.

Osservazioni:

CFrameWndEx::OnSetPreviewMode

Chiamato dal framework per impostare la modalità di anteprima di stampa per il frame.

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

Parametri

bPreview
[in] TRUE per abilitare l'anteprima di stampa; FALSE per disabilitare l'anteprima di stampa.

pState
[in] Puntatore a una CPrintPreviewState struttura dello stato del frame.

Osservazioni:

CFrameWndEx::OnSetText

Chiamato dal framework per impostare il testo di una finestra.

afx_msg LRESULT OnSetText(
    WPARAM wParam,
    LPARAM lParam);

Parametri

wParam
[in] Questo parametro non viene usato.

lParam
[in] Puntatore al testo per la finestra.

Valore restituito

Valore restituito da una chiamata a DefWindowProc.

Osservazioni:

CFrameWndEx::OnShowCustomizePane

Chiamato dal framework quando visualizza un oggetto QuickCustomizePane.

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

Parametri

pMenuPane
[in] Puntatore al riquadro di personalizzazione rapida.

uiToolbarID
[in] ID del controllo della barra degli strumenti da personalizzare.

Valore restituito

Questo metodo restituisce sempre TRUE.

Osservazioni:

Il menu di personalizzazione rapida è un menu a comparsa visualizzato quando si fa clic sul pulsante personalizza della barra degli strumenti

CFrameWndEx::OnShowPanes

Chiamato dal framework per visualizzare o nascondere i riquadri.

virtual BOOL OnShowPanes(BOOL bShow);

Parametri

bShow
[in] TRUE se l'applicazione mostra i riquadri; FALSE altrimenti.

Valore restituito

Questo metodo restituisce sempre FALSE.

Osservazioni:

L'implementazione predefinita mostra i riquadri se bShow è TRUE e i riquadri sono nascosti o quando bShow è FALSE e i riquadri sono visibili.

L'implementazione predefinita nasconde i riquadri se bShow è TRUE e i riquadri sono visibili o quando bShow è FALSE e i riquadri sono nascosti.

Eseguire l'override di questo metodo in una classe derivata per eseguire codice personalizzato quando il framework visualizza o nasconde i riquadri.

CFrameWndEx::OnShowPopupMenu

Chiamato dal framework quando visualizza un menu a comparsa.

virtual BOOL OnShowPopupMenu(CMFCPopupMenu* pMenu);

Parametri

pMenu
[in] Puntatore a un menu a comparsa.

Valore restituito

TRUE se il menu a comparsa è visibile; in caso contrario FALSE, .

Osservazioni:

Eseguire l'override di questo metodo in una classe derivata per eseguire codice personalizzato quando il framework visualizza un menu a comparsa. Ad esempio, eseguire l'override di questo metodo per modificare il colore di sfondo dei comandi in un menu a comparsa.

CFrameWndEx::OnSize

Chiamato dal framework dopo la modifica delle dimensioni del frame.

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

Parametri

nType
[in] Tipo di ridimensionamento. Per i valori possibili, vedere il parametro wParam in WM_SIZE Notification.

cx
[in] Nuova larghezza del frame in pixel.

cy
[in] Nuova altezza del fotogramma in pixel.

Osservazioni:

CFrameWndEx::OnSizing

Chiamato dal framework quando l'utente ridimensiona il frame.

afx_msg void OnSizing(
    UINT fwSide,
    LPRECT pRect);

Parametri

fwSide
[in] Bordo della cornice spostata. Vedere il parametro wParam in WM_SIZING Notifica.

pRect
[in, out] Puntatore a una CRect struttura o RECT che contiene le coordinate del frame.

Osservazioni:

CFrameWndEx::OnSysColorChange

Chiamato dal framework quando i colori di sistema cambiano.

void OnSysColorChange();

Osservazioni:

CFrameWndEx::OnTearOffMenu

Chiamato dal framework quando l'applicazione visualizza un menu con una barra di disinstallazione.

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

Parametri

pMenuPopup
[in] Puntatore a un menu a comparsa.

pBar
[in] Puntatore a una barra di disinstallazione.

Valore restituito

TRUE se il menu a comparsa con la barra di disinstallazione è abilitato; in caso contrario FALSE, .

Osservazioni:

Eseguire l'override di questo metodo in una classe derivata per eseguire codice personalizzato quando il framework visualizza una barra di controllo.

L'implementazione predefinita non esegue alcuna operazione e restituisce TRUE.

CFrameWndEx::OnToolbarContextMenu

Chiamato dal framework per creare un menu a comparsa della barra degli strumenti.

afx_msg LRESULT OnToolbarContextMenu(
    WPARAM wp,
    LPARAM lp);

Parametri

wp
[in] Questo parametro non viene usato.

lp
[in] Questo parametro non viene usato.

Valore restituito

Restituisce sempre 1.

Osservazioni:

CFrameWndEx::OnToolbarCreateNew

Il framework chiama questo metodo per creare una nuova barra degli strumenti.

afx_msg LRESULT OnToolbarCreateNew(
    WPARAM wp,
    LPARAM lp);

Parametri

wp
[in] Questo parametro non viene usato.

lp
[in] Puntatore al testo per la barra del titolo della barra degli strumenti.

Valore restituito

Puntatore alla nuova barra degli strumenti; o NULL se non è stata creata una barra degli strumenti.

Osservazioni:

CFrameWndEx::OnToolbarDelete

Chiamato dal framework quando viene eliminata una barra degli strumenti.

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

Parametri

unused
[in] Questo parametro non viene usato.

lp
[in] Puntatore a una barra degli strumenti.

Valore restituito

TRUE se la barra degli strumenti è stata eliminata; in caso contrario, FALSE.

Osservazioni:

CFrameWndEx::OnUpdateFrameMenu

Chiamato dal framework per impostare il menu cornice.

virtual void OnUpdateFrameMenu(HMENU hMenuAlt);

Parametri

hMenuAlt
[in] Gestire il menu alternativo.

Osservazioni:

CFrameWndEx::OnUpdateFrameTitle

Il framework chiama questo metodo per aggiornare la barra del titolo della finestra cornice.

virtual void OnUpdateFrameTitle(BOOL bAddToTitle);

Parametri

bAddToTitle
[in] TRUE per aggiungere il titolo del documento attivo alla barra del titolo della finestra cornice; in caso contrario FALSE, .

Osservazioni:

CFrameWndEx::OnUpdatePaneMenu

Chiamato dal framework per aggiornare il menu del riquadro.

afx_msg void OnUpdatePaneMenu(CCmdUI* pCmdUI);

Parametri

pCmdUI
[in] Puntatore all'oggetto interfaccia utente del riquadro.

Osservazioni:

CFrameWndEx::OnWindowPosChanged

Chiamato dal framework quando le dimensioni del frame, la posizione o l'ordine z sono cambiate a causa di una chiamata a un metodo di gestione delle finestre.

afx_msg void OnWindowPosChanged(WINDOWPOS FAR* lpwndpos);

Parametri

lpwndpos
[in] Puntatore a una WINDOWPOS struttura che contiene le nuove dimensioni e la nuova posizione.

Osservazioni:

CFrameWndEx::PaneFromPoint

Cerca in ogni riquadro il punto specificato.

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

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

Parametri

point
[in] Coordinate dello schermo del punto da controllare.

nSensitivity
[in] Espandere il rettangolo di delimitazione di ogni barra di controllo in base a questo importo durante la ricerca del punto.

bExactBar
[in] TRUE per ignorare il nSensitivity parametro; in caso contrario, FALSE.

pRTCBarType
[in] Se non NULLè , il metodo cerca solo le barre di controllo del tipo specificato.

dwAlignment
[out] In caso di esito positivo, questo parametro contiene il lato della barra di controllo più vicina al punto specificato. In caso contrario, questo parametro non viene inizializzato.

Valore restituito

Puntatore a una barra di controllo contenente ; pointNULL se non viene trovato alcun controllo.

Osservazioni:

Questo metodo cerca in tutte le barre di controllo nell'applicazione una pointclasse .

Usare nSensitivity per aumentare le dimensioni dell'area di ricerca. Utilizzare pRTCBarType per limitare i tipi di barre di controllo cercate dal metodo .

CFrameWndEx::PreTranslateMessage

Gestisce messaggi di finestra specifici prima che vengano inviati.

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parametri

pMsg
[in] Puntatore a una MSG struttura che contiene il messaggio da elaborare.

Valore restituito

Diverso da zero se il messaggio è stato gestito e non deve essere inviato; 0 se il messaggio non è stato gestito e deve essere inviato.

Osservazioni:

CFrameWndEx::RecalcLayout

Regola il layout della cornice e le relative finestre figlio.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parametri

bNotify
[in] Specifica se inviare una notifica all'elemento client OLE sulla modifica del layout.

Osservazioni:

Questo metodo viene chiamato quando le dimensioni della finestra cornice sono cambiate o quando vengono visualizzate o nascoste le barre di controllo.

CFrameWndEx::RemovePaneFromDockManager

Annulla la registrazione di un riquadro e lo rimuove dal gestore di ancoraggio.

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

Parametri

pControlBar
[in] Puntatore al riquadro della barra di controllo da rimuovere.

bDestroy
[in] TRUE per distruggere la barra di controllo dopo averlo rimosso; FALSE altrimenti.

bAdjustLayout
[in] TRUE per regolare il layout di ancoraggio; FALSE altrimenti.

bAutoHide
[in] TRUE se la barra di controllo è in modalità nascondi automaticamente; FALSE altrimenti.

pBarReplacement
[in] Puntatore a un riquadro che sostituisce il riquadro rimosso.

Osservazioni:

Utilizzare questo metodo per rimuovere una barra di controllo dal layout di ancoraggio della finestra cornice.

La CDockingManager classe gestisce il layout delle barre di controllo. È necessario registrare ogni barra di controllo con il gestore di ancoraggio usando il CFrameWndEx::AddPane metodo o il CFrameWndEx::InsertPane metodo .

CFrameWndEx::SetDockState

Ripristina lo stato di ancoraggio archiviato nel Registro di sistema.

void SetDockState(const CDockState& state);

Parametri

state
Stato di ancoraggio. Questo parametro viene ignorato.

CFrameWndEx::SetPrintPreviewFrame

Imposta la finestra cornice di anteprima di stampa.

void SetPrintPreviewFrame(CFrameWnd* pWnd);

Parametri

pWnd
[in] Puntatore a una finestra cornice di anteprima di stampa.

Osservazioni:

CFrameWndEx::SetupToolbarMenu

Inserisce i comandi definiti dall'utente in un menu della barra degli strumenti.

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

Parametri

menu
[in] Oggetto CMenu da modificare.

uiViewUserToolbarCmdFirst
[in] Primo comando definito dall'utente.

uiViewUserToolbarCmdLast
[in] Ultimo comando definito dall'utente.

Osservazioni:

Il framework archivia i comandi definiti dall'utente in un elenco. Utilizzare uiViewUserToolbarCmdFirst e uiViewUserToolbarCmdList per specificare gli indici dei comandi da inserire.

CFrameWndEx::ShowFullScreen

Passa il fotogramma principale tra la modalità schermo intero e la modalità normale.

void ShowFullScreen();

CFrameWndEx::ShowPane

Visualizza o nasconde il riquadro specificato.

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

Parametri

pBar
[in] Puntatore alla barra di controllo da visualizzare o nascondere.

bShow
[in] Se TRUE, l'applicazione visualizza la barra di controllo. In caso contrario, l'applicazione nasconde la barra di controllo.

bDelay
[in] Se TRUE, ritardare la regolazione del layout di ancoraggio fino a quando il framework non chiama CFrameWndEx::AdjustDockingLayout. In caso contrario, ricalcolare immediatamente il layout di ancoraggio.

bActivate
[in] Se TRUE, rendere attiva la barra di controllo. In caso contrario, visualizzare la barra di controllo in uno stato inattivo.

CFrameWndEx::UpdateCaption

Chiamato dal framework per aggiornare la didascalia della cornice della finestra.

void UpdateCaption();

Osservazioni:

CFrameWndEx::WinHelp

Richiama l'applicazione WinHelp o la Guida correlata al contesto.

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

Parametri

dwData
Dati che dipendono dal nCmd parametro . Per un elenco dei valori possibili, vedere WinHelp.

nCmd
Comando della Guida. Per un elenco dei valori possibili, vedere WinHelp.

Osservazioni:

Vedi anche

Grafico della gerarchia
Classi
CFrameWnd