Тип: Строка. Содержит имя декорации. Является уникальным среди всех элементов формы.
Полное описание, параметры и ограничения
ДекорацияФормы.Имя (FormDecoration.Name)
ДекорацияФормы (FormDecoration)
Имя (Name)
Доступен, начиная с версии 8.2.
Использование:
Только чтение.
Описание:
Тип: Строка.
Содержит имя декорации. Является уникальным среди всех элементов формы.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Проверить родителя и состав собственной группы
Перебираем элементы интерфейса, не строки таблицы и не значения справочника. Проверка помогает найти элемент, случайно созданный вне группы.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
Создайте отдельную внешнюю обработку с новой пустой управляемой основной формой. Каждый урок — свой полный модуль и отдельная копия формы.
Не создавайте вручную УчебноеНазвание, УчебнаяГруппа, ПолеУчебногоНазвания и УчебнаяНадпись: код добавляет их сам.
В событиях формы назначьте ПриСозданииНаСервере одноимённому обработчику. Вставьте весь модуль на уровне модуля, включая клиентские процедуры.
Откройте сохранённую учебную EPF в настольном тонком/толстом или веб-клиенте. Данные принадлежат только этой форме; справочники, документы и регистры не используются.
Внешняя кнопка находится вне учебной группы и остаётся доступной для обратного переключения. Код не обходит ограничения на внешние обработки.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Новые = Новый Массив;
Новые.Добавить(Новый РеквизитФормы("УчебноеНазвание", Новый ОписаниеТипов("Строка")));
ЭтаФорма.ИзменитьРеквизиты(Новые);
ЭтаФорма.УчебноеНазвание = "Книга";
Группа = Элементы.Добавить("УчебнаяГруппа", Тип("ГруппаФормы"));
Группа.Вид = ВидГруппыФормы.ОбычнаяГруппа;
Группа.Заголовок = "Собственные учебные данные";
Группа.Группировка = ГруппировкаПодчиненныхЭлементовФормы.Вертикальная;
Поле = Элементы.Добавить("ПолеУчебногоНазвания", Тип("ПолеФормы"), Группа);
Поле.Вид = ВидПоляФормы.ПолеВвода;
Поле.ПутьКДанным = "УчебноеНазвание";
Поле.Заголовок = "Название";
Надпись = Элементы.Добавить("УчебнаяНадпись", Тип("ДекорацияФормы"), Группа);
Надпись.Вид = ВидДекорацииФормы.Надпись;
Надпись.Заголовок = "Данные только в памяти формы";
Сообщить(Группа.Имя = "УчебнаяГруппа");
Сообщить(Группа.Родитель = ЭтаФорма);
Сообщить(Поле.Родитель = Группа);
Сообщить(Надпись.Родитель = Группа);
Для Каждого Элемент Из Группа.ПодчиненныеЭлементы Цикл
Сообщить("Ребёнок группы: " + Элемент.Имя);
КонецЦикла;
Сообщить(Группа.ПодчиненныеЭлементы.Количество() = 2);
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Выполнить учебное действие";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
Сообщить("Одно значение реквизита: " + ЭтаФорма.УчебноеНазвание);
КонецПроцедуры
Разбор по шагам
Группа создана непосредственно в форме, а поле/надпись — с её явным родителем.
Проверяем технические имена и ссылки родителей, не подписи пользователя.
ПодчиненныеЭлементы возвращает коллекцию UI с двумя созданными детьми.
Скаляр УчебноеНазвание остаётся одним значением, хотя элементов в группе два.
Как проверить результат
Пять логических проверок Истина; перечислены ПолеУчебногоНазвания и УчебнаяНадпись.
Кнопка находится вне группы и не входит в её два дочерних элемента.
Ожидаемый результат
Получен проверяемый аудит размещения собственной группы и детей.
На что обратить внимание
Это число элементов интерфейса, не число товаров.
После добавления собственных новых детей ожидаемое количество нужно изменить, не скрывать расхождение.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.