Aller au contenu principal
Version: Suivant

On Begin Drag Over

CodePeut être appelé parDéfinition
174D Write Pro area - Button - Button Grid - Check Box - Dropdown list - Form - 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 controlUn 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 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 glisser via le résultat de la méthode de l'objet déplacé.
    • Pour indiquer que les actions de glisser sont acceptées, la méthode de l'objet source doit retourner 0 (zéro).
    • Pour indiquer que les actions de glisser sont refusées, la méthode de l'objet source doit retourner -1.
    • Si aucun résultat n'est retourné, 4D considère que les actions de glisser 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 glisser automatique, le texte glissé se trouve déjà dans le conteneur lorsque l'événement est appelé.