On Drag Over
| Code | Peut être appelé par | Définition |
|---|---|---|
| 21 | Zone 4D Write Pro - Bouton - Grille de boutons - Case à cocher - Dropdown list - Form - Liste hiérarchique - Input - List Box - List Box Column - Bouton image - Pop up menu image - Zone de Plug-in - Progress Indicators - Radio Button - Ruler - Spinner - Splitter - Stepper - Onglet | Les données peuvent être déposées sur un objet |
Description
L'événement On Drag Over est envoyé à plusieurs reprises à l'objet de destination lorsque le pointeur de la souris est déplacé sur l'objet. Généralement, en réponse à cet événement :
- Vous récupérez les données et les signatures présentes dans le conteneur (via la commande
GET PASTEBOARD DATA). - En fonction de la nature et du type de données dans le conteneur, vous acceptez ou refusez le glisser-déposer.
To accept the drag, the destination object method must return 0 (zero).
To reject the drag, the object method must return -1 (minus one).
Lors d'un événement On Drag Over, 4D traite la méthode objet comme une fonction. Si aucun résultat n'est retourné, 4D suppose que le glissement est accepté.
Si vous acceptez le glissement, l'objet de destination est mis en surbrillance. Si vous refusez le glissement, la destination n'est pas mise en surbrillance. Accepter le glissement ne signifie pas que les données déplacées vont être insérées dans l'objet de destination. Cela signifie seulement que si le bouton de la souris était relâché à ce stade, l'objet de destination accepterait les données glissées et l'événement On Drop` serait déclenché.
Si vous ne traitez pas l'événement On Drag Over pour un objet déposable, cet objet sera mis en surbrillance pour toutes les opérations de glissement, quels que soient la nature et le type des données déplacées.
L'événement On Drag Over est le moyen par lequel vous contrôlez la première phase d'une opération de glisser-déposer. Vous pouvez non seulement tester si les données déplacées sont d'un type compatible avec l'objet de destination, puis accepter ou rejeter le glissement; vous pouvez simultanément avertir l'utilisateur de ce fait, car 4D met en évidence (ou non) l'objet de destination, en fonction de votre décision.
Le code gérant un événement On Drag Over doit être court et s'exécuter rapidement, car cet événement est envoyé à plusieurs reprises à l'objet de destination courant, en raison des mouvements de la souris.
Exemple
//Destination object method
#DECLARE : Integer
If(Form event code=On Drag Over)
//returns 0 by default
...
If($DataType=Is picture)
return -1
End if
...
End if