Класс CPaneFrameWnd

Дополнительные сведения см. в исходном коде, расположенном в папке VC\atlmfc\src\mfc установки Visual Studio.

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

Синтаксис

class CPaneFrameWnd : public CWnd

Участники

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

Имя	Описание
CPaneFrameWnd::AddPane	Добавляет панель.
CPaneFrameWnd::AddRemovePaneFromGlobalList	Добавляет панель в глобальный список или удаляет из него.
CPaneFrameWnd::AdjustLayout	Настраивает макет окна области.
CPaneFrameWnd::AdjustPaneFrames
CPaneFrameWnd::CalcBorderSize	Вычисляет размер границ окна области.
CPaneFrameWnd::CalcExpectedDockedRect	Вычисляет ожидаемый прямоугольник закрепленного окна.
CPaneFrameWnd::CanBeAttached	Определяет, может ли текущая панель быть закреплена на другой панели или окне фрейма.
CPaneFrameWnd::CanBeDockedToPane	Определяет, может ли окно области быть закреплено на панели.
CPaneFrameWnd::CheckGripperVisibility
CPaneFrameWnd::ConvertToTabbedDocument	Преобразует панель в документ с вкладками.
CPaneFrameWnd::Create	Создает окно области и прикрепляет его к объекту CPaneFrameWnd.
CPaneFrameWnd::CreateEx	Создает окно области и прикрепляет его к объекту CPaneFrameWnd.
CPaneFrameWnd::D ockPane	Закрепляет область.
CPaneFrameWnd::FindFloatingPaneByID	Находит в глобальном списке плавающих панелей панель с указанным идентификатором элемента управления.
CPaneFrameWnd::FrameFromPoint	Находит окно области, содержащее предоставленную пользователем точку.
CPaneFrameWnd::GetCaptionHeight	Возвращает высоту заголовка окна области.
CPaneFrameWnd::GetCaptionRect	Вычисляет ограничивающий прямоугольник заголовка окна области.
CPaneFrameWnd::GetCaptionText	Возвращает текст заголовка.
CPaneFrameWnd::GetDockingManager
CPaneFrameWnd::GetDockingMode	Возвращает режим закрепления.
CPaneFrameWnd::GetFirstVisiblePane	Возвращает первую видимую панель, содержащуюся в окне области.
CPaneFrameWnd::GetHotPoint
CPaneFrameWnd::GetPane	Возвращает панель, содержащуюся в окне области.
CPaneFrameWnd::GetPaneCount	Возвращает число панелей, содержащихся в окне области.
CPaneFrameWnd::GetParent
CPaneFrameWnd::GetPinState
CPaneFrameWnd::GetRecentFloatingRect
CPaneFrameWnd::GetVisiblePaneCount	Возвращает число видимых панелей, содержащихся в окне области.
CPaneFrameWnd::HitTest	Определяет, какая часть окна области находится в заданной точке.
CPaneFrameWnd::IsCaptured
CPaneFrameWnd::IsDelayShow
CPaneFrameWnd::IsRollDown	Определяет, требуется ли развертывание окна области.
CPaneFrameWnd::IsRollUp	Определяет, требуется ли свертывание окна области.
CPaneFrameWnd::KillDockingTimer	Останавливает таймер закрепления.
CPaneFrameWnd::LoadState	Загружает состояние панели из реестра.
CPaneFrameWnd::OnBeforeDock	Определяет возможность закрепления.
CPaneFrameWnd::OnDockToRecentPos	Закрепляет окно области в его последней позиции.
CPaneFrameWnd::OnKillRollUpTimer	Останавливает таймер свертки.
CPaneFrameWnd::OnMovePane	Смещает окно области на указанное расстояние.
CPaneFrameWnd::OnPaneRecalcLayout	Настраивает макет содержащейся панели.
CPaneFrameWnd::OnSetRollUpTimer	Устанавливает таймер свертки.
CPaneFrameWnd::OnShowPane	Вызывается платформой при скрытии или отображении панели в окне области.
CPaneFrameWnd::P aneFromPoint	Возвращает панель, если она содержит предоставленную пользователем точку в пределах окна области.
CPaneFrameWnd::P in
CPaneFrameWnd::PreTranslateMessage	Используется классом CWinApp для преобразования сообщений окна перед их передачей функциям Windows TranslateMessage и DispatchMessage .
CPaneFrameWnd::RedrawAll	Перерисовывает все окна областей.
CPaneFrameWnd::RemoveNonValidPanes	Вызывается платформой для удаления недопустимых панелей.
CPaneFrameWnd::RemovePane	Удаляет панель из окна области.
CPaneFrameWnd::ReplacePane	Заменяет одну панель другой.
CPaneFrameWnd::SaveState	Сохраняет состояние панели в реестр.
CPaneFrameWnd::Serialize	Считывает этот объект из архива или записывает в него.
CPaneFrameWnd::SetCaptionButtons	Задает кнопки заголовка.
CPaneFrameWnd::SetDelayShow
CPaneFrameWnd::SetDockingManager
CPaneFrameWnd::SetDockingTimer	Устанавливает таймер закрепления.
CPaneFrameWnd::SetDockState	Задает состояние закрепления.
CPaneFrameWnd::SetHotPoint
CPaneFrameWnd::SetPreDockState	Вызывается платформой для задания предварительного состояния закрепления.
CPaneFrameWnd::SizeToContent	Делает размер окна области равным размеру содержащейся в нем панели.
CPaneFrameWnd::StartTearOff	Делает меню перемещаемым.
CPaneFrameWnd::StoreRecentDockSiteInfo
CPaneFrameWnd::StoreRecentTabRelatedInfo

