Класс CFrameWndEx

Статья
06/10/2015

Реализует функциональность фреймового окна интерфейса одинарного документа Windows (SDI) или перекрывающихся контекстного меню и предоставляет члены для управления окна. Он расширяет класс CFrameWnd.

class CFrameWndEx : public CFrameWnd

Члены

Открытые методы

Имя	Описание
CFrameWndEx::ActiveItemRecalcLayout	Обрабатывает структуру элемента клиента OLE и клиентской области фреймов.
CFrameWndEx::AddDockSite	Этот метод не используется.
CFrameWndEx::AddPane	Регистрирует область элементов управления с диспетчером закрепления.
CFrameWndEx::AdjustDockingLayout	Повторно вычисляет макет всех панелей, закреплены к фреймовому окно.
CFrameWndEx::DelayUpdateFrameMenu	Устанавливает меню, а затем обновления кадра его при обработке команды бездействует.
CFrameWndEx::DockPane	Закрепит указанная область в фреймовому окно.
CFrameWndEx::DockPaneLeftOf	Закрепления одна область слева от другой области.
CFrameWndEx::EnableAutoHidePanes	Включает режим автоматического скрытия для панелей, когда они закреплены с указанным сторонам главного фреймового окна.
CFrameWndEx::EnableDocking	Включает закрепления панелей, принадлежащих фреймовому окно.
CFrameWndEx::EnableFullScreenMainMenu	Отображать или скрывать главное меню в режиме " во весь экран.
CFrameWndEx::EnableFullScreenMode	Включает полноэкранный режим, фреймового окна.
CFrameWndEx::EnableLoadDockState	Включение или отключение загрузки состояния закрепления.
CFrameWndEx::EnablePaneMenu	Позволяет включить или отключить автоматическую обработку меню панели.
CFrameWndEx::GetActivePopup	Возвращает указатель на текущий момент, показанному всплывающему меню.
CFrameWndEx::GetDefaultResId	Возвращает идентификатор ресурса, который был указан при нагрузили фреймовое окно границы.
CFrameWndEx::GetDockingManager	Извлекает объект Класс CDockingManager для фреймового окна.
CFrameWndEx::GetMenuBar	Возвращает указатель на вложенный объект строки меню в фреймовому окно.
CFrameWndEx::GetPane	Возвращает указатель на панели, имеющего указанный идентификатор.
CFrameWndEx::GetRibbonBar	Извлекает элемент управления ленты для кадра.
CFrameWndEx::GetTearOffBars	Возвращает список объектов области, в перемещаемом состоянии.
CFrameWndEx::GetToolbarButtonToolTipText	Вызываемый платформой, когда приложение отображает подсказки для кнопки панели инструментов.
CFrameWndEx::InsertPane	Регистрирует область с диспетчером закрепления.
CFrameWndEx::IsFullScreen	Определяет, является ли фреймовое окно находится в режиме " во весь экран.
CFrameWndEx::IsMenuBarAvailable	Определяет, находится ли указатель на объект строки меню является допустимым.
CFrameWndEx::IsPointNearDockSite	Указывает, найдено ли точка в зоне выравнивания.
CFrameWndEx::IsPrintPreview	Указывает, является ли фреймовое окно находится в режиме предварительного просмотра.
CFrameWndEx::LoadFrame	Этот метод вызывается после проектирования для создания фреймовое окно и загрузить его ресурсам.
CFrameWndEx::NegotiateBorderSpace	Согласование клиентских инструментов " границы OLE.
CFrameWndEx::OnActivate	Платформа вызывает этот метод, когда входные данные пользователя переключается на или с кадром.
CFrameWndEx::OnActivateApp	Вызываемый платформой, когда будет выделен или невыбранное или приложение.
CFrameWndEx::OnChangeVisualManager	Вызываемый платформой, если изменение потребует изменения к кадру диспетчеру визуального представления.
CFrameWndEx::OnClose	Границы вызывают этот метод, чтобы закрыть кадр.
CFrameWndEx::OnCloseDockingPane	Вызываемый платформой, когда пользователь нажимает кнопку Закрыть на панели закрепления.
CFrameWndEx::OnCloseMiniFrame	Вызываемый платформой, когда пользователь нажимает кнопку Закрыть на фреймовом окне плавающей запятой миниом.
CFrameWndEx::OnClosePopupMenu	Вызываемый платформой, когда контекстное меню меню активного отображает сообщение WM_DESTROY.
CFrameWndEx::OnCmdMsg	Сообщения команды диспетчеров.
CFrameWndEx::OnContextHelp	Связанные с платформой для отображения контекста справки.
CFrameWndEx::OnCreate	Вызываемый средой после кадра создать.
CFrameWndEx::OnDestroy	Вызываемый платформой, когда фрейм будет уничтожен.
CFrameWndEx::OnDrawMenuImage	Вызываемый платформой, когда приложение строит образ, связанный с пунктом меню.
CFrameWndEx::OnDrawMenuLogo	Вызываемый платформой, когда объект CMFCPopupMenu отображает сообщение WM_PAINT.
CFrameWndEx::OnDWMCompositionChanged	Вызываемый платформой, когда была включена или отключена композиция диспетчер окон рабочего стола (диспетчер окон рабочего стола).
CFrameWndEx::OnExitSizeMove	Вызываемый платформой, когда фрейм останавливает перемещение или изменение размера.
CFrameWndEx::OnGetMinMaxInfo	Вызываемый платформой, когда фрейм будет размер для задания ограничения размеры окна.
CFrameWndEx::OnIdleUpdateCmdUI	Вызываемый платформой, чтобы обновить отображение кадра при обработке команды бездействует.
CFrameWndEx::OnLButtonDown	Платформа вызывает этот метод, когда пользователь нажимает нажатие левой кнопки мыши.
CFrameWndEx::OnLButtonUp	Платформа вызывает этот метод, когда пользователь освобождает нажатие левой кнопки мыши.
CFrameWndEx::OnMenuButtonToolHitTest	Вызываемый платформой, когда объект CMFCToolBarButton отображает сообщение WM_NCHITTEST.
CFrameWndEx::OnMenuChar	Вызываемый платформой, когда меню отображается, и пользователь нажимает ключ, который не соответствует команде.
CFrameWndEx::OnMouseMove	Платформа вызывает этот метод, когда указатель перемещается.
CFrameWndEx::OnMoveMiniFrame	Если окно панель с границами.
CFrameWndEx::OnNcActivate	Вызываемый платформой, когда область кадра, отличного от клиента должен перерисовать, чтобы показать изменения в активном состоянии.
CFrameWndEx::OnNcCalcSize	Вызываемый платформой, когда размер и положение клиентской области необходимо вычислить.
CFrameWndEx::OnNcHitTest	Вызываемый платформой, когда указатель перемещается или когда нажата кнопка мыши или освобождено.
CFrameWndEx::OnNcMouseMove	Вызываемый платформой, когда указатель перемещается в области клиента, не являющегося.
CFrameWndEx::OnNcPaint	Вызываемый платформой, когда область клиента, не являющегося необходимости рисования.
CFrameWndEx::OnPaneCheck	Вызываемый платформой для контроля видимости области.
CFrameWndEx::OnPostPreviewFrame	Вызываемый платформой, когда пользователь изменяет режим предварительного просмотра.
CFrameWndEx::OnPowerBroadcast	Вызываемый платформой, когда событие управления питанием.
CFrameWndEx::OnSetMenu	Вызываемый платформой, чтобы заменить меню фреймового окна.
CFrameWndEx::OnSetPreviewMode	Вызываемый платформой, чтобы установить режим предварительного просмотра для кадра.
CFrameWndEx::OnSetText	Вызываемый платформой для задания текста окна.
CFrameWndEx::OnShowCustomizePane	Вызываемый платформой, когда быстрая настраивает панель включена.
CFrameWndEx::OnShowPanes	Вызываемый платформой, чтобы показать или скрыть панель.
CFrameWndEx::OnShowPopupMenu	Вызываемый платформой, когда контекстное меню меню будет включена.
CFrameWndEx::OnSize	Платформа вызывает этот метод после изменения размера кадра.
CFrameWndEx::OnSizing	Платформа вызывает этот метод, когда пользователь изменяет размер кадр.
CFrameWndEx::OnSysColorChange	Вызывается инфраструктурой при изменении системных цветов.
CFrameWndEx::OnTearOffMenu	Вызываемый платформой, когда меню, имеющее перемещаемую панель включено.
CFrameWndEx::OnToolbarContextMenu	Вызываемый платформой для построения контекстное меню панели инструментов.
CFrameWndEx::OnToolbarCreateNew	Границы вызывают этот метод для создания новой панели инструментов.
CFrameWndEx::OnToolbarDelete	Если панель инструментов с платформой будет удаляется.
CFrameWndEx::OnUpdateFrameMenu	Вызываемый платформой для задания меню кадра.
CFrameWndEx::OnUpdateFrameTitle	Границы вызывают этот метод для обновления заголовок окна фреймового окна.
CFrameWndEx::OnUpdatePaneMenu	Вызываемый платформой для обновления панели меню.
CFrameWndEx::OnWindowPosChanged	Вызываемый платформой, когда размер кадра, позиция z-порядка или изменяются в результате вызова метода управления для окна.
CFrameWndEx::PaneFromPoint	Возвращает панели закрепления, которая содержит указанную точку.
CFrameWndEx::PreTranslateMessage	Обрабатывает сообщения окна конкретных, прежде чем они отправляются.
CFrameWndEx::RecalcLayout	Обрабатывает структуру и его дочерних окон.
CFrameWndEx::RemovePaneFromDockManager	Отменяет регистрацию панель и удаляет его из внутреннего списка в диспетчере закрепления.
CFrameWndEx::SetDockState	Извлекает структуру закрепления состояния закрепления, хранящихся в реестре.
CFrameWndEx::SetPrintPreviewFrame	Устанавливает фреймовое окно предварительного просмотра.
CFrameWndEx::SetupToolbarMenu	Вставляет определяемые пользователем команды в меню панели инструментов.
CFrameWndEx::ShowFullScreen	Переключение между экраном большую фрейма во весь и обычный режимами.
CFrameWndEx::ShowPane	Показать или скрывает указанную область.
CFrameWndEx::UpdateCaption	Вызываемый платформой для обновления заголовок границы окна.
CFrameWndEx::WinHelp	Вызывает или приложение WinHelp или связанную контекстом справки.

Пример

В следующем примере показано, как наследовать класс от класса CFrameWndEx. Пример иллюстрирует сигнатуры метода в подклассе, и, как переопределить метод OnShowPopupMenu. Этот фрагмент кода является частью Пример запуска площадки слова.

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