1С: как получить картинку из коллекции картинок

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

Ключевой механизм — объект БиблиотекаКартинок. Он работает как коллекция: обращение к элементу выполняется по имени через точку или через квадратные скобки, а результатом является значение типа Картинка, которое можно присвоить реквизиту формы, ячейке табличного документа или команде интерфейса. Имена элементов совпадают с именами стандартных картинок платформы и общих картинок конфигурации.

Ниже разобраны все основные сценарии: программное получение картинки из библиотеки, работа с общими картинками, извлечение картинки из коллекции значений, вывод картинок в табличный документ и типичные ошибки, которые приводят к «крестику» вместо изображения.

Что такое коллекция картинок в 1С

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

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

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

Как получить стандартную картинку платформы

Самый простой сценарий — взять готовую пиктограмму платформы. Достаточно обратиться к БиблиотекаКартинок по имени нужной картинки:

КартинкаСохранить = БиблиотекаКартинок.Записать;
Элементы.ДекорацияСтатус.Картинка = БиблиотекаКартинок.Информация;

Имя можно указать и строкой через квадратные скобки — это удобно, когда имя картинки вычисляется динамически или хранится в настройках:

ИмяКартинки = "СоздатьЭлементСписка";
Картинка = БиблиотекаКартинок[ИмяКартинки];

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

Как получить общую картинку конфигурации

Общие картинки добавляются в конфигураторе через ветку «Общие → Общие картинки»: создайте новый элемент, задайте имя (например, ЛоготипКомпании) и загрузите файл изображения через кнопку «Загрузить из файла» в палитре свойств. Поддерживаются распространённые растровые форматы, в том числе PNG с прозрачностью.

После обновления конфигурации базы данных картинка доступна в коде так же, как стандартная:

Логотип = БиблиотекаКартинок.ЛоготипКомпании;
// или безопасный вариант через строку:
Логотип = БиблиотекаКартинок["ЛоготипКомпании"];

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

1. 1
   Откройте конфигуратор и в дереве конфигурации найдите ветку «Общие → Общие картинки»
2. 2
   Добавьте новую общую картинку и задайте ей понятное имя без пробелов
3. 3
   В палитре свойств загрузите файл изображения и при необходимости добавьте варианты для разных разрешений
4. 4
   Обновите конфигурацию базы данных
5. 5
   В коде обратитесь к картинке: БиблиотекаКартинок.ИмяКартинки
6. 6
   Проверьте отображение на форме или в табличном документе

Как извлечь картинку из коллекции данных

Если картинки хранятся в коллекции — таблице значений, списке значений или табличной части — обращение к БиблиотекаКартинок не нужно: картинка уже лежит в элементе коллекции, и задача сводится к правильному обращению к нему.

Таблица значений с колонкой «Картинка»

Обращение выполняется по индексу строки и имени колонки:

Для Каждого СтрокаТЗ Из ТаблицаКартинок Цикл
ТекущаяКартинка = СтрокаТЗ.Картинка;
// работа с картинкой
КонецЦикла;

Список значений с картинками

У элемента списка значений картинка хранится в свойстве Картинка:

Для Каждого ЭлементСписка Из СписокЗначений Цикл
КартинкаЭлемента = ЭлементСписка.Картинка;
КонецЦикла;

Картинка из реквизита объекта или хранилища значений

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

ДвоичныеДанные = СправочникОбъект.ФайлКартинки.Получить();
Если ДвоичныеДанные <> Неопределено Тогда
Картинка = Новый Картинка(ДвоичныеДанные);
КонецЕсли;

Для вывода такой картинки в управляемой форме реквизит формы должен иметь тип «Строка» с адресом во временном хранилище: двоичные данные помещаются через ПоместитьВоВременноеХранилище, а элемент формы «Поле картинки» ссылается на этот реквизит.

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

Вывод картинки в табличный документ

Частая практическая задача — вывести картинку из коллекции в печатную форму. В табличном документе картинки размещаются через коллекцию рисунков области:

ОбластьКартинка = Макет.ПолучитьОбласть("Картинка");
Рисунок = ТабличныйДокумент.Рисунки.Добавить(ТипРисункаТабличногоДокумента.Картинка);
Рисунок.Картинка = БиблиотекаКартинок.ЛоготипКомпании;
Рисунок.РазмерКартинки = РазмерКартинки.Пропорционально;
Рисунок.Верх = 2; Рисунок.Лево = 2;
Рисунок.Высота = 15; Рисунок.Ширина = 40;

Альтернатива — заранее добавить рисунок в макет табличного документа в конфигураторе, дать ему имя и в коде только подменять картинку: Область.Рисунки.ИмяРисунка.Картинка = НужнаяКартинка;. Этот способ удобнее, когда позиция и размеры изображения фиксированы дизайном печатной формы.

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

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

Главный признак проблемы — вместо изображения отображается пустое место или стандартный значок «крестик». Проверку стоит начинать с типа полученного значения: убедитесь, что переменная действительно содержит объект типа «Картинка», а не Неопределено или строку с именем.

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

Ограничения и безопасные приёмы

Объект БиблиотекаКартинок доступен и на клиенте, и на сервере, поэтому получение стандартных и общих картинок не требует разделения кода по контекстам. Однако загрузка картинки из файла конструктором Новый Картинка(Путь) зависит от контекста исполнения: на сервере путь трактуется относительно сервера, на клиенте — относительно машины пользователя. В тонком и веб-клиенте работа с локальными файлами дополнительно ограничена, и файлы следует передавать через механизм временного хранилища.

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

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

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