Защищенные методы

Имя	Описание
CPaneFrameWnd::OnCheckRollState	Определяет, требуется ли свертывание или развертывание окна области.
CPaneFrameWnd::OnDrawBorder	Рисует границы окна области.

Элементы данных

Имя	Описание
CPaneFrameWnd::m_bUseSaveBits	Указывает, следует ли регистрировать класс окна с помощью стиля класса CS_SAVEBITS.

Замечания

Когда панель переходит из закрепленного состояния в плавающее, платформа автоматически создает объект CPaneFrameWnd.

Окно области можно перетащить вместе с его видимым содержимым (немедленное закрепление) или с помощью прямоугольника перетаскивания (стандартное закрепление). Режим закрепления панели контейнера окна области определяет поведение окна области при перетаскивании. Дополнительные сведения см. в разделе CBasePane::GetDockingMode.

В заголовке окна области отображаются кнопки, зависящие от стиля включенной панели. Если панель может быть закрыта ( CBasePane::CanBeClosed), она отображает кнопку "Закрыть". Если в области есть стиль AFX_CBRS_AUTO_ROLLUP, он отображает закрепление.

Если вы получаете производный класс из класса CPaneFrameWnd, необходимо сообщить платформе способ его создания. Создайте класс, переопределив CPane::CreateDefaultMiniframe, или задайте CPane::m_pMiniFrameRTC элемент таким образом, чтобы он указывает на сведения о классе среды выполнения для вашего класса.

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

CObject

CCmdTarget

CWnd

CPaneFrameWnd

Требования

Заголовок: afxPaneFrameWnd.h

CPaneFrameWnd::AddPane

Добавляет панель.

virtual void AddPane(CBasePane* pWnd);

Параметры

pWnd
[in] Область для добавления.

CPaneFrameWnd::AddRemovePaneFromGlobalList

Добавляет панель в глобальный список или удаляет из него.

static BOOL __stdcall AddRemovePaneFromGlobalList(
    CBasePane* pWnd,
    BOOL bAdd);

Параметры

pWnd
[in] Область для добавления или удаления.

