Form.PositionOnElement

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

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

Функция используется для обновления содержимого табличного элемента из базы данных и позиционировании его на указанном объекте. Функция может применяться к таблице, дереву или списку, которые привязаны к базе данных. При необходимости, функция может дождаться окончания загрузки и позиционирования, однако, подобный вызов из обработчиков событий может привести к непредсказуемым последствиям (так как обновление элемента может попытаться вызвать визуальные события, которые не смогут выполниться, пока программа не выйдет из текущего события, которое будет ожидать окончания обновления), рекомендуется подходить к этому режиму с осторожностью.

Синтаксис

Form.PositionOnElement(<Объект позиционирования>,<Дождаться окончания загрузки и позиционирования в таблице (INT)>=0)

Аргументы

• <Объект позиционирования (DB)> - Аргумент задает объект, на котором будет позиционирован табличный элемент.
• <Дождаться окончания загрузки и позиционирования в таблице (INT)> - (необязательный аргумент) Задает режим, когда функция будет ожидать выполнения полного обновления табличного элемента и только после этого отдаст управление. По умолчанию (0), не дожидаться окончания обновления.

Примеры

//Позиционирование по введенному коду
аКНТ:=DB("Ref.Контрагенты","Code",глПолучитьКодИзЧисла("Контрагенты",Trim(Form.оКод.Value)));
If not isEmpty(аКНТ) Then
  Form.MainTab.PositionOnElement(аКНТ);
  Form.MainTab.SetFocus();
Else
  Form.оКод.SetFocus();
EndIf;