On Drag Over
| Code | Puede ser llamado por | Definición |
|---|---|---|
| 21 | Área 4D Write Pro - Botón - Rejilla de botones - Casilla de selección - Lista desplegable - Lista jerárquica - Área de entrada -List Box - Columna de List Box - Botón imagen - Imagen del menú emergente - Área de plug-in - Indicador de progreso - Botón radio - Regla -Spinner - Splitter - Stepper - Pestaña | Los datos se pueden soltar en un objeto |
Descripción
El evento On Drag Over se envía repetidamente al objeto de destino cuando el puntero del ratón se mueve sobre el objeto. Normalmente, en respuesta a este evento:
- Obtenga los datos y las firmas que se encuentran en portapapeles (mediante el comando
GET PASTEBOARD DATA). - Según la naturaleza y el tipo de datos en el portapapeles, se acepta o rechaza el arrastrar y soltar.
Para aceptar el arrastre, el método del objeto destino debe devolver 0 (cero), por lo que se escribe $0:=0. Para rechazar el arrastre, el método del objeto debe devolver -1 (menos uno), por lo que se escribe $0:=-1. Durante un evento On Drag Over, 4D trata el método objeto como una función. Si no se devuelve ningún resultado, 4D asume que el arrastre es aceptado.
Si acepta el arrastre, el objeto de destino se resalta. Si rechaza el arrastre, el destino no se resalta. Aceptar el arrastre no significa que los datos arrastrados vayan a ser insertados en el objeto de destino. Esto sólo significa que si se soltara el botón del ratón en este punto, el objeto de destino aceptaría los datos arrastrados y se dispararía el evento On Drop.
Si no se procesa el evento On Drag Over para un objeto soltable, ese objeto será resaltado para todas las operaciones de arrastre, sin importar la naturaleza y el tipo de los datos arrastrados.
El evento On Drag Over es el medio por el que se controla la primera fase de una operación de arrastrar y soltar. No sólo puede probar si los datos arrastrados son de un tipo compatible con el objeto de destino, y luego aceptar o rechazar el arrastre; puede notificar simultáneamente al usuario de este hecho, porque 4D resalta (o no) el objeto de destino, basándose en su decisión.
El código que maneja un evento On Drag Over debe ser corto y ejecutarse rápidamente, porque ese evento se envía repetidamente al objeto de destino actual, debido a los movimientos del ratón.