Vcl.Dialogs.TOpenDialog.Filter
Delphi
property Filter: string read FFilter write FFilter;
C++
__property System::UnicodeString Filter = {read=FFilter, write=FFilter};
Inhaltsverzeichnis
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
property | published | Vcl.Dialogs.pas Vcl.Dialogs.hpp |
Vcl.Dialogs | TOpenDialog |
Beschreibung
Legt die Dateimasken (Filter) fest, die im Dialogfeld verfügbar sind.
Im Dialogfeld befindet sich unter dem Eingabefeld eine Dropdown-Liste mit Dateitypen. Sobald ein Typ aus der Liste ausgewählt wird, werden nur noch Dateien dieses Typs angezeigt.
Um zur Entwurfszeit Dateimasken zu konfigurieren, klicken Sie im Objektinspektor auf die Ellipsen-Schaltfläche (...) der Eigenschaft Filter. Dadurch wird der Filter-Editor geöffnet. Geben Sie in der linken Spalte des Editors unter Filtername für jeden Dateityp eine kurze Beschreibung ein. In der rechten Spalte geben Sie unter Filter die Dateimaske ein, die der Beschreibung entspricht. Beispielsweise könnte neben der Maske "*.TXT" die Beschreibung "Textdateien" stehen und neben der Maske "*.pas" die Beschreibung "Pascal-Quelltextdateien". Da die Beschreibung auch zur Laufzeit angezeigt wird, sollte sie nach Möglichkeit die dazugehörige Maske enthalten (z.B. "Textdateien (*.TXT)").
Um Dateimasken programmseitig zu erzeugen, weisen Sie der Eigenschaft Filter einen Wert zu. Dieser Wert besteht aus einer Beschreibung und einer Maske, die durch einen senkrechten Strich (das Pipe-Zeichen |) getrennt sind. Fügen Sie vor und nach dem senkrechten Strich kein Leerzeichen ein. Beispiel:
OpenDialog1.Filter := 'Text files (*.txt)|*.TXT';
OpenDialog1->Filter = "Text files (*.txt)|*.TXT";
Mehrere Filter sollten jeweils durch einen senkrechten Strich getrennt werden. Beispiel:
OpenDialog1.Filter := 'Text files (*.txt)|*.TXT|Pascal files (*.pas)|*.PAS';
OpenDialog1->Filter = "Text files (*.txt)|*.TXT|Pascal files (*.pas)|*.PAS";
Um mehrere Masken in einem einzigen Filter anzugeben, trennen Sie die Masken durch Semikolons. Dies gilt sowohl für den Objektinspektor als auch für den Quelltext. Beispiel:
OpenDialog1.Filter := 'Pascal files|*.PAS;*.DPK;*.DPR';
OpenDialog1->Filter = "Pascal files|*.PAS;*.DPK;*.DPR";
Wenn die Eigenschaft Filter keinen Wert enthält, zeigt das Dialogfeld alle Dateitypen an.
Siehe auch
Codebeispiele
- SavePictureDialog (Delphi)
- TApplicationIcon (Delphi)
- UsingDialogs (Delphi)
- SavePictureDialog (C++)
- TApplicationIcon (C++)
- UsingDialogs (C++)