CDockablePane::GetDockingStatus
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.
Requisiti
intestazione: afxdockablepane.h