DragPrivate()

Syntaxe

Resultat = DragPrivate(Type [, Actions])
Description
Lance une opération de 'Drag & Drop' limitée à l'appicaton elle-même.

Arguments

Type La valeur qui identifiera la donnée à déposer dans l'application.

N'importe quelle valeur de type Long (.l) est utilisable.

La même valeur devra être spécifiée à EnableGadgetDrop() ou EnableWindowDrop() pour les Gadgets/ Fenêtres qui accepteront cette donnée.

Cela permet de définir avec exactitude quel Gadget/Fenêtre acceptera tel type de données, et ainsi de réaliser des schémas 'Drag & Drop' complexes.
Actions (optionnel) Si ce paramètre est omis, #PB_Drag_Copy sera utilisé comme valeur par défaut.

Peut être une combinaison de:
  #PB_Drag_Copy: Le texte peut être copié
  #PB_Drag_Move: Le texte peut être déplacé
  #PB_Drag_Link: Le texte peut être lié
L'utilisateur peut décider de l'action à prendre en utilisant les touches Ctrl ou Shift. Les actions disponibles dépendent aussi du composant sur lequel le texte va être déposé.

Valeur de retour

Renvoie une des valeurs 'Actions' pour indiquer laquelle a été choisie par l'utilisateur, ou #PB_Drag_None si le 'Drag & Drop' a été annulé.

Si l'opération n'a pas été annulée, la boucle d'évènement recevra #PB_Event_WindowDrop ou #PB_Event_GadgetDrop de type #PB_Drop_Private.

Remarques

Contrairement aux autres commandes qui démarrent un 'Drag & Drop', la donnée ne pourra être déposée qu'au sein de l'application (les données transférées avec les commandes telles que DragText() ou DragImage() peuvent aussi être acceptés par les autres applications). Cette commande permet d'ajouter des fonctionnalités de 'Drag & Drop' entre les Gadgets ou les Fenêtres en utilisant des données qui ne seraient pas interprétables par d'autres applications.

Un 'Drag & Drop' peut être démarré n'importe quand, mais il faut que le bouton gauche de la souris soit appuyé sinon l'opération se terminera immédiatement. Le moment le plus approprié pour lancer un 'Drag & Drop' est en réponse à un évènement sur un Gadget avec un EventType() valant #PB_EventType_DragStart.

Si l'opération n'a pas été interrompue, la boucle d'événements recevra un événement #PB_Event_WindowDrop ou #PB_Event_GadgetDrop de type #PB_Drop_Private.

Voir aussi

DragText(), DragImage(), DragFiles(), DragOSFormats(), SetDragCallback()

OS Supportés

Windows, Linux

<- DragOSFormats() - DragDrop Index - DragText() ->