Saltar al contenido principal
Versión: 20 R5

On Begin Drag Over

CodePuede ser llamado porDefinición
17Área 4D Write Pro - Botón - Rejilla de botones - Casilla de verificación - Lista desplegable - Formulario - Lista jerárquica - Entrada - Lista - Columna de lista - Botón con imagen - Menú emergente con imagen - Área de Plug-in - Indicadores de progreso - Botón de opción - Regla - Selector - Separador - Pasos - Control de pestañasSe está arrastrando un objeto

Descripción

El evento de formulario On Begin Drag Over puede ser seleccionado para todos los objetos formulario que puedan ser arrastrados. Se genera en todos los casos en que el objeto tiene la propiedad Draggable. Se puede llamar desde el método del objeto fuente o desde el método formulario del objeto fuente.

A diferencia del evento de formulario On Drag Over, On Begin Drag Over se llama dentro del contexto del objeto fuente de la acción arrastrar.

El evento On Begin Drag Over es útil para preparar la acción de arrastrar. Puede utilizarse para:

  • Añadir los datos y las firmas al portapapeles (vía el comando APPEND DATA TO PASTEBOARD).
  • Utilizar un icono personalizado durante la acción de arrastre (vía el comando SET DRAG ICON).
  • Aceptar o rechazar el arrastre vía $0 en el método del objeto arrastrado.
    • Para indicar que se aceptan las acciones de arrastre, el método del objeto fuente debe devolver 0 (cero); por tanto, debe ejecutar $0:=0.
    • Para indicar que se rechazan las acciones de arrastre, el método del objeto fuente debe devolver -1 (menos uno); por tanto, debe ejecutar $0:=-1.
    • Si no se devuelve ningún resultado, 4D considera que las acciones de arrastre son aceptadas.

Los datos 4D se colocan en el portapapeles antes de llamar al evento. Por ejemplo, en el caso de arrastrar sin la acción Arrastre automático, el texto arrastrado ya está en portapapeles cuando se llama al evento.