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