ListBox.MatchEntry Property (Outlook Forms Script)
Renvoie ou définit une valeur de type Integer qui indique la façon dont un Contrôle ListBox recherche sa liste au fur et à mesure que l’utilisateur tape. Lecture-écriture.
Syntaxe
expression. MatchEntry
expression Variable représentant un objet ListBox.
Remarques
Les paramètres de l'argument MatchEntry sont les suivants :
| Valeur | Description |
|---|---|
| 0 | Correspondance de base. Le contrôle recherche l'entrée suivante commençant par le caractère tapé. La saisie répétée d'une même lettre entraîne le parcours cyclique de toutes les entrées qui commencent par cette lettre. |
| 1 | Correspondance étendue. Dès qu'un caractère est tapé, le contrôle recherche une entrée correspondant à tous les caractères saisis (valeur par défaut). |
| 2 | Aucune correspondance. |
La propriété MatchEntry effectue une recherche parmi les entrées à partir de la propriété TextColumn d'un contrôle ListBox ou ComboBox.
Dans la colonne identifiée par TextColumn, le contrôle recherche une entrée qui correspond à l'entrée tapée par l'utilisateur. Lors de la recherche d’une correspondance, la ligne contenant la correspondance est sélectionnée, le contenu de la colonne est affiché et le contenu de sa propriété BoundColumn devient la valeur du contrôle. Si la correspondance est non ambiguë, la recherche de la correspondance déclenche l’événement Click .
Le contrôle lance l’événement Click dès que l’utilisateur tape une séquence de caractères qui correspondent exactement à une entrée de la liste. Au cours de la frappe, l'entrée est comparée avec la ligne active puis la ligne suivante de la liste. Lorsque l'entrée correspond uniquement à la ligne active, la correspondance est non ambiguë.
C'est le cas dans Microsoft Forms, que la liste soit triée ou non. Cela signifie que le contrôle trouve la première occurrence correspondant à l'entrée, selon l'ordre des éléments de la liste. Par exemple, en entrant « abc » ou « bc », l’événement Click est lancé pour la liste suivante :
abcde
bcdef
abcxyz
bchij
Notez que dans les deux cas, l’entrée correspondante n’est pas unique ; Toutefois, il est suffisamment différent de l’entrée adjacente pour que le contrôle interprète la correspondance comme non ambiguë et lance l’événement Click .
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.