FileDialogFilters.Add(String, String, Object) 方法

定义

命名空间:

Microsoft.Office.Core

程序集:

office.dll

将新的文件筛选器添加到“文件”对话框中“文件类型”列表框中的筛选器列表，并返回一个代表新添加的文件筛选器的 FileDialogFilter 对象。

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

参数

Description

String

必需的 字符串 。 表示要添加到筛选器列表中的文件扩展名的说明的文本。

Extensions

String

必需的 字符串 。 表示要添加到筛选器列表中的文件扩展名的文本。 可以指定多个扩展，每个扩展都必须用分号 (;) 分隔。 例如， Extensions 可以将 参数分配给字符串：“*.txt;*.htm”。注意 不需要在扩展周围添加括号。 当说明和扩展名字符串串联到一个文件筛选器项时，Office 将自动在扩展名字符串周围添加括号。

Position

Object

可选 对象。 表示新控件在筛选列表中位置的数字。 新筛选将插入到该位置的筛选之前。 如果忽略该参数，筛选将添加到指定列表的末端。

返回

FileDialogFilter

注解

列表中的每个筛选器由两部分组成：文件扩展名 (（例如.txt) ）和文件扩展名 (的文本说明（例如文本文件) ）。 文件筛选器将一起显示在“文件类型”列表框中，显示为“文本文件 (*.txt) ”。

请注意，向列表中添加筛选器时，不会删除默认的筛选器。

仅当选中“窗口”选项时才显示筛选器。

如果 Position 无效，则显示范围外运行时错误。 Description如果 和 Extensions 值无效，则会显示运行时错误 (分析) 。

文件夹选取器对话框没有筛选器。 因此，筛选器方法不适用于文件夹选取器。