Form.Control

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

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

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

Синтаксис

Form.Control(<Наименование визуального элемента с наименованием макроса, если необходимо (STRING)>):<Найденный визуальный элемент или ноль (FORM,INT)>

Аргументы

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

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

Возвращает найденный визуальный объект или ноль, если объект с указанным именем не был найден.

Примеры

aTab:=Form.Control(пИмяТаблицы).Value;
aTab.Select();
While aTab.Next() Do
  If Pos("(польз)",aTab.Группировка)=0 Then
    Continue;
  EndIf;
  If aTab.Путь=Путь Then
    Box("Этот фильтр уже был добавлен в таблицу!",Q_STOP);
    Exit;
  EndIf;
EndDo;
aTab.NewLine();
aTab.Группировка:="(польз) "+ПутьИмя;
aTab.Путь:=Путь;