Compartir a través de


CDockablePane::GetDockingStatus

Determina la capacidad de un panel de acoplarse basándose en la ubicación especificada del puntero.

virtual AFX_CS_STATUS GetDockingStatus(
   CPoint pt,
   int nSensitivity
);

Parámetros

  • [in] pt
    La ubicación del puntero en coordenadas de pantalla.

  • [in] nSensitivity
    La distancia, en píxeles, del borde de un rectángulo el puntero se debe habilitar el acoplamiento.

Valor devuelto

Uno de los siguientes valores de estado:

Valor de AFX_CS_STATUS

Significado

CS_NOTHING

El puntero no está sobre un sitio de vinculación. El marco no acoplar el panel.

CS_DOCK_IMMEDIATELY

El puntero se encuentra sobre el sitio de vinculación en modo inmediato (panel utiliza DT_IMMEDIATE que relaciona el modo). El marco acoplar el panel inmediatamente.

CS_DELAY_DOCK

El puntero encima de un sitio de vinculación que es otro panel acoplable o ser un borde del marco principal. El marco acoplar el panel después de un retraso. Vea la sección comentarios para obtener más información sobre este retraso.

CS_DELAY_DOCK_TO_TAB

El puntero se encuentra sobre un sitio de vinculación que genere el panel que se acoplará en una ventana con fichas. Esto se produce cuando el puntero se encuentra sobre la leyenda de otro panel acoplable o al área de la ficha de un panel con fichas.

Comentarios

El marco de trabajo llama a este método para administrar el acoplamiento de un panel flotante.

Para las barras de herramientas flotante o paneles de acoplamiento que utilizan DT_IMMEDIATE que relaciona el modo, el marco retrasa el comando de vinculación de permitir al usuario para mover la ventana fuera del área de cliente del marco primario antes de que el acoplamiento aparece. La longitud del retraso se mide en milisegundos y está controlada por el miembro de datos de CDockingManager::m_nTimeOutBeforeToolBarDock . El valor predeterminado de CDockingManager::m_nTimeOutBeforeToolBarDock es 200. Este comportamiento emula el comportamiento del acoplamiento de Microsoft Word 2007.

Para los estados de vinculación retrasados (CS_DELAY_DOCK y CS_DELAY_DOCK_TO_TAB), el marco no realiza el acoplamiento hasta el usuario suelta el botón del mouse. Si un panel utiliza DT_STANDARD que relaciona el modo, el marco muestra un rectángulo en la ubicación de acoplamiento proyectada. Si un panel utiliza DT_SMART que relaciona el modo, el marco muestra los marcadores inteligentes de acoplamiento y los rectángulos semitransparentes en la ubicación de acoplamiento proyectada. Para especificar el modo de acoplamiento del panel, llame al método de CBasePane::SetDockingMode . Para obtener más información sobre el acoplamiento inteligente, vea CDockingManager::GetSmartDockingParams.

Requisitos

encabezado: afxdockablepane.h

Vea también

Referencia

CDockablePane Class

Gráfico de jerarquías

CBasePane::SetDockingMode

CDockingManager::GetSmartDockingParams