CDockablePane::GetDockingStatus

Articolo
03/05/2013

Determina la capacità di un riquadro di essere ancorata in base alla posizione specificata del puntatore.

virtual AFX_CS_STATUS GetDockingStatus(
   CPoint pt,
   int nSensitivity
);

Parametri

[in] pt
La posizione del puntatore coordinate dello schermo.
[in] nSensitivity
La distanza, in pixel, a partire dal bordo di un rettangolo il puntatore deve essere di attivare l'ancoraggio.

Valore restituito

Uno dei seguenti valori dello stato:

Valore AFX_CS_STATUS	Significato
CS_NOTHING	Il puntatore si trova in un sito di ancoraggio.Il framework non ancora il riquadro.
CS_DOCK_IMMEDIATELY	Il puntatore si trova sopra il sito di ancoraggio in modalità immediata (il riquadro utilizza DT_IMMEDIATE ancora la modalità).Il framework di nuovo il riquadro immediatamente.
CS_DELAY_DOCK	Il puntatore si trova sopra un sito di ancoraggio da un altro riquadro ancorato o da un bordo della cornice principale.Il framework di nuovo il riquadro dopo un ritardo.Vedere la sezione relativa alle osservazioni per ulteriori informazioni su questo ritardo.
CS_DELAY_DOCK_TO_TAB	Il puntatore si trova sopra un sito di ancoraggio quale lo stato a essere ancorato in una finestra a schede.Ciò si verifica quando il puntatore si trova sopra la barra del titolo di un altro riquadro ancorato o sull'area della scheda del riquadro a schede.

Note

Il framework chiama questo metodo per la gestione dell'ancoraggio di un riquadro mobile.

Per le barre degli strumenti mobili o riquadri ancorati che utilizzano DT_IMMEDIATE ancora la modalità, il framework ritarda il comando di ancoraggio consentire all'utente di spostare la finestra area client del frame padre prima che l'aggancio si verifichi.La lunghezza del ritardo è calcolata in millisecondi ed è controllato dal membro dati di. CDockingManager::m_nTimeOutBeforeToolBarDock.Il valore predefinito di CDockingManager::m_nTimeOutBeforeToolBarDock è 200.Questo comportamento emula il comportamento di ancoraggio Microsoft Word 2007.

Per ancorare ritardata gli stati (CS_DELAY_DOCK e CS_DELAY_DOCK_TO_TAB), il framework non esegue l'ancoraggio finché l'utente non rilasciare il pulsante del mouse.Se un riquadro utilizza DT_STANDARD ancora la modalità, il framework visualizzare un rettangolo alla posizione di ancoraggio proiettate.Se un riquadro utilizza DT_SMART ancora la modalità, il framework visualizzare marcatori intelligenti di ancoraggio e rettangoli semitrasparenti la posizione di ancoraggio proiettate.Per specificare la modalità di ancoraggio per il riquadro, chiamare il metodo CBasePane::SetDockingMode.Per ulteriori informazioni su ancoraggio intelligenti, vedere CDockingManager::GetSmartDockingParams.