CBasePane选件类

所有窗格的基类在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	调用由框架检索指定对象的当前状态。 （重写 服务。）
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	指定窗格是否支持Active Accessibility。
CBasePane::IsAutoHideMode	确定窗格是否在自动隐藏模式。
CBasePane::IsDialogControl	指定窗格是否对话框控件。
CBasePane::IsDocked	确定窗格是停靠。
CBasePane::IsFloating	确定窗格是浮动。
CBasePane::IsHorizontal	确定窗格是水平停靠。
CBasePane::IsInFloatingMultiPaneFrameWnd	指定窗格是否在多窗格框架窗口。
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	调用由窗格之前的framework更改其父窗口。
CBasePane::OnDrawCaption	在绘制时，框架调用此方法声明中。
CBasePane::OnMovePaneDivider	当前不使用此方法。
CBasePane::OnPaneContextMenu	调用由结构，在生成具有窗格中列出的菜单。
CBasePane::OnRemoveFromMiniFrame	调用由结构，当窗格从其父mini框架窗口中移除。
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 防止另一个窗格停靠到它。

• 如果要创建不能浮点数，并防止其他窗格停靠在它之前的静态窗格(类似于OutlookDemo示例中的Outlook栏)，请将其创建为非浮动并重写 CBasePane::DoesAllowDynInsertBefore 返回 FALSE。 如果窗格创建的，而不用 AFX_CBRS_FLOAT 样式，默认实现返回 FALSE。

• -1以外，用ID创建所有窗格。

• 若要确定窗格可见性，请使用 CBasePane::IsVisible。 正确它处理可见性状态在选项卡式和自动隐藏模式。

• 如果要创建非浮动可调整大小的窗格中，将创建它，而无需 AFX_CBRS_FLOAT 样式并调用 CFrameWnd::DockControlBar。

• 从停靠格式要排除窗格或从其停靠条移除工具栏，请调用 CBasePane::UndockPane。 不要调用此方法窗格上自动隐藏模式或位于选项卡式窗口"选项卡窗格的。

• 如果要浮动或停靠在自动隐藏模式下的窗格，必须调用 CDockablePane::SetAutoHideMode 和 FALSE，当第一个参数，在调用 CBasePane::FloatPane 或 CBasePane::UndockPane之前。

示例

下面的示例在 CBasePane 选件类演示如何使用各种方法。 示例演示如何从 CFrameWndEx 选件类检索窗格和如何设置停靠模式、窗格和窗格对齐样式。 代码是从 Word填充示例。

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

继承层次结构

CObject

   CCmdTarget

      CWnd

         CBasePane

要求

标头: afxbasepane.h

请参见

参考

层次结构图

CBasePane选件类

CWnd 类

其他资源

MFC 类