Share via


CView::OnDragEnter

Llamado por el marco cuando el mouse primero entra en la región de no-movimiento en sentido vertical de la ventana de destino.

virtual DROPEFFECT OnDragEnter(
   COleDataObject* pDataObject,
   DWORD dwKeyState,
   CPoint point 
);

Parámetros

  • pDataObject
    Señala COleDataObject que se está arrastrando en el área de colocación de la vista.

  • dwKeyState
    Contiene el estado de las teclas modificadoras.Ésta es una combinación de cualquier número de siguiente: MK_CONTROL, MK_SHIFT, MK_ALT, MK_LBUTTON, MK_MBUTTON, y MK_RBUTTON.

  • point
    La posición actual del mouse en relación con el área cliente de la vista.

Valor devuelto

Un valor de tipo enumerado de DROPEFFECT , que indica el tipo de entrega que se produciría si el usuario quitado el objeto en esta posición.El tipo de entrega depende normalmente de estado clave actual indicada por dwKeyState.una asignación estándar de keystates a los valores de DROPEFFECT es:

  • El objeto de datos deDROPEFFECT_NONE no se puede quitar de esta ventana.

  • DROPEFFECT_LINK para MK_CONTROL | MK_SHIFT crea una correspondencia entre el objeto y el servidor.

  • DROPEFFECT_COPY para MK_CONTROL crea una copia del objeto eliminado.

  • DROPEFFECT_MOVE para MK_ALT crea una copia del objeto quitado y elimine el objeto original.Normalmente es el efecto predeterminado de entrega, cuando la vista puede aceptar este objeto de datos.

Para obtener más información, vea MFC avanzada de ejemplo OCLIENTde los conceptos.

Comentarios

la implementación predeterminada es no hacer nada y devolver DROPEFFECT_NONE.

Invalide esta función para preparar las llamadas posteriores a la función miembro de OnDragOver .Los datos necesarios del objeto de datos debe recuperarse en este momento para su uso posterior en la función miembro de OnDragOver .La vista también se debe actualizar en esta hora de ofrecer al usuario información de representación visual.Para obtener más información, vea el artículo Arrastrar y colocar: implementar un destino.

Requisitos

encabezado: afxwin.h

Vea también

Referencia

Clase CView

Gráfico de jerarquía

CView::OnDragOver

CView::OnDrop

CView::OnDropEx

CView::OnDragLeave

COleDropTarget::OnDragEnter