[Шпаргалка] Программное создание элементов формы

Публикация № 1118319

Программирование - Практика программирования

UI UX Интерфейс Элементы Управляемая форма ЭтаФорма Кнопка Поле Группа Динамический список программно программное

209
Программное создание практически всех популярных элементов формы.

Добрый день, Коллеги!

Предлагаю вашему вниманию шпаргалку, шаблоны кода для применения в разработке динамического интерфейса – программное формирование элементов управляемой формы. Особенно будет полезно начинающим разработчикам.

Применение

Есть определенные ситуации, когда без программного формирования элементов формы не обойтись:

  1. Заранее неизвестно какое количество элементов необходимо разместить на форме (Примеры: Система тестирования, где при формирование тестового задания заранее неизвестно сколько будет вопросов или документ корректировки регистров, когда так же заранее не известно какие колонки будут у таблицы формы).
  2. Доработка типового функционала. Программное размещение элементов впоследствии упрощает обновление типовых конфигураций. Многие разработчики даже придерживаются данного правила при работе с «расширениями».

Шпаргалка

 

Оглавление

Введение. 1

Общее. 2

Группа – Тип("ГруппаФормы"). 2

Поле – Тип("ПолеФормы"). 2

Создаем реквизит. 3

Создаем Поле. 3

Декорация – Тип("ДекорацияФормы"). 3

Декорация «Надпись». 3

Декорация «Картинка». 3

Кнопка – Тип("КнопкаФормы"). 3

Создание команды.. 3

Создание кнопок. 4

Бонус – общий модуль с готовыми функциями. 4

 

Введение

В публикации будет разработан пример создания интерфейса с задействованием практически всех популярных элементов формы. Одно из исключений - таблица, вариант программного создания таблицы описывал ранее - программное создание динамического списка. Ниже пример интерфейса, который будет разобран (тестировалось на платформе 8.3.15.1534):

Общее

Создание элементов, реквизитов и команд лучше производить в процедуре «ПриСозданииНаСервере».

Есть два варианта размещения элементов на форме – «добавить» и «вставить».

ЭтаФорма.Элементы.Добавить([Название нового элемента], [Тип элемента], [Элемент-родитель]) – Элемент будет добавлен на размещаемый элемент-родитель в конец списка.

ЭтаФорма.Элементы.Вставить([Название нового элемента], [Тип элемента], [Элемент-родитель], [Последующий элемент]) – Элемент будет добавлен на размещаемый элемент-родитель и вставлен перед желаемым элементом.

После создания элемента, мы можем определить ему свойства. Свойства практически всегда совпадают с названиями на панели свойств элемента.

 

Группа – Тип("ГруппаФормы")

Элементы формы, которые можно создать с типом «ГруппаФормы»:

  • ГруппаКнопок
  • ГруппаКолонок
  • КоманднаяПанель
  • КонтекстноеМеню
  • ОбычнаяГруппа
  • Подменю
  • Страницы
  • Страница
 
 Пример создания элементов типа "ГруппаФормы"

Поле – Тип("ПолеФормы")

Для работы элемента формы «Поле» необходимо наличие источника данных – реквизита. Если необходимого реквизита нет, его нужно предварительно создать.

Элементы формы, которые можно создать с типом «ПолеФормы»:

  • ПолеHTMLДокумента
  • ПолеВвода
  • ПолеГеографическойСхемы
  • ПолеГрафическойСхемы
  • ПолеДендрограммы
  • ПолеДиаграммы
  • ПолеДиаграммыГанта
  • ПолеИндикатор
  • ПолеКалендарь
  • ПолеКартинки
  • ПолеНадписи
  • ПолеПереключателя
  • ПолеПланировщика
  • ПолеПолосыРегулирования
  • ПолеТабличногоДокумента
  • ПолеТекстовогоДокумента
  • ПолеФлажок
  • ПолеФорматированногоДокумента

Создаем реквизит

При создании важно понимать, что указывается не "тип", а "описание типов" и для часто используемых типов: "строка", "число" и "дата", необходимо указывать квалификатор. Рассмотрим на примере ниже.

 
 Пример создания реквизитов

Создаем Поле

При создании поля указываем  тип «ПолеФормы», принцип мало чем отличается от создания группы:

 
 Пример создания полей

Декорация – Тип("ДекорацияФормы")

Обе существующие декорации имеют один тип, но разный вид.

Декорация «Надпись»

 
 Пример создания декорации надпись

Декорация «Картинка»

 
 Пример создания декорации картинка

Кнопка – Тип("КнопкаФормы")

Для работы кнопок, необходимо наличие команды. Если на форме нет определенной команды, то её необходимо создать программно.

