CDockablePane::GetDockingStatus

Článek
03/04/2013

Určuje schopnost podokno ukotvit na základě poskytnutého ukazatel umístění.

virtual AFX_CS_STATUS GetDockingStatus(
   CPoint pt,
   int nSensitivity
);

Parametry

[v]pt
Umístění ukazatele v obrazovkových souřadnicích.
[v]nSensitivity
Vzdálenost v pixelech, od okraje obdélníku musí být ukazatel umožní dokování.

Vrácená hodnota

Jedna z následujících hodnot stavu:

AFX_CS_STATUShodnota	Význam
CS_NOTHING	Ukazatel není nad dock webu.Rozhraní není ukotvit podokno.
CS_DOCK_IMMEDIATELY	Je ukazatel umístěn web ukotvit v bezprostřední režimu (v podokně používá DT_IMMEDIATE dokovací režimu).Rámci ukotvené podokno ihned.
CS_DELAY_DOCK	Je ukazatel nad dock web, který je jiného ukotvení podokna nebo okraj hlavního rámce.Rámci ukotvené podokno po prodlevě.Další informace o tomto zpoždění v části poznámky.
CS_DELAY_DOCK_TO_TAB	Ukazatel myši je umístěn nad dock web, který způsobuje podokno ukotvit v okně s kartami.K tomu dochází, když je ukazatel umístěn nad titulek jiného ukotvení podokna nebo přes oblast kartu podokno s kartami.

Poznámky

Rámci volání této metody zpracování ukotvení plovoucího podokna.

Plovoucí panely nástrojů nebo ukotvení příček, které používají DT_IMMEDIATE rámci docking režimu, zpoždění příkaz dok uživateli umožňuje přesunutí okna klienta oblast nadřazený rámec před docking.Délku zpoždění je udávána v milisekundách a řídí CDockingManager::m_nTimeOutBeforeToolBarDock datový člen..Výchozí hodnota CDockingManager::m_nTimeOutBeforeToolBarDock je 200.Toto chování emuluje chování dokovací 2007.

Pro docking státy zpoždění ( CS_DELAY_DOCK a CS_DELAY_DOCK_TO_TAB ), rámci neprovádí docking, dokud uživatel uvolní tlačítko myši.Pokud podokno se používá DT_STANDARD docking režimu, rámci zobrazí obdélník předpokládané dokovací umístění.Pokud podokno se používá DT_SMART docking režimu, rámci zobrazí inteligentní značky ukotvení a poloprůhledné obdélníky předpokládané dokovací umístění.Určení dokovací režimu pro podokno, zavolejte CBasePane::SetDockingMode metoda.Další informace o inteligentní docking, viz CDockingManager::GetSmartDockingParams.