Класс CBasePane

Статья
06/10/2015

Базовый класс для всех панелей в MFC.

class CBasePane : public CWnd

Члены

Открытые конструкторы

Имя	Описание
CBasePane::CBasePane	Конструктор по умолчанию.
CBasePane::~CBasePane	Деструктор.

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

Имя	Описание
CBasePane::accHitTest	Вызываемый платформой для получения дочернего элемента или дочерний объект в заданной точке на экране. (Переопределяет CWnd::accHitTest).
CBasePane::accLocation	Вызываемый платформой для получения текущего расположения экрана для указанного объекта. (Переопределяет CWnd::accLocation).
CBasePane::AccNotifyObjectFocusEvent	CBasePane не использует этот метод.
CBasePane::accSelect	Вызываемый платформой, чтобы изменить выделение или переместить фокус клавиатуры для указанного объекта. (Переопределяет CWnd::accSelect).
CBasePane::AddPane	Добавление панели закрепления на него.
CBasePane::AdjustDockingLayout	Перенаправляет вызов к диспетчеру закрепления, чтобы обработать структуру закрепления.
CBasePane::AdjustLayout	Если панель с границами будет должна обрабатывать свою внутреннюю структуру.
CBasePane::CalcFixedLayout	Вычисляет горизонтальный размер области элементов управления.
CBasePane::CanAcceptPane	Определяет, является ли другую панель можно закрепить в области.
CBasePane::CanAutoHide	Определяет, поддерживает ли режим автоматического скрытия панели.
CBasePane::CanBeAttached	Определяет, является ли панель можно закрепить в другой области.
CBasePane::CanBeClosed	Определяет, является ли панель можно закрыть.
CBasePane::CanBeDocked	Определяет, является ли панель можно закрепить в другой области.
CBasePane::CanBeResized	Определяет, является ли панель можно изменить размер.
CBasePane::CanBeTabbedDocument	Определяет, является ли панель можно преобразовать в документ нашитому MDI.
CBasePane::CanFloat	Определяет, может ли панель плыть.
CBasePane::CanFocus	Определяет, является ли панель может получать фокус.
CBasePane::CopyState	Копирует состояние данной панели.
CBasePane::CreateDefaultMiniframe	Если область может плыть, то создается окно области.
CBasePane::CreateEx	Создает элемент управления панели.
CBasePane::DockPane	Закрепит панель к другой области или фреймовому окно.
CBasePane::DockPaneUsingRTTI	Закрепит панель с использованием сведений о типах во время выполнения.
CBasePane::DockToFrameWindow	Закрепит закрепляемая панель к кадру.
CBasePane::DoesAllowDynInsertBefore	Определяет, является ли другую панель можно динамически вставить между этой панелью и родительским кадром.
CBasePane::EnableDocking	Включает закрепления панелей в главного фрейма.
CBasePane::EnableGripper	Включение или отключение отслеживания. Если отслеживание включено, то пользователь может перетащить его, чтобы переместить область.
CBasePane::FillWindowRect	Для внутреннего использования.
CBasePane::FloatPane	Область располагается.
CBasePane::get_accChild	Вызываемый платформой для получения адреса интерфейса IDispatch для заданного дочернего элемента. (Переопределяет CWnd::get_accChild).
CBasePane::get_accChildCount	Вызываемый платформой для получения число дочерних объектов, принадлежащих этому объекту. (Переопределяет CWnd::get_accChildCount).
CBasePane::get_accDefaultAction	Вызываемый платформой для получения строку, описывающую выполняемое по умолчанию для объекта. (Переопределяет CWnd::get_accDefaultAction).
CBasePane::get_accDescription	Вызываемый платформой для получения строку, описывающую внешний вид указанного объекта. (Переопределяет CWnd::get_accDescription).
CBasePane::get_accFocus	Вызываемый платформой для получения объект, имеющий фокус клавиатуры. (Переопределяет CWnd::get_accFocus).
CBasePane::get_accHelp	Вызываемый платформой для получения строки свойства Справки для объекта. (Переопределяет CWnd::get_accHelp).
CBasePane::get_accHelpTopic	Вызываемый платформой, чтобы получить полный путь WinHelpfile , сопоставлено с указанным объектом и идентификатором соответствующей подразделы, содержащиеся в этом файле. (Переопределяет CWnd::get_accHelpTopic).
CBasePane::get_accKeyboardShortcut	Вызываемый платформой для получения указанное сочетание клавиш для объекта. (Переопределяет CWnd::get_accKeyboardShortcut).
CBasePane::get_accName	Вызываемый платформой для получения имя указанного объекта. (Переопределяет CWnd::get_accName).
CBasePane::get_accParent	Вызываемый платформой для получения интерфейса IDispatch для родительского объекта. (Переопределяет CWnd::get_accParent).
CBasePane::get_accRole	Вызываемый платформой для получения сведения, которые описывают роль указанного объекта. (Переопределяет CWnd::get_accRole).
CBasePane::get_accSelection	Вызываемый платформой для получения выбранные дочерние элементы данного объект. (Переопределяет CWnd::get_accSelection).
CBasePane::get_accState	Вызываемый платформой для получения текущее состояние заданного объекта. (Переопределяет CWnd::get_accState).
CBasePane::get_accValue	Вызываемый платформой для получения значения указанного объекта. (Переопределяет CWnd::get_accValue).
CBasePane::GetCaptionHeight	Возвращает высоту заголовка.
CBasePane::GetControlBarStyle	Возвращает стиль панели элементов управления.
CBasePane::GetCurrentAlignment	Возвращает текущее выравнивание панели.
CBasePane::GetDockingMode	Возвращает текущий режим для закрепления панелей.
CBasePane::GetDockSiteFrameWnd	Возвращает указатель на окно, сайт закрепления для панели.
CBasePane::GetEnabledAlignment	Получает стили CBRS_ALIGN_, применены на панели.
CBasePane::GetMFCStyle	Получает стили области, относящиеся к MFC.
CBasePane::GetPaneIcon	Возвращает дескриптор для значка панели.
CBasePane::GetPaneRect	Для внутреннего использования.
CBasePane::GetPaneRow	Возвращает указатель на объект CDockingPanesRow, где панель закреплена.
CBasePane::GetPaneStyle	Возвращает стиль панели.
CBasePane::GetParentDockSite	Возвращает указатель на родительский сайту закрепления.
CBasePane::GetParentMiniFrame	Возвращает указатель на родительский окно области.
CBasePane::GetParentTabbedPane	Возвращает указатель на панели нашитой родительским элементом.
CBasePane::GetParentTabWnd	Возвращает указатель к родительскому окну, внутри вкладки.
CBasePane::GetRecentVisibleState	Платформа вызывает этот метод, когда панель восстановлена из архива.
CBasePane::HideInPrintPreviewMode	Определяет, является ли скрыта панели в режиме предварительного просмотра.
CBasePane::InsertPane	Регистрирует указанной панели с диспетчером закрепления.
CBasePane::IsAccessibilityCompatible	Определяет, поддерживает ли панель активные специальные возможности.
CBasePane::IsAutoHideMode	Определяет, является ли область в режиме автоматического скрытия.
CBasePane::IsDialogControl	Определяет, является ли панель элемент управления диалогового окна.
CBasePane::IsDocked	Определяет, является ли закреплена панель.
CBasePane::IsFloating	Указывает, располагается ли панель.
CBasePane::IsHorizontal	Определяет, является ли панель закреплена по горизонтали.
CBasePane::IsInFloatingMultiPaneFrameWnd	Определяет, является ли область фреймовом окне multi- панели.
CBasePane::IsMDITabbed	Определяет, была ли добавлена панель к дочернему окну mdi-приложения как документ с вкладками.
CBasePane::IsPaneVisible	Указывает, установлен ли пометить WS_VISIBLE для панели.
CBasePane::IsPointNearDockSite	Определяет, является ли указанная точка находится рядом с сайта закрепления.
CBasePane::IsResizable	Определяет, является ли панель можно изменить размер.
CBasePane::IsRestoredFromRegistry	Определяет, является ли восстановлена панель из реестра.
CBasePane::IsTabbed	Определяет, была ли вставлена в набор нашитого панель вкладок окна.
CBasePane::IsTooltipTopmost	Для внутреннего использования.
CBasePane::IsVisible	Указывает, видима ли панель.
CBasePane::LoadState	Загружает состояние области из реестра.
CBasePane::MoveWindow	Перемещает панель.
CBasePane::OnAfterChangeParent	Вызываемый платформой, если родительский панели будет изменить.
CBasePane::OnBeforeChangeParent	Вызывается инфраструктурой перед панелью изменяет ее родительское окно.
CBasePane::OnDrawCaption	Платформа вызывает этот метод, когда заголовок рисования.
CBasePane::OnMovePaneDivider	Этот метод в настоящее время не используется.
CBasePane::OnPaneContextMenu	Вызываемый платформой, когда он создает меню, содержащее список панелей.
CBasePane::OnRemoveFromMiniFrame	Если панель с границами будет удалена от родительского мини фреймового окна.
CBasePane::OnSetAccData	CBasePane не использует этот метод.
CBasePane::OnUpdateCmdUI	Для внутреннего использования.
CBasePane::PaneFromPoint	Возвращает панель, которая содержит заданную точку.
CBasePane::PreTranslateMessage	Используемый классом CWinApp для трансляции сообщения окна, прежде чем они будут передается функции TranslateMessage и DispatchMessage Windows. (Переопределяет CWnd::PreTranslateMessage).
CBasePane::RecalcLayout	CBasePane не использует этот метод.
CBasePane::RemovePaneFromDockManager	Отменяет регистрацию панель и удаляет его из списка в диспетчере закрепления.
CBasePane::SaveState	Сохраняет состояние области в реестр.
CBasePane::SelectDefaultFont	Выбирает шрифт по умолчанию для данного контекста устройства.
CBasePane::Serialize	Считывает или записывает данный объект или архива. (Переопределяет CObject::Serialize).
CBasePane::SetControlBarStyle	Задает стиль панели элементов управления.
CBasePane::SetDockingMode	Устанавливает режим для закрепления панелей.
CBasePane::SetMDITabbed	Для внутреннего использования.
CBasePane::SetPaneAlignment	Задает выравнивание панели.
CBasePane::SetPaneRect	Для внутреннего использования.
CBasePane::SetPaneStyle	Задает стиль панели.
CBasePane::SetRestoredFromRegistry	Для внутреннего использования.
CBasePane::SetWindowPos	Изменяет размер, положения и z-порядка панелей.
CBasePane::ShowPane	Показать или скрывает панель.
CBasePane::StretchPane	Панель растянет вертикально или горизонтально.
CBasePane::UndockPane	Удаляет панели закрепления из сайта по умолчанию ползунка или окна области, где его в настоящий момент закрепить.

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