Создание команды

Важно, для работы команды должно быть определено действие. Действие - это основная процедура команды, программно его создать не получится.

 
 Пример заранее описанного общего действия для всех команд
 
 Пример создания команды

Создание кнопок

 
 Пример создания кнопок

Бонус – общий модуль с готовыми функциями

«Лень - двигатель прогресса» и костылей J

Я пошел дальше, создал общий модуль, где описал создание всех выше описанных элементов формы. Поэтому предлагаю вам с ним познакомиться.  Для этого создайте новый модуль:

И скопируйте в него код:

 
 Код общего модуля

Удобно или нет - решать вам. Приведу лишь пример кода, созданного выше с помощью и без помощи общего модуля.

 
 Пример реализации интерфейса без использования функций общего модуля
 
 Пример реализации интерфейса с использованием функций общего модуля

 

Всем удачного кодинга!

 

Другие полезные шпаргалки:

 Несколько 1С-Серверов на одном сервере  Свой заголовок отчету на СКД (с параметрами)

 

Публикации по работе с интерфейсом:

 Интерактивный выбор даты  Интерактивный выбор периода

 Свой флажок  Цифровые и аналоговые часы

209

См. также

Специальные предложения

Комментарии
Избранное Подписка Сортировка: Древо
1. lmnlmn 53 06.09.19 13:38 Сейчас в теме
Каждый раз при необходимости создать программно элементы формы посещает мысль что надо бы сделать модуль, но все некогда и некогда. А у автора руки, таки, дошли. Полезно!
JohnyDeath; ids79; magdeevik; Senator_I; user774630; mnemchinov; rpgshnik; +7 Ответить
2. VmvLer 06.09.19 13:47 Сейчас в теме
как шпаргалка неплохо для новичков

пара замечаний, ну куда ж без них
1. Напишите жирным шрифтом
синтаксис ЭтаФорма.Элементы.
использовать только если этот фрагмент кода расположена в методе с параметром
ЭтаФорма, например Функция СоздатьГруппуФормы(ЭтаФорма, ПараметрыГруппы)
если же этот фрагмент кода будет расположен в модуле формы, то достаточно
написать Элементы.
Когда будет копипастить код из этой шпаргалки, то всегда думайте чтобы НЕ рукоягодничить.


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

пожалуй все остальное чики-пуки, больше замечаний нет.
unichkin; Interrupted; Yashazz; +3 Ответить
5. user774630 06.09.19 14:45 Сейчас в теме
(2)
можно найти в общих модулях типовых конфигураций

Ну вы бы сказали куда смотреть хотя бы для старта.
6. VmvLer 06.09.19 15:01 Сейчас в теме
(5) раздел "общие модули"

искать аналоги глобальным поиском от пары секунд до минуты если вы конечно видели конфигуратор.
7. user774630 06.09.19 15:09 Сейчас в теме
(6) Ну т.е. как и большинство ваших комментов - вякнуть и всё.
8. VmvLer 06.09.19 15:25 Сейчас в теме
(7) Большинство моих комментариев по существу, но прямолинейно - это неприятно многим.

А от вас пока лишь хамство.

В чем я не прав конкретно в комментарии в (2) или в (6) - разве это не по существу вопроса?
13. Yashazz 2519 06.09.19 19:53 Сейчас в теме
(7) А вы, товарисч, не ленитесь, время - оно денег стоит, а опыт по отыскиванию чего-либо в коде БСП и вовсе бесценен. А то вам мало что разжуй, так ещё и пищеварить, а как отказывают, так вы сразу хамите? Ну-ну.
10. rpgshnik 1602 06.09.19 15:48 Сейчас в теме
(2) этот код вызывается из общего модуля, по другому не получилось. Я знаю, что в модуле формы не обязательно писать ЭтаФорма. Я предлагаю не функции копипастить в модуль формы, а целиком модуль создать для этих целей. И при необходимости вызывать с модуля формы, функцию общего модуля.
12. Labotamy 06.09.19 19:08 Сейчас в теме
Свойство ЭтаФорма объекта УправляемаяФорма удалено и поддерживается для совместимости. https://dl04.1c.ru/content/Platform/8_3_3_641/1cv8upd.htm

