Aller au contenu principal
Version: v20

On Begin Drag Over

CodePeut être appelé parDéfinition
17Zone 4D WritePro - Bouton - Grille de boutons - Case à cocher - Liste déroulante - Formulaire - Liste hiérarchique - Zone de saisie - List Box - Colonne List Box - Bouton image - Pop up menu image - Zone de plug-in - Indicateur de progression - Bouton radio - Règle - Spinner - Splitter - Stepper - OngletUn objet est en cours de déplacement

Description

L'événement de formulaire On Begin Drag Over peut être sélectionné pour tous les objets formulaire pouvant être déplacés. Il est généré dans tous les cas où l'objet a la propriété Draggable. Il peut être appelé à partir de la méthode de l'objet source ou de la méthode formulaire de l'objet source.

Contrairement à l'événement de formulaire On Drag Over, On Begin Drag Over est appelé dans le contexte de l'objet source de l'action de glisser.

L'événement On Begin Drag Over est utile pour préparer l'action de glisser. Il peut être utilisé pour :

  • Ajouter des données et des signatures au conteneur (via la commande APPEND DATA TO PASTEBOARD).
  • Utiliser une icône personnalisée pendant l'action de glissement (via la commande SET DRAG ICON).
  • Accepter ou refuser le glissement via $0 dans la méthode de l'objet glissé.
    • Pour indiquer que les actions de glissement sont acceptées, la méthode de l'objet source doit retourner 0 (zéro); vous devez donc exécuter $0:=0.
    • Pour indiquer que les actions de glissement sont refusées, la méthode de l'objet source doit retourner -1 (moins un); vous devez donc exécuter $0:=-1.
    • Si aucun résultat n'est retourné, 4D considère que les actions de glissement sont acceptées.

Les données 4D sont placées dans le presse-papiers avant d'appeler l'événement. Par exemple, dans le cas d'un glissement sans l'action de glissement automatique, le texte glissé se trouve déjà dans le conteneur lorsque l'événement est appelé.