Controls.TControl.OnStartDrag
Contents |
Informations Delphi
De Controls.pas
property OnStartDrag: TStartDragEvent read FOnStartDrag write FOnStartDrag;
Unité : Controls
Type : événement
Visibilité : protected
Membre de : TControl
Informations C++
De Controls.hpp
__property TStartDragEvent OnStartDrag;
Unité : Controls
Type : propriété
Visibilité : protected
Membre de : 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énement 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énement OnStartDrag peut créer une instance de TDragControlObject 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énement 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.