Événement BeforeDragOver
Se produit lorsqu’une opération glisser-déplacer est en cours.
Syntaxe
Pour frame
Private Subobject _BeforeDragOver( ByValCancelAs MSForms.ReturnBoolean,
ctrlEn tant que contrôle,
ByValDataAs DataObject,
ByValXAs Single,
ByValYAs Single,
ByValDragStateAs fmDragState,
ByValEffectAs MSForms.ReturnEffect,
ByValShiftAs fmShiftState)
Pour MultiPage
Private Subobject _BeforeDragOver(indexAs Long,
ByValCancelAs MSForms.ReturnBoolean,
ctrlEn tant que contrôle,
ByValDataAs DataObject,
ByValXAs Single,
ByValYAs Single,
ByValDragStateAs fmDragState,
ByValEffectAs MSForms.ReturnEffect,
ByValShiftAs fmShiftState)
Pour TabStrip
Private Subobject _BeforeDragOver(indexAs Long,
ByValCancelAs MSForms.ReturnBoolean,
ByValDataAs DataObject,
ByValXAs Single,
ByValYAs Single,
ByValDragStateAs fmDragState,
ByValEffectAs MSForms.ReturnEffect,
ByValShiftAs fmShiftState)
Pour les autres contrôles
Private Subobject _BeforeDragOver( ByValCancelAs MSForms.ReturnBoolean,
ByValDataAs DataObject,
ByValXAs Single,
ByValYAs Single,
ByValDragStateAs fmDragState,
ByValEffectAs MSForms.ReturnEffect,
ByValShiftAs fmShiftState)
La syntaxe de l’événement BeforeDragOver contient les parties suivantes :
| Élément | Description |
|---|---|
| object | Obligatoire. Un objet valide. |
| index | Obligatoire. Index de la page dans une multipage que l’opération de glisser-déplacer affectera. |
| Cancel | Obligatoire. État de l’événement. False indique que le contrôle doit gérer l’événement (valeur par défaut). True indique que l’application gère l’événement. |
| Ctrl | Obligatoire. Contrôle déplacé par glissement. |
| Données | Obligatoire. Données déplacées pendant une opération glisser-déplacer. Les données sont empaquetées dans un DataObject. |
| X, Y | Obligatoire. Coordonnées horizontales et verticales de la position du contrôle. Les deux coordonnées sont mesurées en points. X est mesuré à partir du bord gauche du contrôle, Y à partir du bord supérieur. |
| DragState | Obligatoire. État de transition des données faisant l’objet d’une opération de glissement. |
| Effect | Obligatoire. Opérations prises en charge par la source du déplacement. |
| Shift | Obligatoire. Spécifie l’état de Maj, Ctrl et Alt. |
Settings
Les paramètres pour ÉtatGlisser sont :
| Constante | Valeur | Description |
|---|---|---|
| fmDragStateEnter | 0 | Le pointeur de la souris se trouve à la portée d’une cible. |
| fmDragStateLeave | 1 | Le pointeur de la souris se trouve hors de portée d’une cible. |
| fmDragStateOver | 2 | Le pointeur de la souris se trouve dans une nouvelle position, mais reste à la portée de la même cible. |
Les paramètres pour Effet sont :
| Constante | Valeur | Description |
|---|---|---|
| fmDropEffectNone | 0 | Ne copie ni ne déplace la source du déplacement vers la cible du déplacement. |
| fmDropEffectCopy | 1 | Copie l'élément à déplacer vers la cible de dépôt. |
| fmDropEffectMove | 2 | Déplace l'élément vers la cible de dépôt. |
| fmDropEffectCopyOrMove | 3 | Copie ou déplace la source de dépôt sur la cible de dépôt. |
Les paramètres deShift sont les suivants :
| Constante | Valeur | Description |
|---|---|---|
| fmShiftMask | 1 | La touche Maj a été enfoncée. |
| fmCtrlMask | 2 | La touche Ctrl a été enfoncée. |
| fmAltMask | 4 | La touche Alt a été enfoncée. |
Remarques
Utilisez cet événement pour surveiller le pointeur de la souris lorsqu’il entre, quitte ou reste dans une cible valide. Lorsqu’une opération glisser-déplace est en cours, le système initie cet événement lorsque l’utilisateur déplace la souris, ou appuie ou relâche le ou les boutons de la souris. La position du pointeur de la souris détermine l’objet cible qui reçoit cet événement. Vous pouvez déterminer l’état du pointeur de la souris en examinant l’argument ÉtatGlisser.
Lorsqu’un contrôle gère cet événement, vous pouvez utiliser l’argument Effet pour identifier l’opération glisser-déplacer à effectuer.
Lorsque l’argument Effet est défini sur fmDropEffectCopyOrMove, la source du déplacement prend en charge une opération de copie (fmDropEffectCopy), de déplacement (fmDropEffectMove) ou d’annulation (fmDropEffectNone).
Lorsque l’argument Effet est défini sur fmDropEffectCopy, la source du déplacement prend en charge une opération de copie ou d’annulation (fmDropEffectNone).
Lorsque l’argument Effet est défini sur fmDropEffectMove, la source du déplacement prend en charge une opération de déplacement ou d’annulation (fmDropEffectNone).
Quand Effect est défini sur fmDropEffectNone, la source de suppression prend en charge une opération d’annulation.
La plupart des contrôles ne prennent pas en charge le glisser-déplacer, tandis que Cancel a la valeur False, qui est le paramètre par défaut. Cela signifie que le contrôle rejette les tentatives de glisser-déplacer quelque chose sur le contrôle, et que le contrôle ne lance pas l’événement BeforeDropOrPaste. Les contrôles TextBox et ComboBox sont des exceptions à ce problème; ces contrôles prennent en charge les opérations de glisser-déplacer même lorsque Cancel a la valeur False.
Voir aussi
Assistance et commentaires
Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.