Afficher : Delphi C++
Préférences d'affichage

Vcl.FileCtrl.TFilterComboBox.Filter

De RAD Studio API Documentation

Delphi

property Filter: string read FFilter write SetFilter stored IsFilterStored;

C++

__property System::UnicodeString Filter = {read=FFilter, write=SetFilter, stored=IsFilterStored};

Propriétés

Type Visibilité  Source Unité  Parent
property published
Vcl.FileCtrl.pas
Vcl.FileCtrl.hpp
Vcl.FileCtrl TFilterComboBox

Description

Contient tous les masques de fichier affichés dans la boîte à options de filtrage.

Définissez la propriété Filter pour spécifier les noms apparaissant dans la boîte à options de filtrage avec les masques associés. Chaque masque est un nom de fichier pouvant comporter des caractères génériques. L'astérisque (*) est un caractère générique correspondant à un nombre quelconque de caractères arbitraires. Le point d'interrogation (?) est un caractère correspondant à un seul caractère arbitraire. Quand l'application est exécutée, le filtre de fichier sélectionné par l'utilisateur dans la boîte à options de filtrage devient la valeur de la propriété Mask.

Pour créer la valeur de Filter pour un seul type de fichier, procédez de la manière suivante :

1. Entrez un texte descriptif pour décrire le type de fichier.

2. Entrez le caractère | (barre verticale).

3. Entrez le filtre de fichier.

Dans la chaîne, ne placez pas d'espaces autour du caractère |.

Par exemple :



FilterComboBox1.Filter := 'Fichiers texte|*.TXT';



FilterComboBox1->Filter = "Fichiers texte|*.TXT";



Si cette chaîne est affectée à Filter, la chaîne "Fichiers texte" apparaît dans la boîte à options de filtrage. Quand l'utilisateur sélectionne "Fichiers texte", le masque devient "*.TXT".

Pour spécifier plusieurs filtres de fichiers, étendez la valeur de Filter , en séparant chaque combinaison descriptif/masque par un caractère |. Filter peut spécifier n'importe quel nombre de filtres de fichiers, à condition que la chaîne comporte moins de 255 caractères.

L'exemple suivant définit deux filtres de fichier pouvant être spécifiés en tant que valeur de la propriété Filter :



'Fichiers texte (*.TXT)|*.TXT|Fichiers Pascal (*.PAS)|*.PAS'



"Fichiers texte (*.TXT)|*.TXT|Fichiers C++ (*.CPP)|*.CPP"



L'exemple précédent spécifie le filtre de fichier entre parenthèses dans la partie texte. Cela n'est pas nécessaire mais c'est une convention courante qui aide l'utilisateur à prévoir le résultat obtenu en sélectionnant un filtre de fichier.

La partie masque peut comporter plusieurs spécificateurs de fichier séparés par des points-virgules :



'Tous les fichiers|*.TXT;*.PAS;*.WB1'



"Tous les fichiers|*.TXT;*.CPP;*.RC"



Voir aussi

Outils personnels
Traductions