Тип: ГруппаФормы. Содержит командную панель таблицы.
Полное описание, параметры и ограничения
ТаблицаФормы.КоманднаяПанель (FormTable.CommandBar)
ТаблицаФормы (FormTable)
КоманднаяПанель (CommandBar)
Доступен, начиная с версии 8.2.
Использование:
Только чтение.
Описание:
Тип: ГруппаФормы.
Содержит командную панель таблицы.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Разместить свою кнопку в командной панели своей таблицы
Родитель кнопки — встроенная командная панель ТаблицаТоваров, а не чужая форма. Положение в меню и пометка не являются бизнес-значениями.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
В учебной базе: Файл → Новый → Внешняя обработка. Создайте управляемую форму и назначьте её основной. Дайте обработке имя УчебнаяТаблица.
Не добавляйте вручную реквизит Товары и одноимённые элементы: код создаст их при открытии. Модуль формы для этой задачи должен быть пустым.
В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Сохраните отдельную учебную EPF и откройте через Файл → Открыть.
Данные Книга/Ручка создаются в памяти формы. Справочники, документы и регистры вашей конфигурации не читаются и не записываются.
Кнопка и команда УчебноеДействие создаются программно. Не добавляйте их вручную: имена должны оставаться уникальными.
Проверяйте в установленной платформе 8.5.1.1343. Карточки и современное оформление дополнительно зависят от интерфейса, темы и режима совместимости; свойства не являются доказательством одинакового вида во всех клиентах.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
НовыеРеквизиты = Новый Массив;
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Товары", Новый ОписаниеТипов("ТаблицаЗначений")));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Код", Новый ОписаниеТипов("Строка"), "Товары", "Код"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Наименование", Новый ОписаниеТипов("Строка"), "Товары", "Название"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)), "Товары", "Количество"));
ЭтаФорма.ИзменитьРеквизиты(НовыеРеквизиты);
Данные = Новый ТаблицаЗначений;
Данные.Колонки.Добавить("Код", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Наименование", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)));
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "A-01";
СтрокаТовара.Наименование = "Книга";
СтрокаТовара.Количество = 3;
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "B-02";
СтрокаТовара.Наименование = "Ручка";
СтрокаТовара.Количество = 1;
ЭтаФорма.ЗначениеВРеквизитФормы(Данные, "Товары");
Таблица = ЭтаФорма.Элементы.Добавить("ТаблицаТоваров", Тип("ТаблицаФормы"));
Таблица.ПутьКДанным = "Товары";
Таблица.Заголовок = "Учебные товары";
Таблица.Шапка = Истина;
Таблица.АвтоВводНезаполненного = Ложь;
Таблица.АвтоВводНовойСтроки = Ложь;
Для Каждого ИмяКолонки Из СтрРазделить("Код,Наименование,Количество", ",") Цикл
Колонка = Элементы.Добавить("Товары" + ИмяКолонки, Тип("ПолеФормы"), Таблица);
Колонка.Вид = ВидПоляФормы.ПолеВвода;
Колонка.ПутьКДанным = "Товары." + ИмяКолонки;
Колонка.Заголовок = ИмяКолонки;
КонецЦикла;
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Проверить учебное количество";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"), Таблица.КоманднаяПанель);
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
Кнопка.Вид = ВидКнопкиФормы.КнопкаКоманднойПанели;
Кнопка.ПоложениеВКоманднойПанели = ПоложениеКнопкиВКоманднойПанели.ВКоманднойПанели;
Кнопка.Пометка = Ложь;
Кнопка.УникальностьКоманды = Истина;
Кнопка.ТолькоВоВсехДействиях = Ложь;
Кнопка.ВажностьПриОтображении = ВажностьПриОтображении.Высокая;
Сообщить(Кнопка.Родитель = Таблица.КоманднаяПанель);
Сообщить(Кнопка.ПоложениеВКоманднойПанели = ПоложениеКнопкиВКоманднойПанели.ВКоманднойПанели);
Сообщить(Кнопка.УникальностьКоманды);
Сообщить(Не Кнопка.Пометка);
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
Сообщить(СтрШаблон("Учебных строк: %1; общее количество: %2",
ЭтаФорма.Товары.Количество(), ЭтаФорма.Товары.Итог("Количество")));
КонецПроцедуры
Разбор по шагам
Команду создаём в той же форме, а кнопку сразу добавляем с правильным родителем.
ПоложениеВКоманднойПанели определяет панель/подменю; УникальностьКоманды помогает автоматическим группам не дублировать команду.
Пометка лишь меняет нажатый вид кнопки, не количество товара или состояние записи.
ВажностьПриОтображении влияет на размещение при адаптации; она отличается от Важность оформления.
Как проверить результат
Четыре сравнения Истина: правильный родитель, положение, уникальность и отсутствие пометки.
Кнопка панели выводит те же собственные 2/4; расположение при узком экране проверяйте в клиенте.
Ожидаемый результат
Кнопка связана с собственной таблицей и её панелью без дублирования действия.
На что обратить внимание
ТолькоВоВсехДействиях имеет отдельную семантику меню: читайте справку, не выводите её из имени свойства.
Пометка не является сохраняемым пользовательским флагом базы.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Отделить заголовок таблицы, шапку колонок и встроенные группы команд
ПоложениеЗаголовка=Нет скрывает подпись всей таблицы, но оставляет шапку колонок. Встроенная командная панель и контекстное меню — группы, а не строки товаров.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
В учебной базе: Файл → Новый → Внешняя обработка. Создайте управляемую форму и назначьте её основной. Дайте обработке имя УчебнаяТаблица.
Не добавляйте вручную реквизит Товары и одноимённые элементы: код создаст их при открытии. Модуль формы для этой задачи должен быть пустым.
В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Сохраните отдельную учебную EPF и откройте через Файл → Открыть.
Данные Книга/Ручка создаются в памяти формы. Справочники, документы и регистры вашей конфигурации не читаются и не записываются.
Проверяйте в настольном тонком/толстом или веб-клиенте 8.5.1.1343, не в мобильном приложении. Для каждого урока отдельная учебная форма с пустым модулем.
Изменение учебных строк остаётся только в открытой форме. При её новом открытии снова создаются Книга/3 и Ручка/1. Настройки таблицы не являются правами доступа к данным.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
НовыеРеквизиты = Новый Массив;
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Товары", Новый ОписаниеТипов("ТаблицаЗначений")));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Код", Новый ОписаниеТипов("Строка"), "Товары", "Код"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Наименование", Новый ОписаниеТипов("Строка"), "Товары", "Название"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)), "Товары", "Количество"));
ЭтаФорма.ИзменитьРеквизиты(НовыеРеквизиты);
Данные = Новый ТаблицаЗначений;
Данные.Колонки.Добавить("Код", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Наименование", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)));
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "A-01";
СтрокаТовара.Наименование = "Книга";
СтрокаТовара.Количество = 3;
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "B-02";
СтрокаТовара.Наименование = "Ручка";
СтрокаТовара.Количество = 1;
ЭтаФорма.ЗначениеВРеквизитФормы(Данные, "Товары");
Таблица = ЭтаФорма.Элементы.Добавить("ТаблицаТоваров", Тип("ТаблицаФормы"));
Таблица.ПутьКДанным = "Товары";
Таблица.Заголовок = "Учебные товары";
Таблица.Шапка = Истина;
Таблица.АвтоВводНезаполненного = Ложь;
Таблица.АвтоВводНовойСтроки = Ложь;
Для Каждого ИмяКолонки Из СтрРазделить("Код,Наименование,Количество", ",") Цикл
Колонка = Элементы.Добавить("Товары" + ИмяКолонки, Тип("ПолеФормы"), Таблица);
Колонка.Вид = ВидПоляФормы.ПолеВвода;
Колонка.ПутьКДанным = "Товары." + ИмяКолонки;
Колонка.Заголовок = ИмяКолонки;
КонецЦикла;
Таблица.Заголовок = "Учебные товары";
Таблица.ПоложениеЗаголовка = ПоложениеЗаголовкаЭлементаФормы.Нет;
Таблица.Шапка = Истина;
Таблица.ОтображатьКоманднуюПанель = Истина;
Сообщить(Таблица.Имя = "ТаблицаТоваров");
Сообщить(Таблица.Родитель = ЭтаФорма);
Сообщить(ТипЗнч(Таблица.КоманднаяПанель) = Тип("ГруппаФормы"));
Сообщить(ТипЗнч(Таблица.КонтекстноеМеню) = Тип("ГруппаФормы"));
Сообщить("Дочерних полей/групп таблицы: " + Строка(Таблица.ПодчиненныеЭлементы.Количество()));
КонецПроцедуры
Разбор по шагам
Заголовок хранит подпись, ПоложениеЗаголовка=Нет управляет её отсутствием в отображении.
Пустая строка Заголовок не равнозначна Нет: может включать автоматическую подпись. Поэтому явно выбираем нужное положение.
Шапка=Истина оставляет заголовки отдельных колонок Код, Наименование, Количество.
Таблица добавлена непосредственно в форму, поэтому Родитель=ЭтаФорма. КоманднаяПанель/КонтекстноеМеню возвращают встроенные ГруппаФормы.
ПодчиненныеЭлементы описывает элементы интерфейса. Их количество не равно Товары.Количество().
Как проверить результат
Четыре логических сообщения дают Истина; надпись Учебные товары скрыта, шапка колонок видна.
Данные остаются A-01/3 и B-02/1. Состав стандартных команд и вид панели сверяйте в выбранном клиенте.
Ожидаемый результат
Показано различие между подписью, шапкой, дочерними полями и встроенными группами команд.
На что обратить внимание
Не присваивайте новые значения свойствам КоманднаяПанель/КонтекстноеМеню: они доступны только для чтения.
Не делайте вывод о количестве товаров из количества дочерних элементов интерфейса.
Не используем ПоложениеКоманднойПанели: в интерфейсе Версия 8.5 оно не применяется.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.