SetFieldFilter

Синтаксис

SetFieldFilterResult SetFieldFilter(OdId tOb, SetFieldFilterArg tArg)

Параметры

mon. Моникёр открытого экземпляра реляционного объекта.

tArg. Параметры выполнения операции.

Описание

Операция SetFieldFilter задаёт настройки в автофильтре для фильтрации по значениям поля.

Комментарии

Перед выполнением данной операции для соответствующего поля должна быть выполнена операция CreateFieldFilterState. Для выполнения операции SetFieldFilter укажите в поле tOb моникёр открытого экземпляра реляционного объекта, а в поле tArg параметры установки настроек автофильтра. В настройках автофильтра используются значения поля, которые можно получить с помощью операции GetFieldValues. Моникёр может быть получен при выполнении операций OpenTable, OpenQuery. В tArg также будет необходимо задать моникёр кеша реляционного объекта, который может быть получен с помощью операций GetTable/GetQuery с указанным в шаблоне полем cachedDataset.

Результатом выполнения операции будет признак успешного изменения настроек автофильтра.

Применение внесённых изменений осуществляется после выполнения операции CloseFieldFilterState. Для получения отфильтрованных записей реляционного источника используйте повторный вызов операций GetTable/GetQuery.

Пример

Различные варианты использования операции приведены в следующих примерах:

Наименование примера
Сброс отмеченных элементов в автофильтре
Задание отмеченного элемента в автофильтре

См. также:

Работа с реляционными объектами репозитория