bAdd
[in] Если значение не равно нулю, добавьте область. Если значение 0, удалите область.

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

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

CPaneFrameWnd::AdjustLayout

Настраивает макет окна области.

virtual void AdjustLayout();

CPaneFrameWnd::AdjustPaneFrames

virtual void AdjustPaneFrames();

Замечания

CPaneFrameWnd::CalcBorderSize

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

virtual void CalcBorderSize(CRect& rectBorderSize) const;

Параметры

rectBorderSize
[out] Содержит размер в пикселях границы окна мини-кадра.

Замечания

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

CPaneFrameWnd::CalcExpectedDockedRect

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

virtual void CalcExpectedDockedRect(
    CWnd* pWndToDock,
    CPoint ptMouse,
    CRect& rectResult,
    BOOL& bDrawTab,
    CDockablePane** ppTargetBar);

Параметры

pWndToDock
[in] Указатель на окно для закрепления.

ptMouse
[in] Расположение мыши.

rectResult
[out] Вычисляемый прямоугольник.

bDrawTab
[out] Если значение TRUE, нарисуйте вкладку. Если значение FALSE, не рисуйте вкладку.

ppTargetBar
[out] Указатель на целевую область.

Замечания

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

CPaneFrameWnd::CanBeAttached

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

virtual BOOL CanBeAttached() const;

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

ЗНАЧЕНИЕ TRUE, если панель может быть закреплена на другой панели или в окне кадра; в противном случае ЗНАЧЕНИЕ FALSE.

CPaneFrameWnd::CanBeDockedToPane

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

virtual BOOL CanBeDockedToPane(const CDockablePane* pDockingBar) const;

Параметры

pDockingBar
[in] Область.

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

Ненулевое значение, если мини-кадр можно закрепить на pDockingBar; в противном случае — значение 0.

CPaneFrameWnd::CheckGripperVisibility

virtual void CheckGripperVisibility();

Замечания

CPaneFrameWnd::ConvertToTabbedDocument

Преобразует панель в документ с вкладками.

virtual void ConvertToTabbedDocument();

CPaneFrameWnd::Create

Создает окно мини-кадра и присоединяет его к объекту CPaneFrameWnd .

virtual BOOL Create(
    LPCTSTR lpszWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    CCreateContext* pContext = NULL);

Параметры

lpszWindowName
[in] Задает текст, отображаемый в окне мини-кадра.

dwStyle
[in] Задает стиль окна. Дополнительные сведения см. в разделе "Стили окон".

rect
[in] Указывает начальный размер и позицию окна мини-кадра.

pParentWnd
[in, out] Указывает родительский кадр окна мини-кадра. Это значение не должно иметь значение NULL.

pContext
[in, out] Задает определяемый пользователем контекст.

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

ЗНАЧЕНИЕ TRUE, если окно было успешно создано; в противном случае — ЗНАЧЕНИЕ FALSE.

Замечания

Окно мини-кадра создается двумя шагами. Во-первых, платформа создает CPaneFrameWnd объект. Во-вторых, он вызывает Create создание окна мини-кадра Windows и присоединение его к объекту CPaneFrameWnd .

CPaneFrameWnd::CreateEx

Создает окно мини-кадра и присоединяет его к объекту CPaneFrameWnd .

virtual BOOL CreateEx(
    DWORD dwStyleEx,
    LPCTSTR lpszWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    CCreateContext* pContext=NULL);

Параметры

dwStyleEx
[in] Задает стиль расширенного окна. Дополнительные сведения см. в разделе "Расширенные стили окон"

lpszWindowName
[in] Задает текст, отображаемый в окне мини-кадра.

dwStyle
[in] Задает стиль окна. Дополнительные сведения см. в разделе "Стили окон".

rect
[in] Указывает начальный размер и позицию окна мини-кадра.

