Vcl.Controls.TControl.OnStartDrag

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property OnStartDrag: TStartDragEvent read FOnStartDrag write FOnStartDrag;

C++

__property TStartDragEvent OnStartDrag = {read=FOnStartDrag, write=FOnStartDrag};

Propriétés

Type Visibilité  Source Unité  Parent
event protected
Vcl.Controls.pas
Vcl.Controls.hpp
Vcl.Controls TControl

Description

Se produit lorsque l'utilisateur commence à faire glisser le contrôle ou un objet qu'il contient en cliquant dessus avec le bouton gauche de la souris et en maintenant enfoncé le bouton gauche de la souris.

Utilisez le gestionnaire d'événements OnStartDrag pour effectuer des actions spécifiques lorsque l'utilisateur commence à faire glisser le contrôle ou un objet qu'il contient. OnStartDrag ne se produit que si DragKind a la valeur dkDrag.

Sender est le contrôle que l'utilisateur fait glisser ou contenant l'objet que l'utilisateur fait glisser.

Le gestionnaire d'événements OnStartDrag peut créer une instance de TDragControlObjectEx pour le paramètre DragObject afin de spécifier le curseur à utiliser pour le glissement ou, de manière facultative, une liste d'images de glissement. Si vous créez une instance de TDragControlObjectEx, il n'est pas nécessaire d'appeler la méthode Free pour l'objet DragObject quand s'achève le glissement. Si, à la place, vous créez une instance de TDragControlObject, votre application est responsable de la libération de l'instance de l'objet déplacement.

Si le gestionnaire d'événements OnStartDrag affecte la valeur nil (Delphi) ou NULL (C++) au paramètre DragObject, un objet TDragControlObject est automatiquement créé et le glissement commence sur le contrôle même.

Remarque : Sur certains contrôles, comme TRichEdit, le contrôle Windows sous-jacent gère des opérations de glissement internes. Pour ces contrôles, il n'existe pas d'événement OnStartDrag ou OnEndDrag pour les opérations de glissement à l'intérieur du contrôle.

OnStartDrag est un gestionnaire d’événements du type TStartDragEvent.

Voir aussi