Admin: 1 revision imported

2021-02-07T06:50:57Z

1 revision imported

Admin: Created page with "{{infobox function |name=SetFiltersAndPositionOnElement |object=Форма |caption=Работа со фильтрами таблиц |type=1 |status=2 |db=2 |exception=Н..."

2020-07-16T09:24:12Z

Created page with "{{infobox function |name=SetFiltersAndPositionOnElement |object=Форма |caption=Работа со фильтрами таблиц |type=1 |status=2 |db=2 |exception=Н..."

New page

{{infobox function
|name=SetFiltersAndPositionOnElement
|object=[[Форма]]
|caption=Работа со фильтрами таблиц
|type=1
|status=2
|db=2
|exception=Невозможно превратить в строку
|visual=1}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Форма]]}}
Функция работает для табличных элементов, связанных с базой данных и позволяет установить фильтры таблицы. Фильтры, не указанные в списке фильтров, будут удалены. Начальные фильтры могут быть заданы в Студии при редактировании формы. Фильтры позволяют отображать содержимое таблицы в требуемом разрезе. В наименование фильтра можно включать дополнительные признаки (префиксы), позволяющие задавать способ применения фильтра. Для более полной информации см. статью [[Стандартные фильтры]] (простой режим). Пример: <code>Form.MainTab.SetFiltersAndPositionOnElement(aEl,"<>@Status,>=DocDate,<DocDate",1,'01.01.2025','01.02.2025')</code>. Функция заменяет вызов двух функций: [[Form.SetFilters|SetFilters]] и [[Form.PositionOnElement|PositionOnElement]], при этом обновление таблицы из базы данных происходит всего один раз, поэтому функцию выгодно использовать всегда, когда есть необходимость изменить фильтры в таблице и (возможно) изменить ее текущий элемент.

== Синтаксис ==
<code>
{{Grey|Form.}}'''SetFiltersAndPositionOnElement'''({{Optional|<Элемент для позиционирования>}},''<Наименования фильтров через запятые (STRING)>''{{Optional|,<Значение фильтра 1>,<Значение фильтра 2>...}})
</code>

==== Аргументы ====
* <code>''<Элемент для позиционирования>''</code> - {{Optional}} Аргумент задает элемент, на котором будет позиционирован табличный элемент, если аргумент не задан, действие функции аналогично функции [[Form.SetFilters|SetFilters]] (система постарается сохранить позиционирование на текущем элементе таблицы после применения фильтров и обновления).
* <code>''<Наименования фильтров через запятые (STRING)>''</code> - Аргумент задает список наименований реквизитов или особых реквизитов объекта, элементы (документы) которого выведены в таблицу. Наименования даются через запятые и могут иметь префикс операции, списки возможных префиксов смотрите в [[Стандартные фильтры]] (простой режим).
* <code>''<Значение фильтра ?>''</code> - Аргументы задают значения фильтров реквизитов, заданных предыдущим аргументом.

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

← Older revision	Revision as of 06:50, 7 February 2021
(No difference)

Form.SetFiltersAndPositionOnElement - Revision history

Admin: 1 revision imported

Admin: Created page with "{{infobox function |name=SetFiltersAndPositionOnElement |object=Форма |caption=Работа со фильтрами таблиц |type=1 |status=2 |db=2 |exception=Н..."