CDockablePane::GetDockingStatus

Статья
02/20/2013

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

virtual AFX_CS_STATUS GetDockingStatus(
   CPoint pt,
   int nSensitivity
);

Параметры

[входящий] pt
Расположение указателя в экранных координатах.
[входящий] nSensitivity
Расстояние (в точках) от края прямоугольника указатель должно быть включено закрепление.

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

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

Значение AFX_CS_STATUS	Значение
CS_NOTHING	Указатель находится над сайтом закрепления.Границы не закрепят панель.
CS_DOCK_IMMEDIATELY	Указатель находится над сайтом закрепления при немедленном режиме (панель используется DT_IMMEDIATE закрепляющего mode).Границы закрепят панель немедленно.
CS_DELAY_DOCK	Указатель над сайтом закрепления, другая область или край закрепления главного фрейма.Границы панель закрепят после задержки.См. раздел примeчаний дополнительные сведения об этой задержки.
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 закрепляющего режим, то границы отображаются интеллектуальные маркеры закрепления и прямоугольники semi- прозрачного на запроектированном закрепляющего расположении.Чтобы указать режим для панели закрепления, вызовите метод CBasePane::SetDockingMode.Дополнительные сведения о умной стыковке см. в разделе CDockingManager::GetSmartDockingParams.