Vcl.FileCtrl.TFilterComboBox.Filter
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"