Saltar al contenido principal
Versión: v20 R4 BETA

On Begin Drag Over

CodePuede ser llamado porDefinición
17Área 4D Write Pro - Botón - Rejilla de botones - Casilla de selección - Lista desplegable - Formulario - Lista jerárquica - Área de entrada - List Box - Columna List Box - Botón imagen - Pop up menu image - Área de plug-in - Indicador de progreso - Botón radio - Regla - Spinner - Splitter - Stepper - PestañaSe 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 de 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.