CView::OnDropEx

virtual DROPEFFECT OnDropEx ( COleDataObject * pDataObject, DROPEFFECT dropDefault, DROPEFFECT lista, CPoint punto );

Valor devuelto

El efecto de la caída que provocó desde el intento de colocar en la ubicación especificada por el punto. Este debe ser uno de los valores indicados por dropEffectList. Efectos de la caída se examinan en la sección de comentarios.

Parámetros

pDataObject

Puntos para el COleDataObject que se coloca en el destino de colocación.

dropDefault

El efecto que el usuario escogió para la operación de colocar predeterminado basada en el actual estado clave. Puede ser DROPEFFECT_NONE. Efectos de la caída se examinan en la sección de comentarios.

lista

Una lista de los efectos de la caída que admite el origen de la caída. Los valores del efecto de caída pueden combinarse mediante OR bit a bit (|) operación. Efectos de la caída se examinan en la sección de comentarios.

punto

La posición actual del ratón relativa al área de cliente de vista.

Observaciones

Llama el marco cuando el usuario suelta un objeto de datos sobre un destino válido. La implementación predeterminada es no hacer nada y devolver un valor falso (-1) para indicar que el marco debe llamar al controlador de OnDrop.

Reemplazar esta función para aplicar el efecto de un botón derecho de ratón arrastrar y colocar. Botón derecho de ratón arrastrar y soltar normalmente muestra un menú de opciones cuando se suelta el botón ratón derecho.

La anulación de OnDropEx debe consultar el botón ratón derecho. Puede llamar a GetKeyState o tienda del Estado de botón derecho de ratón desde el controlador OnDragEnter.

• Si el botón ratón derecho hacia abajo, su reemplazo debe mostrar un menú emergente que ofrece que soporte de los efectos de la caída por la fuente de caída.
  • Examinar la lista para determinar los efectos de colocar apoyados por el origen de la caída. Habilitar sólo estas acciones en el menú emergente.
    
    
  • Uso SetMenuDefaultItem para configurar la acción predeterminada basada en dropDefault.
    
    
  • Por último, tomar las medidas indicadas por la selección del usuario en el menú emergente.
• Si el botón ratón derecho no está caído, su reemplazo debe procesar esto como una solicitud de gota estándar. Utilice el efecto de caída especificado en dropDefault. Alternativamente, su reemplazo puede devolver el valor falso (-1) para indicar que OnDrop controlará esta operación de colocar.

Utilice pDataObject para examinar la COleDataObject de datos cayó en el punto especificado y formato de datos del Portapapeles.

Colocar efectos describen la acción asociada a una operación de colocar. Consulte la siguiente lista de efectos de caída:

• DROPEFFECT_&NONEnbsp;  No se permitiría una caída.
  
  
• DROPEFFECT_COPY   Podría realizarse una operación de copia.
  
  
• DROPEFFECT_MOVE   Podría realizarse una operación de movimiento.
  
  
• DROPEFFECT_LI&NKnbsp;  Se establecería un enlace de los datos perdidos a los datos originales.
  
  
• DROPEFFECT_SCROLL   Indica que una operación de desplazamiento de arrastre está a punto de ocurrir o está ocurriendo en el destino.

Para obtener más información sobre cómo establecer el comando de menú predeterminado, consulte SetMenuDefaultItem en la documentación de Win32 y CMenu::GetSafeHmenu en este volumen.

Visió&n General de CView |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambié&nnbsp;CView::OnDragEnter, CView::OnDragOver, CView::OnDrop, CView::OnDragLeave, COleDropTarget::OnDropEx