Класс `CFrameWndEx`

Статья
10/12/2023

Реализует функции однодокументного интерфейса 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` объект Class для окна фрейма.
`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`	Вызывается платформой, когда композиция диспетчера окон рабочих столов (DWM) включена или отключена.
`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)\|Invokes either the Справка по приложению или контексту WinHelp.

Пример

В следующем примере показано, как наследовать класс из CFrameWndEx класса. В примере показаны сигнатуры метода в подклассе и переопределение OnShowPopupMenu метода. Этот фрагмент кода входит в состав примера 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;
}

Иерархия наследования

Требования

Заголовок.afxframewndex.h

`CFrameWndEx::ActiveItemRecalcLayout`

Настраивает макет клиентского элемента OLE и клиентской области кадра.

void ActiveItemRecalcLayout();

Замечания

`CFrameWndEx::AddPane`

Регистрирует панель управления в диспетчере закреплений.

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

Параметры

pControlBar
[in] Панель управления для регистрации.

bTail
[in] TRUE Если вы хотите добавить панель управления в конец списка; FALSE Иначе.

Возвращаемое значение

TRUE Значение FALSE Иначе.

`CFrameWndEx::AdjustDockingLayout`

Пересчитывает макет всех панелей, закрепленных в окне фрейма.

virtual void AdjustDockingLayout(HDWP hdwp=NULL);

Параметры

hdwp
Дескриптор структуры, содержащей позиции нескольких окон. .

Замечания

Структура hdwp инициализируется методом BeginDeferWindowPos .

`CFrameWndEx::DelayUpdateFrameMenu`

Задает меню фрейма и обновляет его при простои обработки команд.

virtual void DelayUpdateFrameMenu(HMENU hMenuAlt);

Параметры

hMenuAlt
[in] Обработать альтернативное меню.

Замечания

`CFrameWndEx::DockPane`

Закрепление указанной области в окне фрейма.

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

Параметры

pBar
[in] Указатель на панель управления, который необходимо закрепить.

nDockBarID
[in] Идентификатор стороны окна фрейма для закрепления.

lpRect
[in] Указатель на константную Rect структуру, указывающую положение и размер экрана окна.

Замечания

Параметр nDockBarID может иметь одно из следующих значений:

AFX_IDW_DOCKBAR_TOP
AFX_IDW_DOCKBAR_BOTTOM
AFX_IDW_DOCKBAR_LEFT
AFX_IDW_DOCKBAR_RIGHT

`CFrameWndEx::DockPaneLeftOf`

Закрепление указанной панели слева от другой области.

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

Параметры

pBar
[in] Указатель на объект области, который необходимо закрепить.

pLeftOf
[in] Указатель на область слева от которой необходимо закрепить область, указанную pBarв поле.

Возвращаемое значение

TRUE Значение , если pBar успешно закреплено. В противном случае — значение FALSE.

Замечания

Метод принимает панель инструментов, указанную pBar параметром, и закрепляет ее в левой части панели инструментов, указанной параметром pLeftOf .

`CFrameWndEx::EnableAutoHidePanes`

Включает режим автоматического скрытия области при закреплении к указанной стороне главного окна фрейма.

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

Параметры

dwDockStyle
[in] Указывает сторону окна главной рамки, к которой необходимо закрепить панель.

Возвращаемое значение

TRUE Значение , если панель панели успешно закреплена на стороне окна кадра, указанной dwDockStyleв FALSE противном случае.

Замечания

dwDockStyle может иметь одно из следующих значений:

CBRS_ALIGN_TOP: позволяет закрепить панель управления в верхней части клиентской области окна кадра.
CBRS_ALIGN_BOTTOM: позволяет закрепить панель управления в нижней части клиентской области окна кадра.
CBRS_ALIGN_LEFT: позволяет закрепить панель управления слева от клиентской области окна фрейма.
CBRS_ALIGN_RIGHT: позволяет закрепить панель управления справа от клиентской области окна фрейма.

`CFrameWndEx::EnableDocking`

Включает закрепление панелей окна фрейма.

BOOL EnableDocking(DWORD dwDockStyle);

Параметры

dwDockStyle
[in] Указывает сторону окна главной рамки, в которой закреплена панель панели.

Возвращаемое значение

TRUE Если панель панели может быть успешно закреплена на указанной стороне. В противном случае — значение FALSE.

Замечания

Параметр dwDockStyle может иметь одно из следующих значений:

CBRS_ALIGN_TOP
CBRS_ALIGN_BOTTOM
CBRS_ALIGN_LEFT
CBRS_ALIGN_RIGHT

`CFrameWndEx::EnableFullScreenMainMenu`

Отображает или скрывает главное меню в полноэкранном режиме.

void EnableFullScreenMainMenu(BOOL bEnableMenu);

Параметры

bEnableMenu
[in] TRUE Чтобы отобразить главное меню в полноэкранном режиме, FALSE в противном случае.

`CFrameWndEx::EnableFullScreenMode`

Включает полноэкранный режим для окна фрейма.

void EnableFullScreenMode(UINT uiFullScreenCmd);

