Événement TextBox.DblClick (Access)

L'événement DblClick se produit lorsque l'utilisateur appuie puis relâche le bouton gauche de la souris deux fois de suite sur un objet dans le temps imparti par le système.

Syntaxe

expression. DblClick (Annuler)

Expression Variable qui représente un objet TextBox .

Parameters

Nom	Requis/Facultatif	Type de données	Description
Cancel	Obligatoire	Entier	Le paramètre détermine si l'événement DblClick se produit. La définition de l’argument Cancel sur True (1) annule l’événement DblClick .

Remarques

Sur un formulaire, l'événement DblClick se produit lorsque l'utilisateur double-clique sur une zone vide ou un sélecteur d'enregistrement du formulaire. Pour un contrôle, il se produit lorsque l'utilisateur double-clique sur un contrôle ou sur son étiquette en mode formulaire. L'événement DblClick se produit lorsque l'utilisateur double-clique sur le formulaire ou le contrôle, mais avant que le résultat du double action se produit (par exemple, avant que Microsoft Access ne sélectionne le mot sur lequel le point d'insertion dans une zone de texte).

Cet événement ne s'applique pas aux cases à cocher, cases d'option, boutons bascule d'un groupe d'options. Il s'applique uniquement au groupe d'options lui-même.

Cet événement ne s’applique pas à une étiquette attachée à un autre contrôle, comme l’étiquette d’une zone de texte. Il ne s'applique qu'aux étiquettes « autonomes ». Le double-clic sur une étiquette jointe a le même effet que de double-cliquer sur le contrôle associé. Les événements normaux du contrôle se produisent, mais pas les événements de l’étiquette jointe.

Pour exécuter une macro ou une procédure événementielle lorsque cet événement se produit, définissez la propriété OnDblClick sur le nom de la macro ou sur [Procédure événementielle].

Pour certains contrôles, le fait de double-cliquer engendre un résultat spécifique au contrôle. Par exemple, si vous double-cliquez sur un mot dans une zone de texte, l'ensemble du mot est sélectionné. Si vous double-cliquez sur un contrôle contenant un objet OLE, l'application ayant créé l'objet s'ouvre pour vous permettre de le modifier.

Si l'événement DblClick ne se produit pas dans le temps imparti par le système, le formulaire, la section de formulaire ou le contrôle reconnaît deux événements Click au lieu d'un seul événement DblClick. La limite de temps de double-clic dépend du paramètre sous Vitesse de double-clic sous l’onglet Boutons de l’option Souris du Panneau de configuration Windows.

En exécutant une macro ou une procédure événementielle lorsque l'événement DblClick se produit, vous pouvez ouvrir une fenêtre ou un document lorsque l'utilisateur double-clique sur une icône.

En double-cliquant sur un contrôle génère les événements Click et de DblClick se produise. Si le contrôle n'a pas le focus lorsque vous double-cliquez dessus, l' entrée et les événements GotFocus du contrôle surviennent avant les événements Click et DblClick.

Pour les objets recevant des événements de souris, ceux-ci se produisent dans l'ordre suivant :

MouseDown → MouseUp → Click → DblClick

Lorsque vous double-cliquez sur un bouton de commande, les événements suivants se produisent dans cet ordre :

MouseDown → MouseUp → Click → DblClick → MouseUp → Click

Le second clic ne peut avoir aucun effet (par exemple, si la macro ou procédure événementielle Click ouvre une boîte de dialogue modale en réponse au premier événement Click ). Pour empêcher l’exécution de la deuxième macro ou procédure événementielle Click , placez une action CancelEvent dans la macro DblClick ou utilisez l’argument Cancel dans la procédure événementielle DblClick . Notez que, en règle générale, en double-cliquant sur un bouton de commande doit être déconseillée.

Si vous double-cliquez sur tout contrôle autre qu'un bouton de commande, le second événement Click ne se produit.

Exemple

L'exemple suivant montre comment vous pouvez utiliser une procédure événementielle DblClick pour ouvrir un formulaire qui affiche les enregistrements de la table qui est la source de ligne d'une zone de liste déroulante. Lorsque l’utilisateur double-clique sur la zone de liste modifiable Vendeur dans un formulaire Commandes , le formulaire Employés s’affiche, affichant l’enregistrement de l’employé sélectionné dans la zone de liste déroulante.

Pour essayer l’exemple, ajoutez la procédure événementielle suivante à un formulaire nommé Commandes qui contient une zone de liste modifiable nommée EmployeeID. La zone de liste déroulante doit avoir comme source de ligne la même table que la source du formulaire Employés (ou une requête basée sur cette table).

Private Sub EmployeeID_DblClick(Cancel As Integer) 
 DoCmd.OpenForm "Employees", , , _ 
 "EmployeeID = Forms!Orders!EmployeeID" 
End Sub

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.