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

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

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

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

Где находится библиотека картинок и что в ней хранится

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

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

Пошаговое добавление картинки через конфигуратор

Стандартный способ — добавление через дерево конфигурации. Подготовьте файл заранее: желательно PNG с прозрачным фоном, размером 16×16 или 32×32 пикселя для кнопок и команд. Слишком большое изображение платформа сожмёт, и мелкие детали «поплывут».

1. 1
   Откройте конфигуратор и разверните ветку «Общие» → «Общие картинки».
2. 2
   Щёлкните правой кнопкой по ветке и выберите «Добавить» (или «Добавить общую картинку»).
3. 3
   В палитре свойств задайте имя картинки латиницей без пробелов — оно станет идентификатором в коде.
4. 4
   В свойстве «Картинка» нажмите кнопку выбора и укажите файл на диске, затем подтвердите загрузку.
5. 5
   Сохраните конфигурацию (Ctrl+S или «Конфигурация» → «Сохранить конфигурацию»).
6. 6
   Обновите конфигурацию базы данных, если платформа запросит это (клавиша F7).

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

Как назначить картинку кнопке, команде или элементу формы

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

В программном коде обращение идёт через глобальную коллекцию:

Элементы.КнопкаПечати.Картинка = БиблиотекаКартинок.МояКартинка;
// или при программном создании команды
НоваяКоманда = Команды.Добавить("ОткрытьОтчет");
НоваяКоманда.Картинка = БиблиотекаКартинок.МояКартинка;

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

Форматы, размеры и ограничения

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

Ограничения, которые стоит учитывать:

• Размер под кнопки и команды — 16×16 или 32×32 px; платформа масштабирует, но с потерей чёткости.
• Имя картинки — только допустимые символы идентификатора: латиница, цифры, без пробелов и начала с цифры.
• Анимированные GIF в элементах интерфейса обычно отображаются статичным кадром.
• Каждая картинка увеличивает размер конфигурации — не загружайте фотографии весом в мегабайты для пиктограмм.

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

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

Альтернативы: картинки из файлов и хранилища значений

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

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

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