Поделиться через

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

Обязательный атрибут типа String. Текст, представляющий описание расширения файла, которое требуется добавить в список фильтров.

Extensions
String

Обязательный атрибут типа String. Текст, представляющий расширение файла, которое нужно добавить в список фильтров. Можно указать несколько расширений, и каждое из них должно быть разделено точкой с запятой (;). Например, Extensions аргумент может быть назначен строке: "*.txt; *.htm". Примечание. Круглые скобки не нужно добавлять вокруг расширений. Office автоматически добавит круглые скобки вокруг строки расширений, когда строки описания и расширения объединяются в один элемент фильтра файла.

Position
Object

Необязательный объект. Число, указывающее положение нового элемента управления в списке фильтров. Новый фильтр будет вставлен перед фильтром в этой позиции. Если этот аргумент опущен, фильтр добавляется в конец списка.

Возвращаемое значение

FileDialogFilter

Комментарии

Каждый фильтр в списке состоит из двух частей: расширения файла (например, .txt) и текстового описания расширения файла (например, текстовых файлов). Вместе фильтр файлов будет отображаться в списке Файлы типа: Текстовые файлы (*.txt).

Обратите внимание, что при добавлении фильтра в список фильтры по умолчанию не удаляются.

Фильтры отображаются только в том случае, если установлен флажок Windows.

Если Position параметр недопустим, отображается ошибка вне диапазона выполнения. Description Если значения и Extensions недопустимы, отображается ошибка среды выполнения (синтаксический анализ).

Диалоговые окна выбора папок не имеют фильтров. Поэтому методы фильтрации не применяются к выбору папок.

Применяется к