Параметры

uiFullScreenCmd
[in] Идентификатор команды, которая включает и отключает полноэкранный режим.

Замечания

В полноэкранном режиме все панели элементов управления, панели инструментов и меню скрыты, а активное представление изменяется, чтобы занять полноэкранный режим.

При включении полноэкранного режима необходимо указать идентификатор команды, которая включает или отключает полноэкранный режим. Можно вызвать EnableFullScreenMode из функции основного кадра OnCreate . При переключении окна фрейма на полноэкранный режим платформа создает плавающую панель инструментов с одной кнопкой с указанным идентификатором команды.

Если вы хотите сохранить главное меню на экране, вызовите CFrameWndEx::EnableFullScreenMainMenu.

`CFrameWndEx::EnableLoadDockState`

Включает или отключает загрузку состояния док-станции.

void EnableLoadDockState(BOOL bEnable=TRUE);

Параметры

bEnable
[in] TRUE чтобы включить загрузку состояния док-станции, FALSE чтобы отключить загрузку состояния док-станции.

`CFrameWndEx::EnablePaneMenu`

Включает или отключает автоматическую обработку меню панели.

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

Параметры

bEnable
[in] TRUE для включения автоматической обработки всплывающих меню панели управления; FALSE Чтобы отключить автоматическую обработку всплывающих меню панели управления.

uiCustomizeCmd
[in] Идентификатор команды элемента меню "Настройка ".

strCustomizeLabel
[in] Метка, отображаемая для элемента меню "Настройка"

uiViewToolbarsMenuEntryID
[in] Идентификатор элемента меню панели инструментов, открывающего всплывающее меню в панели управления.

bContextMenuShowsToolbarsOnly
[in] Если TRUEконтекстное меню панели управления отображает только список панелей инструментов. Если FALSEв меню отображается список панелей инструментов и закрепления.

bViewMenuShowsToolbarsOnly
[in] Если TRUEв меню панели управления отображается только список панелей инструментов. Если FALSEв меню отображается список панелей инструментов и закрепления.

`CFrameWndEx::GetActivePopup`

Возвращает указатель на отображаемое в настоящее время всплывающее меню.

CMFCPopupMenu* GetActivePopup() const;

Возвращаемое значение

Указатель на отображаемое в настоящее время всплывающее меню; в противном случае NULL.

`CFrameWndEx::GetDefaultResId`

Возвращает идентификатор ресурса, указанный при загрузке платформы окна фрейма.

UINT GetDefaultResId() const;

Возвращаемое значение

Значение идентификатора ресурса, указанное пользователем при загрузке окна фрейма. Ноль, если в окне фрейма нет строки меню.

`CFrameWndEx::GetDockingManager`

Извлекает CDockingManager объект Class для окна фрейма.

CDockingManager* GetDockingManager();

Возвращаемое значение

Указатель на CDockingManager класс.

Замечания

Окно фрейма CDockingManager создает и использует объект класса для управления закреплением дочернего окна.

`CFrameWndEx::GetMenuBar`

Возвращает указатель на объект строки меню, прикрепленное к окну фрейма.

const CMFCMenuBar* GetMenuBar() const;

Возвращаемое значение

Указатель на объект строки меню, подключенный к окну фрейма.

`CFrameWndEx::GetPane`

Возвращает указатель на область с указанным идентификатором.

CBasePane* GetPane(UINT nID);

Параметры

nID
[in] Идентификатор элемента управления.

Возвращаемое значение

Указатель на область с указанным идентификатором. NULL Если такая область отсутствует.

`CFrameWndEx::GetRibbonBar`

Извлекает элемент управления панели ленты для кадра.

CMFCRibbonBar* GetRibbonBar();

Возвращаемое значение

Указатель на CMFCRibbonBar класс кадра.

Замечания

`CFrameWndEx::GetTearOffBars`

Возвращает список объектов области, которые находятся в состоянии перемещения.

const CObList& GetTearOffBars() const;

Возвращаемое значение

Ссылка на CObList объект, содержащий коллекцию указателей на объекты панели, которые находятся в состоянии отключения.

`CFrameWndEx::GetToolbarButtonToolTipText`

Вызывается платформой, когда приложение отображает подсказку для кнопки панели инструментов.

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

Параметры

pButton
[in] Указатель на кнопку панели инструментов.

strTTText
[in] Текст подсказки, отображаемый для кнопки.

Возвращаемое значение

TRUE Значение , если подсказка отображается. В противном случае — значение FALSE.

Замечания

По умолчанию этот метод не выполняет никаких действий. Переопределите этот метод, если вы хотите отобразить подсказку для кнопки панели инструментов.

`CFrameWndEx::InsertPane`

Вставляет панель в список панелей элементов управления и регистрирует ее в диспетчере закрепления.

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

Параметры

pControlBar
Указатель на панель элементов управления, которую нужно вставить в список панелей элементов управления и зарегистрировать в диспетчере закрепления.

pTarget
Указатель на панель элементов управления, перед или после которой нужно вставить панель.

bAfter
TRUE Значение , если вы хотите вставить pControlBar после pTarget, FALSE в противном случае.

