CDockablePane::GetDockingStatus

Artykuł
02/27/2013

Określa możliwość być zadokowane okienko na podstawie wskaźnik podanej lokalizacji.

virtual AFX_CS_STATUS GetDockingStatus(
   CPoint pt,
   int nSensitivity
);

Parametry

[w]pt
Położenie wskaźnika zgodnie ze współrzędnymi ekranowymi.
[w]nSensitivity
W pikselach, odległość od krawędzi prostokąta wskaźnik musi być umożliwiające dokowanie.

Wartość zwracana

Jedną z następujących wartości stanu:

AFX_CS_STATUSwartość	Znaczenie
CS_NOTHING	Kursor nie znajduje się nad witryny stacji dokującej.Ramy nie zadokować okienko.
CS_DOCK_IMMEDIATELY	Wskaźnik znajduje się nad witryną dokowania w trybie bezpośrednim (korzysta z okienka DT_IMMEDIATE tryb dokującej).Ramy dokowane okienka natychmiast.
CS_DELAY_DOCK	Kursor umieszczony nad innego okienka dokowania lub krawędź ramki główne witryny stacji dokującej.Ramy dokowane okienka z opóźnieniem.Aby uzyskać więcej informacji dotyczących tego opóźnienia w sekcji Uwagi.
CS_DELAY_DOCK_TO_TAB	Za pośrednictwem witryny stacji dokującej, powodujący okienka, aby być dokowany w kartach okna znajduje się wskaźnik.Dzieje się tak, gdy kursor znajduje się nad podpis innego okienka dokowania lub nad obszarem kartę okienko z kartami.

Uwagi

Ramach wywołania tej metody do obsługi Dokowanie okienka przestawne.

Przestawne paski narzędzi lub Dokowanie okienka, które używają DT_IMMEDIATE dokowanie trybu, ramy opóźnia polecenie Zadokuj umożliwiające użytkownikowi przenoszenie okna z obszaru klienta ramki macierzystej przed wystąpieniem dokowania.Długość opóźnienia jest mierzony w milisekundach i kontrolowane przez CDockingManager::m_nTimeOutBeforeToolBarDock elementu danych.Wartość domyślna, CDockingManager::m_nTimeOutBeforeToolBarDock 200.To zachowanie emuluje zachowanie dokowania Microsoft Word 2007.

Dla opóźnione dokowanie Państwa (CS_DELAY_DOCK i CS_DELAY_DOCK_TO_TAB), ramy nie wykonuje dokowania, dopóki użytkownik zwolni przycisk myszy.Jeśli okienko używa DT_STANDARD ramach dokowanie trybu, wyświetla prostokąt przewidywane lokalizacji dokowania.Jeśli okienko używa DT_SMART dokowanie trybu, ramy Wyświetla inteligentne znaczników dokowania i prostokąty półprzezroczyste przewidywane miejsce dokowania.Aby określić tryb dokowania swoje okienko, call CBasePane::SetDockingMode metody.Aby uzyskać więcej informacji na temat dokowanie inteligentne Zobacz CDockingManager::GetSmartDockingParams.