pParentWnd
[in, out] Указывает родительский кадр окна мини-кадра. Это значение не должно иметь значение NULL.

pContext
[in, out] Задает определяемый пользователем контекст.

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

ЗНАЧЕНИЕ TRUE, если окно было успешно создано; в противном случае — ЗНАЧЕНИЕ FALSE.

Замечания

Окно мини-кадра создается двумя шагами. Во-первых, платформа создает CPaneFrameWnd объект. Во-вторых, он вызывает Create создание окна мини-кадра Windows и присоединение его к объекту CPaneFrameWnd .

CPaneFrameWnd::D ockPane

Закрепляет область.

virtual CDockablePane* DockPane(BOOL& bWasDocked);

Параметры

bWasDocked
[out] ЗНАЧЕНИЕ TRUE, если панель уже закреплена; в противном случае ЗНАЧЕНИЕ FALSE.

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

Если операция выполнена успешно, CDockablePane область была закреплена; в противном случае — значение NULL.

CPaneFrameWnd::FindFloatingPaneByID

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

static CBasePane* FindFloatingPaneByID(UINT nID);

Параметры

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

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

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

CPaneFrameWnd::FrameFromPoint

Находит окно мини-кадра, содержащее указанную точку.

static CPaneFrameWnd* __stdcall FrameFromPoint(
    CPoint pt,
    int nSensitivity,
    CPaneFrameWnd* pFrameToExclude = NULL,
    BOOL bFloatMultiOnly = FALSE);

Параметры

пт
[in] Точка в координатах экрана.

nSensitivity
[in] Увеличьте область поиска окна мини-кадра на этот размер. Окно мини-кадра удовлетворяет критериям поиска, если указанная точка попадает в увеличенную область.

pFrameToExclude
[in] Указывает окно мини-кадра для исключения из поиска.

bFloatMultiOnly
[in] Если значение TRUE, выполните поиск только в мини-кадрах с CBRS_FLOAT_MULTI стилем. Если значение FALSE, выполните поиск по всем окнам мини-фрейма.

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

Указатель на окно мини-кадра, содержащее pt; в противном случае — ЗНАЧЕНИЕ NULL.

CPaneFrameWnd::GetCaptionHeight

Возвращает высоту заголовка окна области.

virtual int GetCaptionHeight() const;

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

Высота в пикселях окна мини-кадра.

Замечания

Вызовите этот метод, чтобы определить высоту окна мини-кадра. По умолчанию высота имеет значение SM_CYSMCAPTION. Дополнительные сведения см. в разделе "Функция GetSystemMetrics".

CPaneFrameWnd::GetCaptionRect

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

virtual void GetCaptionRect(CRect& rectCaption) const;

Параметры

rectCaption
[out] Содержит размер и положение заголовка окна мини-кадра в координатах экрана.

Замечания

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

CPaneFrameWnd::GetCaptionText

Возвращает текст заголовка.

virtual CString GetCaptionText();

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

Текст заголовка окна мини-кадра.

Замечания

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

CPaneFrameWnd::GetDockingManager

CDockingManager* GetDockingManager() const;

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

Замечания

CPaneFrameWnd::GetDockingMode

Возвращает режим закрепления.

virtual AFX_DOCK_TYPE GetDockingMode() const;

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

Режим док-станции. Одно из следующих значений:

• DT_STANDARD

• DT_IMMEDIATE

• DT_SMART

CPaneFrameWnd::GetFirstVisiblePane

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

virtual CWnd* GetFirstVisiblePane() const;

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

Первая панель в окне мини-кадра или NULL, если окно мини-кадра не содержит панелей.

CPaneFrameWnd::GetHotPoint

CPoint GetHotPoint() const;

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

Замечания

CPaneFrameWnd::GetPane

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

virtual CWnd* GetPane() const;

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

Панель, содержащаяся в мини-кадре или NULL, если окно мини-кадра не содержит панелей.

Замечания