Возвращаемое значение

TRUE Значение , если панель управления успешно вставлена и зарегистрирована, FALSE в противном случае.

Замечания

Необходимо зарегистрировать каждую панель управления с помощью CDockingManager класса , чтобы принять участие в макете закрепления.

`CFrameWndEx::IsFullScreen`

Определяет, находится ли окно фрейма в полноэкранном режиме.

BOOL IsFullScreen() const;

Возвращаемое значение

TRUE Значение FALSE.

Замечания

Вы можете задать полноэкранный режим, вызвав CFrameWndEx::EnableFullScreenMode метод.

`CFrameWndEx::IsMenuBarAvailable`

Определяет, является ли указатель на объект строки меню допустимым.

BOOL IsMenuBarAvailable() const;

Возвращаемое значение

TRUE Значение , если в окне фрейма есть строка меню; в противном случае FALSE.

`CFrameWndEx::IsPointNearDockSite`

Определяет, находится ли точка в зоне выравнивания.

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

Параметры

point
[in] Позиция точки.

dwBarAlignment
[out] Место выравнивания точки. Сведения о возможных значениях см. в таблице в разделе "Примечания".

bOuterEdge
[out] TRUE , если точка находится близко к границе кадра; FALSE , если точка находится в клиентской области.

Возвращаемое значение

TRUE , если точка находится в зоне выравнивания; FALSEв противном случае .

Замечания

В следующей dwBarAlignment таблице перечислены возможные значения параметра.

значение	Description
`CBRS_ALIGN_TOP`	Выровнено поверх.
`CBRS_ALIGN_RIGHT`	Выровнено по правому краю.
`CBRS_ALIGN_BOTTOM`	Выровнены по нижнему краю.
`CBRS_ALIGN_LEFT`	Выровнено по левому краю.

`CFrameWndEx::IsPrintPreview`

Определяет, находится ли окно фрейма в режиме предварительного просмотра.

BOOL IsPrintPreview();

Возвращаемое значение

TRUE Значение FALSEв противном случае .

Замечания

`CFrameWndEx::LoadFrame`

Этот метод вызывается после создания окна фрейма и загрузки его ресурсов.

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

Параметры

nIDResource
[in] Идентификатор ресурса, используемый для загрузки всех ресурсов фрейма.

dwDefaultStyle
[in] Стиль окна фрейма по умолчанию.

pParentWnd
[in] Указатель на родительское окно кадра.

pContext
[in] Указатель на класс Structure, используемый CCreateContext платформой во время создания приложения.

Возвращаемое значение

Значение TRUE, если метод выполнен успешно; в противном случае — значение FALSE.

Замечания

`CFrameWndEx::NegotiateBorderSpace`

Реализует согласование границы клиента OLE.

virtual BOOL NegotiateBorderSpace(
    UINT nBorderCmd,
    LPRECT lpRectBorder);

Параметры

nBorderCmd
[in] Команда переговоров границы. Сведения о возможных значениях см. в разделе "Примечания".

lpRectBorder
[in, out] Размеры границы.

Возвращаемое значение

TRUE Значение FALSEв противном случае .

Замечания

В следующей nBorderCmd таблице перечислены возможные значения параметра.

borderGet
Получение доступного клиентского пространства OLE.

borderRequest
Запрос клиентского пространства OLE.

borderSet
Задайте клиентское пространство OLE.

`CFrameWndEx::OnActivate`

Платформа вызывает этот метод, когда входные данные пользователя переключаются на кадр или от него.

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

Параметры

nState
[in] Является ли кадр активным или неактивным. Сведения о возможных значениях см. в таблице в разделе "Примечания".

pWndOther
[in] Указатель на другое окно, которое переключает входные данные пользователя с текущим.

bMinimized
[in] Свернутое состояние кадра. TRUE Значение FALSEв противном случае .

Замечания

В следующей nState таблице перечислены возможные значения параметра.

значение	Description
`WA_ACTIVE`	Кадр выбирается методом, отличным от щелчка мыши.
`WA_CLICKACTIVE`	Кадр выбирается щелчком мыши.
`WA_INACTIVE`	Кадр не выбран.

`CFrameWndEx::OnActivateApp`

Вызывается платформой при выборе или отмене выбора приложения.

afx_msg void OnActivateApp(
    BOOL bActive,
    DWORD dwThreadID);

Параметры

bActive
[in] TRUE Значение , если выбрано приложение; FALSE Значение , если приложение не выбрано.

dwThreadID
[in] Этот параметр не используется.

Замечания

`CFrameWndEx::OnChangeVisualManager`

Вызывается платформой, когда изменение кадра требует изменения в визуальном диспетчере.

afx_msg LRESULT OnChangeVisualManager(
    WPARAM wParam,
    LPARAM lParam);

Параметры

wParam
[in] Этот параметр не используется.

lParam
[in] Этот параметр не используется.

Возвращаемое значение

Всегда возвращает 0.

Замечания

`CFrameWndEx::OnClose`

Платформа вызывает этот метод для закрытия кадра.

