Тип: Строка. Содержит имя дополнения элемента формы. Уникально среди всех элементов формы.
Полное описание, параметры и ограничения
ДополнениеЭлементаФормы.Имя (FormItemAddition.Name)
ДополнениеЭлементаФормы (FormItemAddition)
Имя (Name)
Доступен, начиная с версии 8.3.5.
Использование:
Только чтение.
Описание:
Тип: Строка.
Содержит имя дополнения элемента формы.
Уникально среди всех элементов формы.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент.
Использование в версии:
Доступен, начиная с версии 8.3.5.
Методическая информация
Практические примеры
Разобрать встроенную строку поиска и её расположение
Настраиваем поиск только в двух учебных строках. Поиск при вводе и автоматически созданные элементы поиска — разные части интерфейса.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
В учебной базе: Файл → Новый → Внешняя обработка. Создайте управляемую форму и назначьте её основной. Дайте обработке имя УчебнаяТаблица.
Не добавляйте вручную реквизит Товары и одноимённые элементы: код создаст их при открытии. Модуль формы для этой задачи должен быть пустым.
В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Сохраните отдельную учебную EPF и откройте через Файл → Открыть.
Данные Книга/Ручка создаются в памяти формы. Справочники, документы и регистры вашей конфигурации не читаются и не записываются.
Проверяйте в настольном тонком/толстом или веб-клиенте 8.5.1.1343, не в мобильном приложении. Для каждого урока отдельная учебная форма с пустым модулем.
Изменение учебных строк остаётся только в открытой форме. При её новом открытии снова создаются Книга/3 и Ручка/1. Настройки таблицы не являются правами доступа к данным.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
НовыеРеквизиты = Новый Массив;
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Товары", Новый ОписаниеТипов("ТаблицаЗначений")));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Код", Новый ОписаниеТипов("Строка"), "Товары", "Код"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Наименование", Новый ОписаниеТипов("Строка"), "Товары", "Название"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)), "Товары", "Количество"));
ЭтаФорма.ИзменитьРеквизиты(НовыеРеквизиты);
Данные = Новый ТаблицаЗначений;
Данные.Колонки.Добавить("Код", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Наименование", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)));
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "A-01";
СтрокаТовара.Наименование = "Книга";
СтрокаТовара.Количество = 3;
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "B-02";
СтрокаТовара.Наименование = "Ручка";
СтрокаТовара.Количество = 1;
ЭтаФорма.ЗначениеВРеквизитФормы(Данные, "Товары");
Таблица = ЭтаФорма.Элементы.Добавить("ТаблицаТоваров", Тип("ТаблицаФормы"));
Таблица.ПутьКДанным = "Товары";
Таблица.Заголовок = "Учебные товары";
Таблица.Шапка = Истина;
Таблица.АвтоВводНезаполненного = Ложь;
Таблица.АвтоВводНовойСтроки = Ложь;
Для Каждого ИмяКолонки Из СтрРазделить("Код,Наименование,Количество", ",") Цикл
Колонка = Элементы.Добавить("Товары" + ИмяКолонки, Тип("ПолеФормы"), Таблица);
Колонка.Вид = ВидПоляФормы.ПолеВвода;
Колонка.ПутьКДанным = "Товары." + ИмяКолонки;
Колонка.Заголовок = ИмяКолонки;
КонецЦикла;
Таблица.ТолькоПросмотр = Истина;
Таблица.ПоискПриВводе = ПоискВТаблицеПриВводе.Использовать;
Таблица.ПоложениеСтрокиПоиска = ПоложениеСтрокиПоиска.Верх;
Таблица.ПоложениеСостоянияПросмотра = ПоложениеСостоянияПросмотра.Низ;
Таблица.ПоложениеУправленияПоиском = ПоложениеУправленияПоиском.КоманднаяПанель;
Поиск = Таблица.ОтображениеСтрокиПоиска;
Состояние = Таблица.ОтображениеСостоянияПросмотра;
Управление = Таблица.УправлениеПоиском;
Если Поиск <> Неопределено Тогда
Поиск.Видимость = Истина;
КонецЕсли;
Если Состояние <> Неопределено Тогда
Сообщить("Дополнение состояния: " + Состояние.Имя);
КонецЕсли;
Если Управление <> Неопределено Тогда
Сообщить("Дополнение управления поиском: " + Управление.Имя);
КонецЕсли;
КонецПроцедуры
Разбор по шагам
ТолькоПросмотр не даёт вводимым символам случайно менять товар во время учебного поиска.
ПоискПриВводе включает стандартное поведение поиска при вводе символов, не запрос к справочникам базы.
Три настройки расположения относятся к строке поиска, состоянию просмотра и управлению поиском.
Свойства дополнений доступны для чтения. Возвращённый элемент проверяем до обращения к нему; не присваиваем новый объект самому свойству таблицы.
Имена дополнений — имена UI, не коды товара. Конкретное размещение и доступность проверяются в выбранном клиенте.
Как проверить результат
Введите Книга или Ручка в отображаемую строку поиска и изучите стандартное поведение выбранного клиента.
Сами учебные данные не меняются: исходный реквизит содержит две строки. Поиск не является удалением строк.
Ожидаемый результат
Показаны расположение поисковых дополнений и различие поиска/редактирования.
На что обратить внимание
Не все клиенты и варианты интерфейса отображают дополнения одинаково.
Не трактуйте видимый результат поиска как количество строк во всей коллекции.
Поиск в таблице не заменяет серверный запрос с параметрами и не расширяет права.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Оформить рамку и фон состояния без изменения строк
У собственного состояния поиска задаём отдельную рамку и фон кнопок. После фильтрации проверяем, что оформление не изменило исходные количества.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
В отдельной учебной базе 8.5.1.1343 создайте внешнюю обработку УчебноеСостояниеТаблицы с пустой управляемой основной формой. Используйте тонкий клиент Windows.
В свойствах формы → События назначьте ПриСозданииНаСервере. Полный код вставляйте на уровне модуля; каждую задачу выполняйте в отдельной копии формы.
Не добавляйте вручную реквизит Товары, колонки и кнопки: весь собственный набор создаётся кодом. Сохраните свою EPF и откройте её в учебной базе.
Две учебные строки — A-01 Книга, количество 3; B-02 Ручка, количество 1. Они существуют в памяти формы, а не в справочниках базы.
Элемент состояния не создаётся конструктором: таблица возвращает автоматически сформированное дополнение через ОтображениеСостоянияПросмотра.
После открытия введите Книга в строку поиска над таблицей, осмотрите состояние под таблицей, затем очистите поиск. Кнопка сравнивает исходную коллекцию независимо от фильтра отображения.
Запуск и вид в 1С не проверены. Урок не записывает базу и не устанавливает пользовательские настройки. Точный текст стандартного состояния зависит от клиента.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
НовыеРеквизиты = Новый Массив;
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Товары", Новый ОписаниеТипов("ТаблицаЗначений")));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Код", Новый ОписаниеТипов("Строка"), "Товары", "Код"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Наименование", Новый ОписаниеТипов("Строка"), "Товары", "Название"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)), "Товары", "Количество"));
ЭтаФорма.ИзменитьРеквизиты(НовыеРеквизиты);
Данные = Новый ТаблицаЗначений;
Данные.Колонки.Добавить("Код", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Наименование", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)));
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "A-01";
СтрокаТовара.Наименование = "Книга";
СтрокаТовара.Количество = 3;
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "B-02";
СтрокаТовара.Наименование = "Ручка";
СтрокаТовара.Количество = 1;
ЭтаФорма.ЗначениеВРеквизитФормы(Данные, "Товары");
Таблица = ЭтаФорма.Элементы.Добавить("ТаблицаТоваров", Тип("ТаблицаФормы"));
Таблица.ПутьКДанным = "Товары";
Таблица.Заголовок = "Учебные товары";
Таблица.Шапка = Истина;
Таблица.АвтоВводНезаполненного = Ложь;
Таблица.АвтоВводНовойСтроки = Ложь;
Для Каждого ИмяКолонки Из СтрРазделить("Код,Наименование,Количество", ",") Цикл
Колонка = Элементы.Добавить("Товары" + ИмяКолонки, Тип("ПолеФормы"), Таблица);
Колонка.Вид = ВидПоляФормы.ПолеВвода;
Колонка.ПутьКДанным = "Товары." + ИмяКолонки;
Колонка.Заголовок = ИмяКолонки;
КонецЦикла;
Таблица.ТолькоПросмотр = Истина;
Таблица.ПоложениеСтрокиПоиска = ПоложениеСтрокиПоиска.Верх;
Таблица.ПоложениеСостоянияПросмотра = ПоложениеСостоянияПросмотра.Низ;
Состояние = Таблица.ОтображениеСостоянияПросмотра;
Если Состояние = Неопределено Тогда
ВызватьИсключение "Учебная таблица не предоставила дополнение состояния просмотра";
КонецЕсли;
Состояние.Видимость = Истина;
Состояние.Рамка = Новый Рамка(ТипРамкиЭлементаУправления.Одинарная, 1);
Состояние.ЦветРамки = Новый Цвет(70, 90, 110);
Состояние.ЦветФона = Новый Цвет(242, 247, 252);
Состояние.ЦветФонаКнопок = Новый Цвет(226, 237, 248);
Состояние.ЦветТекста = Новый Цвет(20, 35, 50);
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Проверить исходные две строки";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
Таблица = Элементы.ТаблицаТоваров;
Состояние = Таблица.ОтображениеСостоянияПросмотра;
Если Состояние = Неопределено Тогда
ВызватьИсключение "Дополнение состояния недоступно в этом клиенте";
КонецЕсли;
Сообщить(Товары.Количество() = 2);
Сообщить(Товары.Итог("Количество") = 4);
Сообщить(Товары[0].Наименование = "Книга" И Товары[0].Количество = 3);
Сообщить(Товары[1].Наименование = "Ручка" И Товары[1].Количество = 1);
Сообщить("Состояние UI: " + Состояние.Имя);
Сообщить(Состояние.Рамка.ТипРамки = ТипРамкиЭлементаУправления.Одинарная);
Сообщить(Состояние.Рамка.Толщина = 1);
КонецПроцедуры
Разбор по шагам
Автоматическое дополнение получаем от своей таблицы, а не из неизвестной формы конфигурации.
Рамка создаётся новым значением с типом Одинарная и толщиной 1. Присваиваем свойство Рамка целиком.
ЦветРамки, ЦветФона, ЦветФонаКнопок и ЦветТекста имеют разные назначения; каждый цвет строится собственными RGB-числами.
В строке поиска введите Книга, осмотрите состояние, затем удалите фильтр стандартной кнопкой интерфейса.
Команда не удаляет строки и не изменяет фильтр программно: она проверяет исходную коллекцию и параметры заданной рамки.
Как проверить результат
До и после ручного поиска ожидаются шесть Истина и исходные две строки, количество 4.
Осмотрите рамку, фон и стандартные кнопки состояния. Вид цветов зависит от темы и клиента; наличие цвета в свойстве не равно проверке видимости на экране.
Ожидаемый результат
Оформление реального состояния таблицы изучается вместе с инвариантами собственного набора данных.
На что обратить внимание
Свойства Рамка.Толщина и Рамка.ТипРамки только для чтения: новый вид задаётся новым объектом Рамка.
ЦветФонаКнопок не вычисляет состояние поиска и не заменяет текстовую подсказку.
Свойства оформления меняем на сервере при создании, не обещая отсутствие серверного обращения при их изменении на клиенте.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.