CDockablePane::AttachToTabWnd

Статья
02/20/2013

Вложение текущая область на панели целевого объекта, создание нашитая панель.

virtual CDockablePane* AttachToTabWnd( 
    CDockablePane* pTabControlBarAttachTo,
    AFX_DOCK_METHOD dockMethod,
    BOOL bSetActive = TRUE,
    CDockablePane** ppTabbedControlBar = NULL
);

Параметры

[in] [out] pTabControlBarAttachTo
Определяет область целевого объекта которой текущая область вложение.Область целевого объекта должна быть закрепляемой областью.
[входящий] dockMethod
Определяет метод закрепления.
[входящий] bSetActive
TRUE, чтобы активировать панель нашитая после операций присоединения; в противном случае – значение FALSE.
[исходящий] ppTabbedControlBar
Содержит нашитую эту панель результатов из операций присоединения.

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

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

Заметки

Если вложение одной области в другую закрепляемая панель с помощью этого метода происходит следующее:

Границы проверить, является ли панель pTabControlBarAttachTo целевого объекта обычная панели закрепления или если она является производной от CBaseTabbedPane.
Если область целевого объекта нашитая панель, границы добавить текущая область в виде вкладки.
Если область целевого объекта обычная панели закрепления, то платформа создает нашитая панель.
- Платформа вызывает функцию pTabControlBarAttachTo->CreateTabbedPane.Стиль новых нашитых зависит от панели элемент m_pTabbedControlBarRTC.По умолчанию этот член установлено с классом среды выполнения CTabbedPane.При передаче стиль AFX_CBRS_OUTLOOK_TABS в качестве параметра методу dwTabbedStyleCDockablePane::Create, то устанавливается объект времени выполнения класса для класса среды выполнения CMFCOutlookBar.Можно изменить этот член в любое время, чтобы изменить стиль новой панели.
- Когда этот метод создает нашитая панели заменяет указатель на pTabControlBarAttachTo границы (если закреплена панель или перемещаемый в multi - miniframe окне) с указателем на новой нашитой панели.
- Границы добавить панель pTabControlBarAttachTo на панели нашитой как первая вкладка.Границы затем добавить текущая область, как вторую вкладку.
Если текущая область является производной от CBaseTabbedPane, то вся из вкладок перемещены к pTabControlBarAttachTo и текущая область разрушена.Поэтому будьте внимательны при вызове этого метода происходит потому, что указатель на текущую область может являться недопустимым после возврата из этого метода.