afx_msg void OnClose();

Замечания

Если кадр находится в режиме предварительного просмотра печати, он отправляет сообщение Windows, чтобы закрыть предварительный просмотр печати; В противном случае, если кадр размещает клиент OLE, клиент деактивирован.

`CFrameWndEx::OnCloseDockingPane`

Вызывается платформой, когда пользователь нажимает кнопку "Закрыть " на панели закрепления.

virtual BOOL OnCloseDockingPane(CDockablePane* pPane);

Возвращаемое значение

TRUE Значение , если панель закрепления может быть закрыта. FALSE Иначе

Замечания

Реализация по умолчанию ничего не делает. Переопределите этот метод, если вы хотите обработать скрытие закрепления панели.

`CFrameWndEx::OnCloseMiniFrame`

Вызывается платформой, когда пользователь нажимает кнопку "Закрыть " в окне с плавающей мини-рамкой.

virtual BOOL OnCloseMiniFrame(CPaneFrameWnd* pWnd);

Возвращаемое значение

TRUE Значение , если окно с плавающей мини-рамкой может быть закрыто. В противном случае — значение FALSE.

Замечания

Реализация по умолчанию не выполняет никаких действий. Переопределите этот метод, если вы хотите обработать скрытие окна с плавающей мини-рамкой.

`CFrameWndEx::OnClosePopupMenu`

Вызывается платформой, когда активное всплывающее меню обрабатывает WM_DESTROY сообщение.

virtual void OnClosePopupMenu(CMFCPopupMenu* pMenuPopup);

Параметры

pMenuPopup
Указатель на всплывающее меню.

Замечания

Платформа отправляет WM_DESTROY сообщение при закрытии окна. Переопределите этот метод, если вы хотите обрабатывать уведомления от CMFCPopupMenu объектов, принадлежащих окну кадра, когда CMFCPopupMenu объект обрабатывает WM_DESTROY сообщение, отправленное платформой при закрытии окна.

`CFrameWndEx::OnCmdMsg`

Отправляет сообщения команд.

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

Параметры

nID
[in] Идентификатор команды.

nCode
[in] Категория командного сообщения.

pExtra
[in, out] Указатель на объект команды.

pHandlerInfo
[in, out] Указатель на структуру обработчика команд.

Возвращаемое значение

TRUE Значение , если сообщение команды обработано; FALSEв противном случае .

Замечания

`CFrameWndEx::OnContextHelp`

Вызывается платформой для отображения справки, связанной с контекстом.

afx_msg void OnContextHelp();

Замечания

`CFrameWndEx::OnCreate`

Вызывается платформой после создания кадра.

afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);

Параметры

lpCreateStruct
[in] Указатель на структуру CREATESTRUCT для нового кадра.

Возвращаемое значение

0, чтобы продолжить создание кадра; -1 для уничтожения кадра.

Замечания

`CFrameWndEx::OnDestroy`

Вызывается платформой при уничтожении кадра.

afx_msg void OnDestroy();

Замечания

Таблица акселератора и все окна уничтожены.

`CFrameWndEx::OnDrawMenuImage`

Вызывается платформой, когда приложение рисует изображение, связанное с элементом меню.

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

Параметры

pDC
[in] Указатель на контекст устройства.

pMenuButton
[in] Указатель на кнопку меню, изображение которого отрисовывается.

rectImage
[in] Указатель на Rect структуру, указывающую положение экрана и размер изображения.

Возвращаемое значение

TRUE Значение FALSE Иначе.

Замечания

Переопределите этот метод, если вы хотите настроить отрисовку изображения для элементов меню, принадлежащих строке меню, принадлежащей производной объекту CFrameWndEx .

`CFrameWndEx::OnDrawMenuLogo`

Вызывается платформой, когда CMFCPopupMenu объект обрабатывает WM_PAINT сообщение.

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

Параметры

pDC
[in] Указатель на контекст устройства.

pMenu
[in] Указатель на пункт меню.

rectLogo
[in] Ссылка на константную CRect структуру, указывающую положение экрана и размер логотипа меню.

Замечания

Переопределите эту функцию, если вы хотите отобразить логотип во всплывающем меню, которое принадлежит строке меню, принадлежащей производной объекту CFrameWndEx .

`CFrameWndEx::OnDWMCompositionChanged`

Вызывается платформой, когда композиция диспетчера окон рабочих столов (DWM) включена или отключена.

afx_msg LRESULT OnDWMCompositionChanged(
    WPARAM wp,
    LPARAM lp);

Параметры

wp
[in] Этот параметр не используется.

lp
[in] Этот параметр не используется.

Возвращаемое значение

Всегда возвращает 0.

Замечания

`CFrameWndEx::OnExitSizeMove`

Вызывается платформой при остановке перемещения или изменения размера кадра.

LRESULT OnExitSizeMove(
    WPARAM wp,
    LPARAM lp);

Параметры

wp
[in] Этот параметр не используется.

lp
[in] Этот параметр не используется.

Возвращаемое значение

Всегда возвращает 0.

Замечания

`CFrameWndEx::OnGetMinMaxInfo`

