On Drag Over
| Code | Pode ser chamado por | Definição |
|---|---|---|
| 21 | 4D Write Pro area - Button - Button Grid - Check Box - Dropdown list - Hierarchical List - Input - List Box - List Box Column - Picture Button - Picture Pop up menu - Plug-in Area - Progress Indicators - Radio Button - Ruler - Spinner - Splitter - Stepper - Tab control | Os dados podem ser largados sobre um objeto |
Descrição
El evento On Drag Over se envía repetidamente al objeto de destino cuando el puntero del ratón se mueve sobre el objeto. Em resposta a este evento, normalmente:
- 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. Se nenhum resultado for devolvido, 4D assume que o arrasto é aceite.
Se aceitar o arrastamento, o objeto de destino é realçado. Se rejeitar o arrastamento, o destino não é realçado. Accepting the drag does not mean that the dragged data is going to be inserted into the destination object. It only means that if the mouse button was released at this point, the destination object would accept the dragged data and the On Drop event would be fired.
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. Not only can you test whether the dragged data is of a type compatible with the destination object, and then accept or reject the drag; you can simultaneously notify the user of this fact, because 4D highlights (or not) the destination object, based on your decision.
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.