Имя	Описание
CBasePane::DoPaint	Заполняет фон панели.

Заметки

Если необходимо создать, то класс панели, который поддерживает расширенную закрепления отличается доступным в MFC, должен наследовать его от CBasePane или из Класс CPane.

Советы по настройке

Следующие советы настройки относятся к Класс CBasePane и всем классам, которые наследуются от него.

При создании панель, можно применить несколько новых стилей:
- AFX_CBRS_FLOAT открывает панель плыть.
- AFX_CBRS_AUTOHIDE включает режим автоматического скрытия.
- AFX_CBRS_CLOSE содержит панель, которую необходимо закрыть (скрытый).
Эти флаги, которые можно объединить с битовой операции логического сложения.

Логические CBasePane реализует следующие виртуальные методы, чтобы отразить эти флаги: CBasePane::CanBeClosed, CBasePane::CanAutoHide, CBasePane::CanFloat. Можно переопределять в производных классах, чтобы настраивать их функциональности.
Можно настраивать функциональности закрепления путем переопределения CBasePane::CanAcceptPane. Убедитесь в FALSE панели возврата из этого метода для предотвращения другую панель из закрепления на него.
Если нужно создать статическая панель, которая не могут плыть и любую другую панель, которая предотвращает из закрепления перед ним (похожий на панели outlook в примере OutlookDemo), создайте его в качестве подписчиков, отличных от CBasePane::DoesAllowDynInsertBefore перемещаемый и переопределите для возврата FALSE. Реализация по умолчанию возвращает FALSE если панель создана без стиля AFX_CBRS_FLOAT.
Создайте все области с идентификаторами, отличное от -1.
Чтобы определить видимость области, используйте CBasePane::IsVisible. Она правильно обрабатывает состояние видимости в режимах нашитых и автоматическом скрытии.
Если нужно создать панель не плавающей запятой с возможностью изменения размера, создайте ее без стиля AFX_CBRS_FLOAT и вызовите CFrameWnd::DockControlBar.
Чтобы исключить панель из структуры закрепления или удалить панель инструментов из своей панели закрепления, вызовите CBasePane::UndockPane. Этот метод не следует вызывать для панелей в режиме автоматического скрытия или для панелей, которые находятся на вкладках нашитых windows.
Если необходимо плыть или отстыковать панель, которая находится в режиме автоматического скрытия, необходимо вызвать CDockablePane::SetAutoHideMode с FALSE в качестве первого аргумента, прежде чем вызывать метод CBasePane::FloatPane или CBasePane::UndockPane.

Пример

В следующем примере показано, как использовать различные методы класса CBasePane. Примере показано, как получить панель от класса CFrameWndEx и, как задать режим, выравнивание панели закрепления и стиль панели. Код из Пример запуска площадки слова.

          // This CMainFrame class extends the CFrameWndEx class. 
            // GetPane is a method in the CFrameWndEx class which  
            // Returns a pointer to the pane that has the specified ID.
            CBasePane* pBar = GetPane(ID_VIEW_FORMATBAR);
            if (pBar != NULL)
            {
                // Set the docking mode, the pane alignment, and the pane style.
                pBar->SetDockingMode(DT_STANDARD);
                pBar->SetPaneAlignment(CBRS_ALIGN_LEFT);
                pBar->SetPaneStyle(pBar->GetCurrentAlignment() | CBRS_TOOLTIPS);
                pBar->ShowPane(TRUE, FALSE, FALSE);
            }