CPaneFrameWnd::GetPaneCount

Возвращает число панелей, содержащихся в окне области.

virtual int GetPaneCount() const;

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

Количество панелей в окне мини-кадра. Это значение может быть равно нулю.

Замечания

CPaneFrameWnd::GetParent

CWnd* GetParent();

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

Замечания

CPaneFrameWnd::GetPinState

BOOL GetPinState() const;

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

Замечания

CPaneFrameWnd::GetRecentFloatingRect

CRect GetRecentFloatingRect() const;

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

Замечания

CPaneFrameWnd::GetVisiblePaneCount

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

virtual int GetVisiblePaneCount() const;

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

Количество видимых панелей.

Замечания

CPaneFrameWnd::HitTest

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

virtual LRESULT HitTest(
    CPoint point,
    BOOL bDetectCaption);

Параметры

point
[in] Точка для проверки.

bDetectCaption
[in] Если значение TRUE, проверьте точку в заголовке. Если значение FALSE, игнорируйте подпись.

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

Одно из следующих значений:

Значение	Значение
HTNOWHERE	Точка находится за пределами окна мини-кадра.
HTCLIENT	Точка находится в клиентской области.
HTCAPTION	Точка находится в заголовке.
HTTOP	Точка находится в верхней части.
HTTOPLEFT	Точка находится в левом верхнем углу.
HTTOPRIGHT	Точка находится в правом верхнем углу.
HTLEFT	Точка находится слева.
HTRIGHT	Точка справа.
HTBOTTOM	Точка находится внизу.
HTBOTTOMLEFT	Точка находится в нижнем левом углу.
HTBOTTOMRIGHT	Точка находится в правом нижнем углу.

CPaneFrameWnd::IsCaptured

BOOL IsCaptured() const;

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

Замечания

CPaneFrameWnd::IsDelayShow

BOOL IsDelayShow() const;

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

Замечания

CPaneFrameWnd::IsRollDown

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

virtual BOOL IsRollDown() const;

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

ЗНАЧЕНИЕ TRUE, если окно мини-кадра должно быть свернуто; в противном случае — ЗНАЧЕНИЕ FALSE.

Замечания

Этот метод вызывается платформой, чтобы определить, следует ли свернуть окно мини-кадра. Функция свертки или свертки включена для окна мини-кадра, если он содержит по крайней мере одну панель с флагом AFX_CBRS_AUTO_ROLLUP. Этот флаг задается при создании области. Дополнительные сведения см. в разделе CBasePane::CreateEx.

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

CPaneFrameWnd::IsRollUp

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

virtual BOOL IsRollUp() const;

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

ЗНАЧЕНИЕ TRUE, если окно мини-кадра должно быть свернуто; в противном случае — ЗНАЧЕНИЕ FALSE.

Замечания

Этот метод вызывается платформой, чтобы определить, следует ли свернуть окно мини-кадра. Функция свертки или свертки включена для окна мини-кадра, если он содержит по крайней мере одну панель с флагом AFX_CBRS_AUTO_ROLLUP. Этот флаг задается при создании области. Дополнительные сведения см. в разделе CBasePane::CreateEx.

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

CPaneFrameWnd::KillDockingTimer

Останавливает таймер закрепления.

void KillDockingTimer();

CPaneFrameWnd::LoadState

Загружает состояние панели из реестра.

virtual BOOL LoadState(
    LPCTSTR lpszProfileName = NULL,
    UINT uiID = (UINT) -1);

Параметры

lpszProfileName
[in] Имя профиля.

uiID
[in] Идентификатор области.

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

ЗНАЧЕНИЕ TRUE, если состояние панели было загружено успешно; в противном случае ЗНАЧЕНИЕ FALSE.

CPaneFrameWnd::m_bUseSaveBits

Указывает, следует ли зарегистрировать класс окна, имеющий стиль класса CS_SAVEBITS.

