Как вставить картинку в форму 1С

Изображения в формах 1С нужны в самых разных задачах: фото товара в карточке номенклатуры, логотип компании на форме отчёта, скан документа, подпись сотрудника, пиктограммы состояния. В зависимости от цели используются разные механизмы — от простого реквизита формы с картинкой до вывода изображения из двоичных данных в базе.

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

Важно понимать: в управляемой форме нельзя просто «перетащить» файл картинки, как в редакторе документов. Изображение привязывается либо к реквизиту, либо к элементу формы с указанием источника. Поэтому большая часть работы — это правильная настройка реквизита и элемента, а не сама вставка.

Какие способы вставки картинки существуют в 1С

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

Основных сценариев четыре. Первый — декоративная картинка, которая не меняется: логотип, подсказка, оформление. Второй — изображение, связанное с данными объекта: фото товара, скан документа. Третий — картинка из стандартной библиотеки платформы для оформления кнопок и статусов. Четвёртый — динамическая картинка, формируемая программно, например штрихкод или QR-код.

Вставка статичной картинки через декорацию или реквизит

Если нужно просто показать на форме логотип или иллюстрацию, которая не зависит от данных, проще всего использовать элемент «Декорация» или реквизит типа «Картинка».

1. 1
   Откройте форму в конфигураторе (режим редактирования формы).
2. 2
   Добавьте реквизит формы, например «Логотип», с типом «Картинка».
3. 3
   Перетащите реквизит в дерево элементов формы — платформа создаст поле картинки.
4. 4
   В свойствах реквизита или в палитре свойств поля задайте значение картинки: из файла, из библиотеки или из общей картинки конфигурации.
5. 5
   Настройте размер: свойства «РазмерКартинки» (Пропорционально, РеальныйРазмер, Растянуть) и положение на форме.
6. 6
   Сохраните форму и проверьте отображение в режиме 1С:Предприятие.

Альтернатива без реквизита: добавьте в элементы формы «Декорацию» с видом «Картинка» и в её свойствах укажите нужное изображение. Этот вариант легче, но не позволяет программно менять картинку через реквизит — только через свойства элемента.

Обратите внимание на свойство «РазмерКартинки». Значение «Пропорционально» сохраняет пропорции изображения при изменении размера поля — это почти всегда правильный выбор для логотипов и фото. «Растянуть» искажает картинку, «РеальныйРазмер» может обрезать её, если поле меньше изображения.

Вывод картинки из базы данных (фото товара, скан документа)

Самый частый прикладной сценарий — показать изображение, которое хранится в информационной базе: в реквизите типа «ХранилищеЗначения», в присоединенных файлах (БСП) или в регистре сведений. В управляемой форме такое изображение выводится через строковый реквизит, содержащий адрес временного хранилища.

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

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
	ДвоичныеДанные = Объект.Фото.Получить(); // реквизит типа ХранилищеЗначения
	Если ДвоичныеДанные <> Неопределено Тогда
		АдресКартинки = ПоместитьВоВременноеХранилище(ДвоичныеДанные, УникальныйИдентификатор);
	КонецЕсли;
КонецПроцедуры

Для этого сценария создайте реквизит формы «АдресКартинки» типа «Строка» (длина не ограничена или достаточная) и добавьте на форму элемент «Поле картинки», связанный с этим реквизитом. В свойствах поля укажите путь к данным — имя реквизита.

Загрузка картинки с диска по кнопке пользователя

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

&НаКлиенте
Процедура ЗагрузитьФото(Команда)
	Оповещение = Новый ОписаниеОповещения("ЗагрузитьФотоЗавершение", ЭтотОбъект);
	НачатьПомещениеФайла(Оповещение, , , Истина, УникальныйИдентификатор);
КонецПроцедуры

&НаКлиенте
Процедура ЗагрузитьФотоЗавершение(Результат, Адрес, ВыбранноеИмяФайла, ДопПараметры) Экспорт
	Если Результат Тогда
		АдресКартинки = Адрес;
		Модифицированность = Истина;
	КонецЕсли;
КонецПроцедуры

После помещения файла адрес временного хранилища присваивается строковому реквизиту, и поле картинки сразу показывает выбранное изображение. Чтобы картинка сохранилась в базе, при записи объекта нужно получить двоичные данные из хранилища и записать их в реквизит объекта — например, в «ХранилищеЗначения» или в присоединенный файл.

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

Картинки из библиотеки и общие картинки конфигурации

Для оформления форм — иконки команд, индикаторы статусов, пиктограммы — не нужно хранить файлы в базе. Платформа предоставляет стандартную библиотеку картинок, а конфигурация может содержать собственные общие картинки (ветка «Общие» → «Общие картинки» в дереве конфигурации).

Чтобы использовать такую картинку, выделите элемент формы (кнопку, декорацию, поле) и в палитре свойств откройте свойство «Картинка». В диалоге выбора доступны три источника: из конфигурации (общие картинки), из библиотеки картинок платформы и из файла. Для кнопок команд панелей обычно выбирают библиотечные картинки — они единообразны со стандартным интерфейсом.

Программно библиотечная картинка доступна через объект БиблиотекаКартинок, например: Элементы.КнопкаПечать.Картинка = БиблиотекаКартинок.Печать;. Это удобно, когда вид кнопки нужно менять в зависимости от состояния документа.

Вставка картинки в обычные формы

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

Для реквизита объекта типа «ХранилищеЗначения» поле картинки в обычной форме умеет работать напрямую: укажите в свойстве «Данные» путь к реквизиту, и платформа сама извлечёт изображение. Дополнительный код для временного хранилища в обычных формах не нужен — это особенность именно управляемых форм.

Проверка результата и типичные ошибки

После настройки откройте форму в режиме 1С:Предприятие и проверьте не только факт отображения картинки, но и поведение при изменении размера окна, при перечитывании объекта и после записи.

Ограничения и рекомендации по производительности

Изображения большого размера заметно влияют на скорость работы: они передаются между сервером и клиентом при каждом открытии формы. Фотографии с камеры или телефона часто весят несколько мегабайт — для карточки товара обычно достаточно изображения с шириной в несколько сотен пикселей.

Рекомендуется при загрузке уменьшать изображение средствами объекта «Картинка» или внешними средствами, хранить в базе оптимизированную версию, а оригинал — при необходимости — как отдельный присоединенный файл. Также не выводите картинки в списках с большим числом строк: это резко замедляет прокрутку.

Частые вопросы