FileDialogFilters.Add(String, String, Object) Methode

Definition

Namespace:

Microsoft.Office.Core

Assembly:

office.dll

Fügt der Liste der Filter im Listenfeld Dateien vom Typ im Dialogfeld Datei einen neuen Dateifilter hinzu und gibt ein FileDialogFilter-Objekt zurück, das den neu hinzugefügten Dateifilter darstellt.

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

Parameter

Description

String

String erforderlich. Der Text, der die Beschreibung der Dateierweiterung darstellt, die Sie der Filterliste hinzufügen möchten.

Extensions

String

String erforderlich. Der Text, der die Dateierweiterung darstellt, die Sie der Filterliste hinzufügen möchten. Es können mehrere Erweiterungen angegeben werden, und jede muss durch einen Semikolon (;). Beispielsweise kann das Extensions Argument der Zeichenfolge zugewiesen werden: "*.txt; *.htm". Hinweis Klammern müssen nicht um die Erweiterungen herum hinzugefügt werden. Office fügt automatisch Klammern um die Erweiterungszeichenfolge hinzu, wenn die Beschreibungs- und Erweiterungszeichenfolgen in einem Dateifilterelement verkettet werden.

Position

Object

Optionales Objekt. Eine Zahl, die die Position für das neue Steuerelement in der Filterliste angibt. Der neue Filter wird vor dem Filter eingefügt, der sich an dieser Position befindet. Wenn Sie dieses Argument weglassen, wird der Filter am Ende der Liste hinzugefügt.

Gibt zurück

FileDialogFilter

Hinweise

Jeder Filter in einer Liste besteht aus zwei Teilen: der Dateierweiterung (z. B. .txt) und der Textbeschreibung der Dateierweiterung (z.B. Textdateien). Zusammen wird der Dateifilter im Listenfeld Dateien vom Typ als Textdateien (*.txt) angezeigt.

Note that when a filter is added to the list, the default filters are not removed.

Filters are only displayed when the Windows option is checked.

Wenn Position ungültig ist, wird ein Laufzeitfehler außerhalb des gültigen Bereichs angezeigt. Wenn die Description Werte und Extensions ungültig sind, wird ein Laufzeitfehler (Analyse) angezeigt.

Dialogfelder für die Ordnerauswahl verfügen über keine Filter. Daher gelten Filtermethoden nicht für die Ordnerauswahl.