AFX_IMPORT_DATA static BOOL m_bUseSaveBits;

Замечания

Задайте этому статическому элементу значение TRUE, чтобы зарегистрировать класс окна мини-кадра с CS_SAVEBITS стилем. Это может помочь уменьшить мерцание, когда пользователь перетаскивает окно мини-кадра.

CPaneFrameWnd::OnBeforeDock

Определяет возможность закрепления.

virtual BOOL OnBeforeDock();

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

ЗНАЧЕНИЕ TRUE, если возможно закрепление; в противном случае — ЗНАЧЕНИЕ FALSE.

CPaneFrameWnd::OnCheckRollState

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

virtual void OnCheckRollState();

Замечания

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

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

CPaneFrameWnd::OnDockToRecentPos

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

virtual void OnDockToRecentPos();

CPaneFrameWnd::OnDrawBorder

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

virtual void OnDrawBorder(CDC* pDC);

Параметры

pDC
[in] Контекст устройства, используемый для рисования границы.

Замечания

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

CPaneFrameWnd::OnKillRollUpTimer

Останавливает таймер свертки.

virtual void OnKillRollUpTimer();

CPaneFrameWnd::OnMovePane

Смещает окно области на указанное расстояние.

virtual void OnMovePane(
    CPane* pBar,
    CPoint ptOffset);

Параметры

pBar
[in] Указатель на область (игнорируется).

ptOffset
[in] Смещение, по которому нужно переместить панель.

CPaneFrameWnd::OnPaneRecalcLayout

Настраивает макет области в окне мини-кадра.

virtual void OnPaneRecalcLayout();

Замечания

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

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

CPaneFrameWnd::OnSetRollUpTimer

Устанавливает таймер свертки.

virtual void OnSetRollUpTimer();

CPaneFrameWnd::OnShowPane

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

virtual void OnShowPane(
    CDockablePane* pBar,
    BOOL bShow);

Параметры

pBar
[in] Область, отображаемая или скрытая.

bShow
[in] ЗНАЧЕНИЕ TRUE, если отображается панель; Значение FALSE, если область скрыта.

Замечания

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

CPaneFrameWnd::P in

void Pin(BOOL bPin = TRUE);

Параметры

[in] bPin

Замечания

CPaneFrameWnd::P aneFromPoint

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

virtual CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    BOOL bCheckVisibility);

Параметры

point
[in] Точка, которую пользователь щелкнул, в координатах экрана.

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

bCheckVisibility
[in] ЗНАЧЕНИЕ TRUE, чтобы указать, что должны возвращаться только видимые области; в противном случае — ЗНАЧЕНИЕ FALSE.

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

Область, которую пользователь щелкнул, или NULL, если в этом расположении нет области.

Замечания

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

CPaneFrameWnd::RedrawAll

Перерисовывает все окна областей.

static void RedrawAll();

Замечания

Этот метод обновляет все окна мини-кадра путем вызова CWnd::RedrawWindow для каждого окна.

CPaneFrameWnd::RemoveNonValidPanes

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

virtual void RemoveNonValidPanes();

CPaneFrameWnd::RemovePane

Удаляет панель из окна области.

virtual void RemovePane(
    CBasePane* pWnd,
    BOOL bDestroy = FALSE,
    BOOL bNoDelayedDestroy = FALSE);

Параметры

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

bDesk
[in] Указывает, что происходит с окном мини-кадра. Если bDeties имеет значение TRUE, этот метод немедленно уничтожает окно мини-кадра. Если значение равно FALSE, этот метод уничтожает окно мини-кадра после определенной задержки.

bNoDelayedDelayedDesk
[in] Если значение TRUE, отложенное уничтожение отключено. Если значение FALSE, отложенное уничтожение включено.

Замечания

