CDockablePane::GetDockingStatus
Bestimmt die Fähigkeit eines Bereichs, anhand des bereitgestellten Zeigerposition angedockt werden.
virtual AFX_CS_STATUS GetDockingStatus(
CPoint pt,
int nSensitivity
);
Parameter
[in] pt
Die Position des Zeigers in Bildschirmkoordinaten.[in] nSensitivity
Der Abstand, in Pixel, vom dem Rand eines Rechtecks der Zeiger muss, das Andocken zu aktivieren sein.
Rückgabewert
Einer der folgenden Statuswerte:
AFX_CS_STATUS-Wert |
Bedeutung |
|---|---|
CS_NOTHING |
Der Zeiger ist nicht über eine Docksite.Das Framework dockt nicht den Bereich an. |
CS_DOCK_IMMEDIATELY |
Der Mauszeiger befindet sich über der Docksite im aktuellen Modus (der Bereich verwendet den Andockmodus DT_IMMEDIATE ).Das Framework dockt den Bereich sofort an. |
CS_DELAY_DOCK |
Der Zeiger wird über einer Docksite, die ein anderer Andocker Bereich ist oder ein Rand des Großrechners ist.Das Framework dockt den Bereich nach einer Verzögerung an.Weitere Informationen finden Sie in den Hinweisen weitere Informationen zu diesen Verzögerung. |
CS_DELAY_DOCK_TO_TAB |
Der Mauszeiger befindet sich über eine Docksite, die den Bereich wird, in einem Fenster angedockt werden im Registerkartenformat.Dies tritt auf, wenn der Mauszeiger über der Beschriftung eines anderen Andocken Bereichs oder im Registerkartenbereich einer Seite im Registerformat befinden. |
Hinweise
Das Framework ruft diese Methode auf, um das Andocken eines unverankerten Bereichs zu behandeln.
Bei beweglichen andockbare Symbolleisten oder Bereiche, die den Andockmodus DT_IMMEDIATE verwenden, verzögert das Framework den Dockbefehl, dem Benutzer zu ermöglichen, um das Fenster aus dem Innenbereich des übergeordneten Frames auschecken, bevor das Andocken zu verschieben auftritt.Die Länge der Verzögerung wird in Millisekunden gemessen und wird vom CDockingManager::m_nTimeOutBeforeToolBarDock Datenmember. gesteuert.Der Standardwert von CDockingManager::m_nTimeOutBeforeToolBarDock ist 200 (null).Dieses Verhalten emuliert das Andockverhalten von Microsoft Word 2007.
Für verzögerte angedockte Zustände (CS_DELAY_DOCK und CS_DELAY_DOCK_TO_TAB), übergibt das Framework nicht Andocken aus, bis der Benutzer die Maustaste loslässt.Wenn ein Bereich den Andockmodus DT_STANDARD verwendet, wird das Framework ein Rechteck am hervorstehenden Andockposition an.Wenn ein Bereich den Andockmodus DT_SMART verwendet, wird das Framework intelligente andockbare Markierung und semitransparente Rechtecke am hervorstehenden Andockposition an.Um den Andockmodus für den Bereich anzugeben, rufen Sie die CBasePane::SetDockingMode-Methode auf.Weitere Informationen zu intelligente Andocken, finden Sie unter CDockingManager::GetSmartDockingParams.
Anforderungen
Header: afxdockablepane.h