Share via

FileDialogFilters.Add(String, String, Object) Méthode

  • Référence

Définition

Espace de noms:
Microsoft.Office.Core
Assembly:
office.dll

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

public Microsoft.Office.Core.FileDialogFilter Add (string Description, string Extensions, object Position);
abstract member Add : string * string * obj -> Microsoft.Office.Core.FileDialogFilter
Public Function Add (Description As String, Extensions As String, Optional Position As Object) As FileDialogFilter

Paramètres

Description
String

Argument de type String obligatoire. Texte représentant la description de l’extension de fichier que vous souhaitez ajouter à la liste des filtres.

Extensions
String

Argument de type String obligatoire. Texte représentant l’extension 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 Extensions peut être affecté à la chaîne : « *.txt; *.htm ». Remarque Il n’est pas nécessaire d’ajouter des parenthèses autour des extensions. 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
Object

Objet facultatif. 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.

Retours

FileDialogFilter

Remarques

Chaque filtre d’une liste est constitué de deux parties : l’extension de fichier (par exemple, .txt) et la description textuelle de l’extension de fichier (par exemple, fichiers texte). Ensemble, le filtre de fichiers apparaît dans la zone de 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 limites s’affiche. Si les Description valeurs et Extensions ne sont pas valides, une erreur d’exécution (analyse) s’affiche.

Les boîtes de dialogue du sélecteur de dossiers n’ont pas de filtres. Par conséquent, les méthodes de filtre ne s’appliquent pas au sélecteur de dossiers.

S’applique à