Платформа может уничтожить мини-кадры сразу или после определенной задержки. Если вы хотите отложить разрушение мини-фреймов, передайте false в параметре bNoDelayedDelayedDefx. Задержка уничтожения возникает, когда платформа обрабатывает сообщение AFX_WM_CHECKEMPTYMINIFRAME.

CPaneFrameWnd::ReplacePane

Заменяет одну панель другой.

virtual void ReplacePane(
    CBasePane* pBarOrg,
    CBasePane* pBarReplaceWith);

Параметры

pBarOrg
[in] Указатель на исходную панель.

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

CPaneFrameWnd::SaveState

Сохраняет состояние панели в реестр.

virtual BOOL SaveState(
    LPCTSTR lpszProfileName = NULL,
    UINT uiID = (UINT) -1);

Параметры

lpszProfileName
[in] Имя профиля.

uiID
[in] Идентификатор области.

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

ЗНАЧЕНИЕ TRUE, если состояние панели было успешно сохранено; в противном случае ЗНАЧЕНИЕ FALSE.

CPaneFrameWnd::SetCaptionButtons

Задает кнопки заголовка.

virtual void SetCaptionButtons(DWORD dwButtons);

Параметры

dwButtons
[in] Побитовое или сочетание следующих значений:

• AFX_CAPTION_BTN_CLOSE

• AFX_CAPTION_BTN_PIN

• AFX_CAPTION_BTN_MENU

• AFX_CAPTION_BTN_CUSTOMIZE

CPaneFrameWnd::SetDelayShow

void SetDelayShow(BOOL bDelayShow);

Параметры

[in] bDelayShow

Замечания

CPaneFrameWnd::SetDockingManager

void SetDockingManager(CDockingManager* pManager);

Параметры

[in] pManager

Замечания

CPaneFrameWnd::SetDockingTimer

Устанавливает таймер закрепления.

void SetDockingTimer(UINT nTimeOut);

Параметры

nTimeOut
[in] Значение времени ожидания в миллисекундах.

CPaneFrameWnd::SetDockState

Задает состояние закрепления.

virtual void SetDockState(CDockingManager* pDockManager);

Параметры

pDockManager
[in] Указатель на диспетчер закреплений.

CPaneFrameWnd::SetHotPoint

void SetHotPoint(CPoint& ptNew);

Параметры

[in] ptNew

Замечания

CPaneFrameWnd::SetPreDockState

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

virtual BOOL SetPreDockState(
    AFX_PREDOCK_STATE preDockState,
    CBasePane* pBarToDock = NULL,
    AFX_DOCK_METHOD dockMethod = DM_MOUSE);

Параметры

preDockState
[in] Возможные значения:

• PDS_NOTHING,

• PDS_DOCK_REGULAR,

• PDS_DOCK_TO_TAB

pBarToDock
[in] Указатель на панель для док-станции.

dockMethod
[in] Метод закрепления. (Этот параметр игнорируется.)

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

ЗНАЧЕНИЕ TRUE, если окно мини-фрейма откреплено; Значение FALSE, если оно закреплено.

CPaneFrameWnd::SizeToContent

Настраивает размер окна мини-кадра таким образом, чтобы он был эквивалентен автономной области.

virtual void SizeToContent();

Замечания

Вызовите этот метод, чтобы изменить размер окна мини-кадра на размер автономной панели.

CPaneFrameWnd::StartTearOff

Делает меню перемещаемым.

BOOL StartTearOff(CMFCPopu* pMenu);

Параметры

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

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

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

CPaneFrameWnd::StoreRecentDockSiteInfo

virtual void StoreRecentDockSiteInfo(CPane* pBar);

Параметры

[in] pBar

Замечания

CPaneFrameWnd::StoreRecentTabRelatedInfo

virtual void StoreRecentTabRelatedInfo(
    CDockablePane* pDockingBar,
    CDockablePane* pTabbedBar);

Параметры

[in] pDockingBar
[in] pTabbedBar

Замечания

См. также

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