CDockablePane::GetDockingStatus

Article
06/10/2015

Détermine la capacité d'un volet d'être ancré en fonction de l'emplacement fourni de pointeur.

virtual AFX_CS_STATUS GetDockingStatus(
   CPoint pt,
   int nSensitivity
);

Paramètres

[in] pt
l'emplacement du pointeur dans l'écran coordonne.
[in] nSensitivity
La distance, en pixels, quitte le bord d'un rectangle le pointeur doit être d'activer l'ancrage.

Valeur de retour

L'une des valeurs suivantes en mode :

Valeur de AFX_CS_STATUS	Signification
CS_NOTHING	Le pointeur n'est pas sur un site d'ancrage. L'infrastructure n'ancre pas le volet.
CS_DOCK_IMMEDIATELY	Le pointeur se trouve sur le site d'ancrage en mode immédiat (le volet utilise DT_IMMEDIATE ancrage mode). L'infrastructure ancre le volet immédiatement.
CS_DELAY_DOCK	Le pointeur se trouve sur un site d'ancrage qui est un autre volet d'ancrage ou est un bord du frame principal. L'infrastructure ancre le volet après un délai. Consultez la section Notes pour plus d'informations sur ce délai.
CS_DELAY_DOCK_TO_TAB	Le pointeur se trouve sur un site d'ancrage qui provoque le volet d'être ancré dans une fenêtre avec onglets. Cela se produit lorsque le pointeur se trouve sur la légende d'un autre volet d'ancrage ou sur la zone de tabulation d'un volet à onglets.

Notes

l'infrastructure appelle cette méthode pour gérer l'ancrage d'un volet flottant.

Pour les barres d'outils flottante ou les volets d'ancrage qui utilisent DT_IMMEDIATE ancrage mode, l'infrastructure retarde la commande d'ancrage de permettre à l'utilisateur de déplacer la fenêtre en dehors de la zone cliente du frame parent avant d'amarrage se produise. La longueur du runtime est mesuré en millisecondes et est contrôlée par le membre de CDockingManager::m_nTimeOutBeforeToolBarDock . La valeur par défaut de CDockingManager::m_nTimeOutBeforeToolBarDock est 200. Ce comportement émule le comportement d'ancrage d' Microsoft Word 2007.

Pour ancrer différé des rapports (CS_DELAY_DOCK et CS_DELAY_DOCK_TO_TAB), l'infrastructure ne s'exécute pas l'ancrage jusqu'à ce que l'utilisateur relâche le bouton de la souris. Si un volet d'ancrage DT_STANDARD utilise le mode, l'infrastructure affiche un rectangle à l'emplacement d'ancrage projeté. Si un volet d'ancrage DT_SMART utilise le mode, l'infrastructure affiche le intelligentes d'ancrage et des rectangles semi-transparents à l'emplacement d'ancrage projeté. Pour spécifier le mode d'ancrage de votre volet, appelez la méthode de CBasePane::SetDockingMode . Pour plus d'informations sur l'ancrage BITS, consultez CDockingManager::GetSmartDockingParams.