Как добавить картинку в обработку 1С

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

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

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

Какие форматы и способы хранения поддерживает 1С

Платформа 1С работает с распространёнными растровыми форматами: PNG, JPEG, GIF, BMP. Для интерфейсных элементов чаще всего используют PNG с прозрачным фоном — он корректно отображается на кнопках и в полях формы. SVG в чистом виде платформа не отрисовывает, его нужно предварительно конвертировать.

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

Добавление картинки через макет обработки

Самый надёжный способ для внешней обработки — встроить картинку в макет. Тогда изображение «путешествует» вместе с файлом обработки и не зависит от внешних путей. Откройте обработку в конфигураторе, перейдите на вкладку «Макеты», нажмите «Добавить» и выберите тип макета «Двоичные данные». Затем через диалог загрузите файл изображения.

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

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

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

Загрузка картинки из файла на диске

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

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

1. 1
   Добавьте на форму кнопку «Загрузить картинку» и реквизит типа Строка для адреса хранилища
2. 2
   В обработчике кнопки вызовите НачатьПомещениеФайла с описанием оповещения
3. 3
   В процедуре оповещения сохраните полученный адрес в реквизит формы
4. 4
   Свяжите реквизит с элементом «Поле картинки» и проверьте отображение
5. 5
   Протестируйте сценарий в тонком клиенте, а не только в толстом

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

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

Картинки на кнопках и в командной панели

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

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

Отображение картинок из информационной базы

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

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

Обратите внимание на ветку «Иначе»: если картинки в базе нет, поле нужно очистить или подставить пустую картинку, иначе на форме останется предыдущее изображение. Это одна из самых частых причин «залипания» картинок при обходе списка товаров.

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

Проверка результата и ограничения

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

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

Выбор подходящего способа

Часто задаваемые вопросы