CDockablePane::GetDockingStatus
确定窗格的能力停靠根据提供的指针位置。
virtual AFX_CS_STATUS GetDockingStatus(
CPoint pt,
int nSensitivity
);
参数
[in] pt
指针在屏幕上的位置的坐标。[in] nSensitivity
距离，以像素为单位，其中矩形的边缘指针必须是启用停靠。
返回值
以下状态值之一：
AFX_CS_STATUS 值 |
含义 |
|---|---|
CS_NOTHING |
指针不在停靠站点。 框架不停靠窗格。 |
CS_DOCK_IMMEDIATELY |
指针在停靠网站位于即时模式(窗格使用停靠模式)的 DT_IMMEDIATE。 框架立即停靠窗格。 |
CS_DELAY_DOCK |
指针位于另一个停靠窗格或作为主框架的边缘的停靠站点。 框架在延迟后停靠窗格。 请参见"备注"部分有关此延迟的更多信息。 |
CS_DELAY_DOCK_TO_TAB |
指针定位在一个选项卡式窗口会导致窗格停靠的停靠站点。 当指针位于另一个停靠窗格的声明或在一个选项卡式窗格中的选项卡区域时，将发生这种情况。 |
备注
框架调用此方法以一个浮动窗格的处理停靠。
对于使用停靠模式的 DT_IMMEDIATE 的浮动工具栏或停靠窗格，框架延迟停靠命令使用户能够移动窗口移出父级框架的工作区，在停靠发生之前。 延迟的长度以毫秒为单位度量和由 CDockingManager::m_nTimeOutBeforeToolBarDock 数据成员控件的。 CDockingManager::m_nTimeOutBeforeToolBarDock 的默认值为 200。 此行为模拟 Microsoft Word 停靠行为2007。
对于延迟停靠状态(CS_DELAY_DOCK 和 CS_DELAY_DOCK_TO_TAB)，则框架不执行停靠，直到用户释放鼠标按钮。 如果窗格使用停靠模式的 DT_STANDARD，框架在项目的停靠的位置显示矩形。 如果窗格使用停靠模式的 DT_SMART，框架在项目的停靠的位置显示智能标记停靠和半透明的矩形。 为您的窗格若要指定停靠模式，请调用 CBasePane::SetDockingMode 方法。 有关智能停靠的更多信息，请参见 CDockingManager::GetSmartDockingParams。
要求
标头: afxdockablepane.h