Как бы 6ть лет прошло. Пора уже вообще забыть "ЭтаФорма"
azhilichev; MVK80; +2 Ответить
16. rpgshnik 1602 07.09.19 09:18 Сейчас в теме
(12) хорошее замечание, проверю. Удаленно "условно" выходит 🙃
22. MVK80 09.09.19 14:50 Сейчас в теме
(12), это будет до тех пор, пока разработчики типовых сами не избавятся от этого. Так-то, да я сам всегда использую ЭтотОбъект вместо ЭтаФорма и другим рекомендую.
rpgshnik; +1 Ответить
26. unichkin 1183 13.09.19 02:48 Сейчас в теме
3. TanisIntec 3 06.09.19 14:18 Сейчас в теме
Как раз занимался динамическим созданием, полезная инфа
rpgshnik; +1 Ответить
4. Timic 12 06.09.19 14:26 Сейчас в теме
В примере создания полей я бы поменял местами присваивание вида и пути к данным. Сначала устанавливаем путь к данным, потом вид поля формы. По крайней мере раньше при установке пути к данным вид автоматически устанавливался в поле надписи
9. Senator_I 2 06.09.19 15:45 Сейчас в теме
Спасибо, полезная вещь, добавил себе в "Избранное".
rpgshnik; +1 Ответить
11. ids79 3727 06.09.19 15:56 Сейчас в теме
Спасибо, полезный материал!
Сам хотел написать подобную статью, Вы меня опередили ))
Для расширений динамическое создание элементов форм - это уже почти стандарт.
rpgshnik; +1 Ответить
14. Yashazz 2519 06.09.19 19:54 Сейчас в теме
(11) Вот и убивать надо за такой стандарт. Есть же нормальная возможность перегрузить форму своей собственной, нафига такие танцы с бубном? Чтоб ваши последователи тратили втрое больше времени, пытаясь а) спрогнозировать внешний вид, б) поменять, чтоб ничего не сдохло?
17. ids79 3727 07.09.19 09:19 Сейчас в теме
(14)Позволю себе с Вами не согласиться. Я сам сперва добавлял и изменял реквизиты в загруженной в расширение форме. Но потом перешел на программное создание именно для большей прозрачности и управляемости. Хотя, в целом, я сторонник использования расширений.
Anchoret; rpgshnik; +2 Ответить
20. azhilichev 148 09.09.19 10:32 Сейчас в теме
(14) Программное создание отлично подходит для подключаемых механизмов, в виде API. Пример. Вы реализовали визуальный инструмент, который нужно подключить к нескольким формам. Вносить интерфейсные изменения во все формы - так себе решение. При каждом изменении внешнего вида и поведения необходимо будет вносить изменения во все экземпляры. Работа же через API - более логичное решение. Условно, при создании формы вызывается конструктор, который дополняет форму. И вся работа инструмента идет через 1-3 обработчика, которые используют единую логику, вынесенную в общий модуль.
rpgshnik; +1 Ответить
15. Yashazz 2519 06.09.19 19:57 Сейчас в теме
Как и любая мода, этот подход сейчас на слуху и популярен, а потому шпаргалка, безусловно, невредная для начинающих. Но, уверен, программное создание под тяжестью собственной непрозрачности, негибкости, времязатратности и громоздкости рано или поздно займёт подобающее ему небольшое место в ряду иных инструментов. Это костыль, однажды он на 90% отомрёт.
FreeArcher; +1 4 Ответить
18. Yashazz 2519 08.09.19 10:21 Сейчас в теме
(15) Знаете, примерно так же со мной не соглашались, когда я говорил, что концепция "переопределяемых" модулей - это костыль. Мне говорили, ты что, это удобно, прогрессивно и прозрачно, дописал своё в типовой и обновлять легче! А потом появились расширения)
Так что, господа, попрыгаете на грабли программной доработки формы (особенно чужой и криво сделанной), поймёте. Лет через 5 вернёмся к этой теме)
19. azhilichev 148 09.09.19 10:24 Сейчас в теме
(15)
программное создание под тяжестью собственной непрозрачности, негибкости, времязатратности и громоздкости

Если сделана грамотная декомпозиция методов по созданию элементов, команд, реквизитов и обработчиков, то трудозатраты на доработку программно-генерируемого интерфейса формы лишь незначительно больше, чем на изучение и разработку в конструкторе.
21. Andrefan 09.09.19 10:41 Сейчас в теме
Отличная работа, спасибо. Для полноты картины хотелось бы ещё увидеть сложные ЭУ: таблица формы, динамический список, командная панель, контекстное меню таблиц.
rpgshnik; +1 Ответить
23. rpgshnik 1602 09.09.19 14:57 Сейчас в теме
(21) Динамический список включен в код модуля в конце публикации, а писал я про него уже давненько https://infostart.ru/public/728597/
24. smirnov.es 16 11.09.19 10:36 Сейчас в теме
Дима, спасибо за такой качественный контент.
rpgshnik; +1 Ответить
25. rpgshnik 1602 11.09.19 15:02 Сейчас в теме
Оставьте свое сообщение