Как вывести на форме поле картинки в 1С

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

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

Откуда берётся картинка: выбор источника данных

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

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

Добавление реквизита и элемента формы в конфигураторе

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

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

1. 1
   Откройте форму в конфигураторе и добавьте реквизит формы (строка для адреса) или используйте реквизит объекта
2. 2
   Перетащите реквизит в дерево элементов формы в нужное место
3. 3
   В палитре свойств установите Вид = Поле картинки
4. 4
   Настройте РазмерКартинки и ширину/высоту элемента
5. 5
   Напишите код заполнения реквизита в ПриСозданииНаСервере или ПриОткрытии
6. 6
   Сохраните конфигурацию и проверьте отображение в режиме Предприятие

Вывод изображения из присоединённых файлов

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

Логика такая: найти присоединённый файл объекта, получить его данные с помощью функции БСП РаботаСФайлами.ДанныеФайла, взять из результата свойство «СсылкаНаДвоичныеДанныеФайла» и присвоить его строковому реквизиту формы. Вызывать это нужно при создании формы на сервере и после изменения объекта, чтобы картинка обновлялась.

// В модуле формы
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
ПоказатьФото();
КонецПроцедуры

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

Вывод картинки из ХранилищаЗначения

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

Пример кода: ДвоичныеДанные = Объект.Фото.Получить();, затем АдресКартинки = ПоместитьВоВременноеХранилище(ДвоичныеДанные, УникальныйИдентификатор);. Передача уникального идентификатора формы вторым параметром критична — она привязывает хранилище к времени жизни формы, и адрес не «протухнет» при серверных вызовах.

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

Динамическая загрузка и обновление картинки

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

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

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

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

Если поле пустое, идите по цепочке: убедитесь, что реквизит заполнен (выведите его значение в сообщение), что вид элемента — именно «Поле картинки», а не «Поле надписи», и что адрес получен с привязкой к УникальныйИдентификатор формы. Ошибка «неверный формат данных» обычно означает, что в строковый реквизит попали сами двоичные данные, а не адрес хранилища.

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

В тонком клиенте поле картинки корректно отображает распространённые форматы: PNG, JPEG, BMP, GIF. Экзотические форматы (например, TIFF с некоторыми кодировками) могут не отрисоваться — конвертируйте их при загрузке. В веб-клиенте поведение аналогично, но большие изображения заметно влияют на скорость открытия формы, так как передаются по сети каждый раз.

Практическая рекомендация: при загрузке уменьшайте фото до разумного размера (например, до 800–1200 пикселей по большей стороне) средствами объекта «Картинка» или внешней обработкой. Для списков, где нужно много миниатюр, храните отдельные уменьшенные копии, а не масштабируйте полноразмерные фото на форме.

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