Вызывается платформой при изменении размера кадра, чтобы задать ограничения измерения окна.

afx_msg void OnGetMinMaxInfo(MINMAXINFO FAR* lpMMI);

Параметры

lpMMI
[in] Указатель на структуру MINMAXINFO .

Замечания

`CFrameWndEx::OnIdleUpdateCmdUI`

Вызывается платформой для обновления отображения кадра при простои обработки команд.

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

Параметры

wParam
[in] Этот параметр не используется.

lParam
[in] Этот параметр не используется.

Возвращаемое значение

Всегда возвращает 0.

Замечания

`CFrameWndEx::OnLButtonDown`

Платформа вызывает этот метод, когда пользователь нажимает левую кнопку мыши.

afx_msg void OnLButtonDown(
    UINT nFlags,
    CPoint point);

Параметры

nFlags
[in] Указывает, нажимает ли пользователь клавиши модификатора. Возможные значения см. в WM_LBUTTONDOWN разделе wParam "Уведомление".

point
[in] Указывает координаты x и y указателя относительно левого верхнего угла окна.

Замечания

`CFrameWndEx::OnLButtonUp`

Платформа вызывает этот метод, когда пользователь освобождает левую кнопку мыши.

afx_msg void OnLButtonUp(
    UINT nFlags,
    CPoint point);

Параметры

nFlags
[in] Указывает, нажимает ли пользователь клавиши модификатора. Возможные значения см. в WM_LBUTTONUP разделе wParam "Уведомление".

point
[in] Указывает координаты x и y указателя относительно левого верхнего угла окна.

Замечания

`CFrameWndEx::OnMenuButtonToolHitTest`

Вызывается платформой, когда CMFCToolBarButton объект обрабатывает WM_NCHITTEST сообщение.

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

Параметры

pButton
[in] Указатель на кнопку панели инструментов.

pTI
[out] Указатель на структуру сведений о средстве.

Возвращаемое значение

TRUE Если приложение заполняет pTI параметр. В противном случае — значение FALSE.

Замечания

Переопределите этот метод, если вы хотите предоставить подсказку для определенного элемента меню.

`CFrameWndEx::OnMenuChar`

Вызывается платформой при отображении меню и пользователь нажимает клавишу, которая не соответствует команде.

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

Параметры

nChar
[in] Код символа нажатия клавиши.

nFlags
[in] Содержит флаг, MF_POPUP если отображаемое меню является подменю; содержит MF_SYSMENU флаг, если отображается меню управления.

pMenu
[in] Указатель на меню.

Возвращаемое значение

Слово высокого порядка должно быть одним из следующих значений.

значение	Description
`0`	Платформа должна игнорировать нажатие клавиш.
`1`	Платформа должна закрыть меню.
`2`	Платформа должна выбрать один из элементов, отображаемых в меню. Слово с низким порядком содержит идентификатор выбранной команды.

`CFrameWndEx::OnMouseMove`

Платформа вызывает этот метод при перемещении указателя.

afx_msg void OnMouseMove(
    UINT nFlags,
    CPoint point);

Параметры

nFlags
[in] Указывает, нажимает ли пользователь клавиши модификатора. Возможные значения см. в WM_MOUSEMOVE разделе wParam "Уведомление".

point
[in] Указывает x и y координаты указателя относительно левого верхнего угла окна.

Замечания

`CFrameWndEx::OnMoveMiniFrame`

Вызывается платформой при перемещении окна области.

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

Параметры

pFrame
[in] Указатель на CPaneFrameWnd окно области классов .

Возвращаемое значение

TRUE Значение , если окно панели не было закреплено; FALSE Значение , если окно панели было закреплено.

Замечания

`CFrameWndEx::OnNcActivate`

Вызывается платформой, когда не клиентская область кадра должна быть перезабрана, чтобы указать изменение активного состояния.

afx_msg BOOL OnNcActivate(BOOL bActive);

Параметры

bActive
[in] TRUE для рисования активного кадра; FALSE для рисования неактивного кадра.

Возвращаемое значение

Ненулевое значение для продолжения обработки по умолчанию; 0, чтобы предотвратить деактивацию не клиентской области.

Замечания

`CFrameWndEx::OnNcCalcSize`

Вызывается платформой, когда необходимо вычислить размер и положение клиентской области.

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

Параметры

bCalcValidRects
[in] TRUE если приложение должно указать допустимую клиентская область; FALSEв противном случае .

lpncsp
[in] Указатель на структуру NCCALCSIZE_PARAMS , содержащую изменения измерения кадра.

Замечания

`CFrameWndEx::OnNcHitTest`

Вызывается платформой при перемещении указателя или нажатии или освобождении кнопки мыши.

afx_msg LRESULT OnNcHitTest(CPoint point);

Параметры

point
[in] Расположение указателя в координатах экрана.

Возвращаемое значение

Указанное значение указателя. Список возможных значений см. в разделе WM_NCHITTEST "Уведомление".

Замечания

`CFrameWndEx::OnNcMouseMove`

Вызывается платформой при перемещении указателя в не клиентской области.

