Form.SetFiltersAndPositionOnElement

SetFiltersAndPositionOnElement (Работа со фильтрами таблиц)
Объект: Форма Статус разработки: Реализована Тип: Функция Обращение к БД: Сервер и БД Исключения: Невозможно превратить в строку Визуальность: Да

• Начальная страница
• Общее описание
• Объекты
• Форма

Функция работает для табличных элементов, связанных с базой данных и позволяет установить фильтры таблицы. Фильтры, не указанные в списке фильтров, будут удалены. Начальные фильтры могут быть заданы в Студии при редактировании формы. Фильтры позволяют отображать содержимое таблицы в требуемом разрезе. В наименование фильтра можно включать дополнительные признаки (префиксы), позволяющие задавать способ применения фильтра. Для более полной информации см. статью Стандартные фильтры (простой режим). Пример: Form.MainTab.SetFiltersAndPositionOnElement(aEl,"<>@Status,>=DocDate,<DocDate",1,'01.01.2025','01.02.2025'). Функция заменяет вызов двух функций: SetFilters и PositionOnElement, при этом обновление таблицы из базы данных происходит всего один раз, поэтому функцию выгодно использовать всегда, когда есть необходимость изменить фильтры в таблице и (возможно) изменить ее текущий элемент.

Синтаксис

Form.SetFiltersAndPositionOnElement(<Элемент для позиционирования>,<Наименования фильтров через запятые (STRING)>,<Значение фильтра 1>,<Значение фильтра 2>...)

Аргументы

• <Элемент для позиционирования> - (необязательный аргумент) Аргумент задает элемент, на котором будет позиционирован табличный элемент, если аргумент не задан, действие функции аналогично функции SetFilters (система постарается сохранить позиционирование на текущем элементе таблицы после применения фильтров и обновления).
• <Наименования фильтров через запятые (STRING)> - Аргумент задает список наименований реквизитов или особых реквизитов объекта, элементы (документы) которого выведены в таблицу. Наименования даются через запятые и могут иметь префикс операции, списки возможных префиксов смотрите в Стандартные фильтры (простой режим).
• <Значение фильтра ?> - Аргументы задают значения фильтров реквизитов, заданных предыдущим аргументом.

Примеры

Try
  Exec("Form.MainTab.SetFiltersAndPositionOnElement(ДокументПозиционирования,"""+Фильтры+""","+Значения+")");
Except
EndTry;