FileDialogFilters.Add, méthode (Office)

  • Article

Ajoute un nouveau filtre de fichiers à la liste des filtres dans la liste déroulante Fichiers de type dans la boîte de dialogue Fichier . Elle renvoie un objet FileDialogFilter qui représente le filtre de fichier nouvellement ajouté.

Syntaxe

expression. Ajouter (Description, Extensions, Position)

expression Obligatoire. Variable qui représente un objet FileDialogFilters .

Parameters

Nom Requis/Facultatif Type de données Description
Description Requis String Texte représentant la description de l’extension de nom de fichier que vous souhaitez ajouter à la liste des filtres.
Extensions Requis String Texte représentant l’extension de nom de fichier que vous souhaitez ajouter à la liste des filtres. Plusieurs extensions peuvent être spécifiées et chacune doit être séparée par un point-virgule. Par exemple, l’argument peut être affecté à la chaîne : « *.txt; *.htm ».

REMARQUE : Il n’est pas nécessaire d’ajouter des parenthèses autour des extensions. Microsoft Office ajoute automatiquement des parenthèses autour de la chaîne d’extensions lorsque la description et les chaînes d’extensions sont concaténées en un seul élément de filtre de fichier.
Position Facultatif Variant Nombre qui indique la position du nouveau contrôle dans la liste de filtres. Ce nouveau filtre est inséré devant le filtre se trouvant à cet emplacement. Si vous n'indiquez pas cet argument, le filtre est ajouté à la fin de la liste.

Remarques

Chaque filtre d'une liste est composé de deux parties : l'extension de nom de fichier (.txt) et le texte de description de l'extension de nom de fichier (fichiers texte). Ensemble, le filtre de fichiers apparaît dans la liste Fichiers de type sous la forme : Fichiers texte (*.txt).

Notez que lorsqu'un filtre est ajouté à la liste, les filtres par défaut ne sont pas supprimés. Les filtres ne s'affichent que lorsque l'option Fenêtres est activée. Si Position n’est pas valide, une erreur d’exécution hors plage s’affiche. Si les valeurs Description et Extensions ne sont pas valides, une erreur d’exécution (analyse) s’affiche.

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.