afx_msg void OnNcMouseMove(
    UINT nHitTest,
    CPoint point);

Параметры

nHitTest
[in] Указанное значение указателя. Список возможных значений см. в разделе WM_NCHITTEST "Уведомление".

point
[in] Расположение указателя в координатах экрана.

Замечания

`CFrameWndEx::OnNcPaint`

Вызывается платформой, когда не клиентская область должна быть окрашена.

afx_msg void OnNcPaint();

Замечания

`CFrameWndEx::OnPaneCheck`

Вызывается платформой для управления видимостью панели.

afx_msg BOOL OnPaneCheck(UINT nID);

Параметры

nID
[in] Идентификатор элемента управления панели.

Возвращаемое значение

TRUE Значение , если команда была обработана; FALSE для продолжения обработки команд.

Замечания

`CFrameWndEx::OnPostPreviewFrame`

Вызывается платформой, когда пользователь изменяет режим предварительного просмотра печати.

afx_msg LRESULT OnPostPreviewFrame(
    WPARAM wParam,
    LPARAM lParam);

Параметры

wParam
[in] Этот параметр не используется.

lParam
[in] TRUE если кадр находится в режиме предварительного просмотра; FALSE Если режим предварительного просмотра печати отключен.

Возвращаемое значение

Всегда возвращает 0.

Замечания

`CFrameWndEx::OnPowerBroadcast`

Вызывается платформой при возникновении события управления питанием.

afx_msg LRESULT OnPowerBroadcast(
    WPARAM wp,
    LPARAM lp);

Параметры

wp
[in] Событие управления питанием. Список возможных значений см. в сообщенииWM_POWERBROADCAST.

lp
[in] Этот параметр не используется.

Возвращаемое значение

Результат вызова процедуры окна по умолчанию.

Замечания

`CFrameWndEx::OnSetMenu`

Вызывается платформой для замены меню окна фрейма.

afx_msg LRESULT OnSetMenu(
    WPARAM wp,
    LPARAM lp);

BOOL OnSetMenu(HMENU hmenu);

Параметры

wp
[in] Обработайте новое меню окна фрейма.

lp
[in] Обработайте новое меню окна.

hmenu
[in] Обработайте новое меню окна фрейма.

Возвращаемое значение

LRESULT результат вызова процедуры окна по умолчанию.

BOOL — это TRUE значение, если событие было обработано; в противном случае FALSE.

Замечания

`CFrameWndEx::OnSetPreviewMode`

Вызывается платформой, чтобы задать режим предварительного просмотра для кадра.

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

Параметры

bPreview
[in] TRUE для включения предварительной версии печати; FALSE для отключения предварительного просмотра печати.

pState
[in] Указатель на структуру состояния кадра CPrintPreviewState .

Замечания

`CFrameWndEx::OnSetText`

Вызывается платформой для задания текста окна.

afx_msg LRESULT OnSetText(
    WPARAM wParam,
    LPARAM lParam);

Параметры

wParam
[in] Этот параметр не используется.

lParam
[in] Указатель на текст окна.

Возвращаемое значение

Возвращает значение из вызова DefWindowProc.

Замечания

`CFrameWndEx::OnShowCustomizePane`

Вызывается платформой при отображении QuickCustomizePane.

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

Параметры

pMenuPane
[in] Указатель на панель быстрого настройки.

uiToolbarID
[in] Идентификатор элемента управления панели инструментов для настройки.

Возвращаемое значение

Этот метод всегда возвращает значение TRUE.

Замечания

Меню быстрого настройки — это всплывающее меню, которое отображается при нажатии кнопки настройки панели инструментов

`CFrameWndEx::OnShowPanes`

Вызывается платформой для отображения или скрытия панелей.

virtual BOOL OnShowPanes(BOOL bShow);

Параметры

bShow
[in] TRUE Значение , если приложение отображает панели; FALSE Иначе.

Возвращаемое значение

Этот метод всегда возвращает значение FALSE.

Замечания

Реализация по умолчанию показывает панели, если bShow есть TRUE , и панели скрыты или когда bShow есть FALSE , и области видны.

Реализация по умолчанию скрывает панели, если bShow есть TRUE , и области видны или когда bShow есть FALSE , а панели скрыты.

Переопределите этот метод в производном классе, чтобы выполнить пользовательский код, когда платформа отображает или скрывает панели.

`CFrameWndEx::OnShowPopupMenu`

Вызывается платформой при отображении всплывающего меню.

virtual BOOL OnShowPopupMenu(CMFCPopupMenu* pMenu);

Параметры

pMenu
[in] Указатель на всплывающее меню.

Возвращаемое значение

TRUE Значение , если всплывающее меню отображается; в противном случае FALSE.

Замечания

Переопределите этот метод в производном классе, чтобы выполнить пользовательский код, когда платформа отображает всплывающее меню. Например, переопределите этот метод, чтобы изменить цвет фона команд во всплывающем меню.

`CFrameWndEx::OnSize`

Вызывается платформой после изменения размера кадра.

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

Параметры

nType
[in] Тип изменения размера. Возможные значения см. в разделе wParam WM_SIZE Notification.

cx
[in] Новая ширина кадра в пикселях.

cy
[in] Новая высота кадра в пикселях.

Замечания

`CFrameWndEx::OnSizing`

Вызывается платформой, когда пользователь изменяет размер кадра.

afx_msg void OnSizing(
    UINT fwSide,
    LPRECT pRect);

Параметры

fwSide
[in] Край перемещенного кадра. См. параметр wParam в WM_SIZING уведомлении.

pRect
[in, out] Указатель на CRect структуру или RECT структуру, содержащую координаты кадра.

Замечания

`CFrameWndEx::OnSysColorChange`

Вызывается платформой при изменении системных цветов.

void OnSysColorChange();

Замечания

`CFrameWndEx::OnTearOffMenu`

Вызывается платформой, когда приложение отображает меню с слезоточивой панелью.

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

Параметры

pMenuPopup
[in] Указатель на всплывающее меню.

pBar
[in] Указатель на слезоточивый бар.

Возвращаемое значение

TRUE Значение , если всплывающее меню с отключенной панелью включено; в противном случае FALSE.

Замечания

Переопределите этот метод в производном классе, чтобы выполнить пользовательский код, когда платформа отображает панель управления.

Реализация по умолчанию ничего не делает и возвращает TRUE.

`CFrameWndEx::OnToolbarContextMenu`

Вызывается платформой для создания всплывающего меню панели инструментов.

afx_msg LRESULT OnToolbarContextMenu(
    WPARAM wp,
    LPARAM lp);

Параметры

wp
[in] Этот параметр не используется.

lp
[in] Этот параметр не используется.

Возвращаемое значение

Всегда возвращает значение 1.

Замечания

`CFrameWndEx::OnToolbarCreateNew`

Платформа вызывает этот метод для создания новой панели инструментов.

afx_msg LRESULT OnToolbarCreateNew(
    WPARAM wp,
    LPARAM lp);

Параметры

wp
[in] Этот параметр не используется.

lp
[in] Указатель на текст для заголовка панели инструментов.

Возвращаемое значение

Указатель на новую панель инструментов; или NULL если панель инструментов не была создана.

Замечания

`CFrameWndEx::OnToolbarDelete`

Вызывается платформой при удалении панели инструментов.

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

`CFrameWndEx::PaneFromPoint`

Выполняет поиск каждой панели для заданной точки.

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

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

Параметры

point
[in] Координаты экрана точки на проверка.

nSensitivity
[in] Разверните ограничивающий прямоугольник каждой панели управления на этот объем при поиске точки.

bExactBar
[in] TRUE Значение nSensitivity , FALSEчтобы игнорировать параметр; в противном случае .

pRTCBarType
[in] NULLВ противном случае метод выполняет поиск только на панели управления указанного типа.

dwAlignment
[out] В случае успешного выполнения этот параметр содержит сторону панели управления, ближайшей к указанной точке. В противном случае этот параметр не инициализирован.

Возвращаемое значение

Указатель на панель управления, содержащую элемент pointуправления; NULL если элемент управления не найден.

Замечания

Этот метод выполняет поиск всех элементов управления в приложении point.

Используется nSensitivity для увеличения размера области поиска. Используется pRTCBarType для ограничения типов полос управления, которые выполняет поиск метода.

`CFrameWndEx::PreTranslateMessage`

Обрабатывает определенные сообщения окна перед отправкой.

virtual BOOL PreTranslateMessage(MSG* pMsg);

Параметры

pMsg
[in] Указатель на MSG структуру, содержащую сообщение для обработки.

Возвращаемое значение

Ненулевая, если сообщение обработано и не должно быть отправлено; Значение 0, если сообщение не было обработано и должно быть отправлено.

Замечания

`CFrameWndEx::RecalcLayout`

Настраивает макет фрейма и его дочерних окон.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Параметры

bNotify
[in] Указывает, следует ли уведомлять клиентский элемент OLE об изменении макета.

Замечания

Этот метод вызывается при изменении размера окна фрейма или при отображении или скрытии панели управления.

`CFrameWndEx::RemovePaneFromDockManager`

Отменяет регистрацию области и удаляет ее из диспетчера док-станции.

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

Параметры

pControlBar
[in] Указатель на панель управления для удаления.

bDestroy
[in] TRUE , чтобы уничтожить панель управления после ее удаления; FALSE Иначе.

bAdjustLayout
[in] TRUE для настройки макета док-станции; FALSE Иначе.

bAutoHide
[in] TRUE Значение FALSE Иначе.

pBarReplacement
[in] Указатель на панель, которая заменяет удаленную панель.

Замечания

Используйте этот метод, чтобы удалить панель управления из макета закрепления окна кадра.

Класс CDockingManager обрабатывает макет панели управления. Необходимо зарегистрировать каждую панель управления в диспетчере закреплений CFrameWndEx::InsertPane с помощью CFrameWndEx::AddPane метода или метода.

`CFrameWndEx::SetDockState`

Восстанавливает макет док-станции до состояния док-станции, хранящегося в реестре.

void SetDockState(const CDockState& state);

Параметры

state
Состояние док-станции. Этот параметр не учитывается.

`CFrameWndEx::SetPrintPreviewFrame`

Задает окно рамки предварительного просмотра печати.

void SetPrintPreviewFrame(CFrameWnd* pWnd);

Параметры

pWnd
[in] Указатель на окно рамки предварительного просмотра печати.

Замечания

`CFrameWndEx::SetupToolbarMenu`

Вставляет определяемые пользователем команды в меню панели инструментов.

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

Параметры

menu
[in] Объект CMenu , который необходимо изменить.

uiViewUserToolbarCmdFirst
[in] Первая определяемая пользователем команда.

uiViewUserToolbarCmdLast
[in] Последняя определяемая пользователем команда.

Замечания

Платформа хранит определяемые пользователем команды в списке. Используйте uiViewUserToolbarCmdFirst и uiViewUserToolbarCmdList укажите индексы команд для вставки.

`CFrameWndEx::ShowFullScreen`

Переключает основной кадр между полноэкранным режимом и обычным режимом.

void ShowFullScreen();

`CFrameWndEx::ShowPane`

Отображает или скрывает указанную область.

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

Параметры

pBar
[in] Указатель на панель управления для отображения или скрытия.

bShow
[in] Если TRUEприложение отображает панель управления. В противном случае приложение скрывает панель управления.

bDelay
[in] Если TRUE, отложите настройку макета док-станции до вызова CFrameWndEx::AdjustDockingLayoutплатформы. В противном случае пересчитывайте макет док-станции немедленно.

bActivate
[in] Если TRUE, сделайте панель управления активной. В противном случае отобразите панель управления в неактивном состоянии.

`CFrameWndEx::UpdateCaption`

Вызывается платформой для обновления подпись рамки окна.

void UpdateCaption();

Замечания

`CFrameWndEx::WinHelp`

Вызывает справку, связанную с приложением WinHelp или контекстом.

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

Параметры

dwData
Данные, зависящие от nCmd параметра. Список возможных значений см. в разделе WinHelp.

nCmd
Команда справки. Список возможных значений см. в разделе WinHelp.

Замечания

См. также

Диаграмма иерархии
Классы
CFrameWnd

Класс CFrameWndEx

Синтаксис

Участники

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

Пример

Иерархия наследования

Требования

CFrameWndEx::ActiveItemRecalcLayout

Замечания

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

Возвращаемое значение

Замечания

CFrameWndEx::GetMenuBar

Возвращаемое значение

CFrameWndEx::GetPane

Параметры

Возвращаемое значение

CFrameWndEx::GetRibbonBar

Возвращаемое значение

Замечания

CFrameWndEx::GetTearOffBars

Возвращаемое значение

CFrameWndEx::GetToolbarButtonToolTipText

Параметры

Возвращаемое значение

Замечания

CFrameWndEx::InsertPane

Параметры

Возвращаемое значение

Замечания

CFrameWndEx::IsFullScreen

Возвращаемое значение

Замечания

CFrameWndEx::IsMenuBarAvailable

Возвращаемое значение

CFrameWndEx::IsPointNearDockSite

Параметры

Возвращаемое значение

Замечания

CFrameWndEx::IsPrintPreview

Возвращаемое значение

Замечания

CFrameWndEx::LoadFrame

Класс `CFrameWndEx`

`CFrameWndEx::ActiveItemRecalcLayout`

`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`

`CFrameWndEx::GetMenuBar`

`CFrameWndEx::GetPane`

`CFrameWndEx::GetRibbonBar`

`CFrameWndEx::GetTearOffBars`

`CFrameWndEx::GetToolbarButtonToolTipText`

`CFrameWndEx::InsertPane`

`CFrameWndEx::IsFullScreen`

`CFrameWndEx::IsMenuBarAvailable`

`CFrameWndEx::IsPointNearDockSite`

`CFrameWndEx::IsPrintPreview`

`CFrameWndEx::LoadFrame`

`CFrameWndEx::NegotiateBorderSpace`

`CFrameWndEx::OnActivate`

`CFrameWndEx::OnActivateApp`

`CFrameWndEx::OnChangeVisualManager`

`CFrameWndEx::OnClose`

`CFrameWndEx::OnCloseDockingPane`

`CFrameWndEx::OnCloseMiniFrame`

`CFrameWndEx::OnClosePopupMenu`

`CFrameWndEx::OnCmdMsg`

`CFrameWndEx::OnContextHelp`

`CFrameWndEx::OnCreate`

`CFrameWndEx::OnDestroy`

`CFrameWndEx::OnDrawMenuImage`

`CFrameWndEx::OnDrawMenuLogo`

`CFrameWndEx::OnDWMCompositionChanged`

`CFrameWndEx::OnExitSizeMove`

`CFrameWndEx::OnGetMinMaxInfo`

`CFrameWndEx::OnIdleUpdateCmdUI`

`CFrameWndEx::OnLButtonDown`

`CFrameWndEx::OnLButtonUp`

`CFrameWndEx::OnMenuButtonToolHitTest`