Как программно поменять картинку у кнопки в 1С: от простого к сложному

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

Особенность работы с графикой в 1С 8.3 заключается в том, что система использует собственные форматы хранения изображений (.pcx, .bmp) и кэширует их в метаданных. Это накладывает ограничения на размеры (оптимально 16×16 или 32×32 пикселей) и цветовую палитру. При этом современные версии платформы поддерживают PNG с прозрачностью, что открывает больше возможностей для дизайна.

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

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

1. Замена картинки через конфигуратор: пошаговая инструкция

Самый простой способ — редактирование свойств кнопки непосредственно в конфигураторе. Он не требует написания кода и подходит для разовых изменений. Рассмотрим процесс на примере управляемой формы.

Откройте конфигуратор в режиме 1С:Предприятие, найдите нужную форму (например, Документ.ЗаказКлиента.Форма.ФормаДокумента) и выполните следующие действия:

• 🔧 Перейдите на вкладку Элементы в дереве формы и выберите кнопку, иконку которой нужно изменить.
• 🖼️ В панели свойств найдите параметр Картинка (или Изображение для командной панели).
• 📁 Нажмите на многоточие (...) рядом с полем — откроется окно выбора изображения из библиотеки 1С.
• 🔄 Если нужной картинки нет, загрузите свою через кнопку Добавить, выбрав файл в формате .bmp или .png (размером не более 32×32 пикселей).

После сохранения изменений и обновления конфигурации базы новая иконка отобразится у всех пользователей. Этот метод подходит для замены стандартных изображений (например, иконки "Добавить" или "Удалить") на кастомные.

Сохраните картинку в формате PNG с прозрачностью (24-bit)

Уменьшите размер до 16×16 или 32×32 пикселей

Проверьте контрастность — иконка должна быть чёткой на тёмном и светлом фоне

Используйте нейтральные цвета из палитры 1С (оттенки синего, зелёного, серого)

-->

⚠️ Внимание: При замене иконок через конфигуратор учитывайте, что: 1С кэширует изображения в метаданных. Если после замены старая картинка остаётся, очистите кэш через Файл → Открыть... → Обновление конфигурации базы данных с флагом "Очистить кэш".

Для управляемых форм изменения применяются только после переоткрытия формы или перезапуска клиента.

2. Динамическая замена через код на клиенте

Если требуется менять иконки в зависимости от условий (например, подсвечивать кнопку красным при ошибках или показывать разные картинки для разных ролей), используйте программный код. Для этого подходит событие ПриСозданииНаКлиенте или ПриОткрытии формы.

Пример кода для замены иконки кнопки "Провести" в документе:

&НаКлиенте
Процедура ФормаДокументаПриСозданииНаКлиенте(Отказ, СтандартнаяОбработка)
// Получаем элемент формы по имени
КнопкаПровести = Элементы.Провести;

// Загружаем картинку из файла (путь относительно каталога базы)
ПутьККартинке = КаталогПрограммы() + "\Images\custom_check.png";
Картинка = Новый Картинка(ПутьККартинке);

// Присваиваем картинку кнопке
КнопкаПровести.Картинка = Картинка;
КонецПроцедуры

Для загрузки изображений из внешних источников (например, с веб-сервера) используйте HTTPСоединение:

&НаКлиенте
Функция ПолучитьКартинкуПоURL(Адрес)
HTTP = Новый HTTPСоединение(Адрес);
ДвоичныеДанные = HTTP.Получить();
Возврат Новый Картинка(ДвоичныеДанные);
КонецФункции

• 📌 Где хранить картинки?
  • В каталоге базы (например, C:\Program Files\1Cv8\srvinfo\<ID базы>\Images\).
  • В справочнике "ХранилищеДополнительнойИнформации" (для распределённых баз).
  • На веб-сервере (если есть доступ к интернету).
• 🔄 Когда обновляется иконка?

  При каждом открытии формы или по событию (например, после проверки данных).

КонецПроцедуры-->

3. Замена иконок через внешние обработки

Если изменять конфигурацию нельзя (например, в типовых решениях 1С:ERP или 1С:УТ), используйте внешние обработки. Они позволяют подменять иконки без внесения изменений в основную базу.

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

Пример кода для обработки:

Перем Картинки;

Процедура ПриСозданииНаКлиенте(Объект)
// Загружаем картинки из ресурсов обработки
Картинки = Новый Соответствие;
Картинки.Вставить("Сохранить", Ресурсы.ИконкаСохранить);
Картинки.Вставить("Провести", Ресурсы.ИконкаПровести);

// Меняем иконки для всех кнопок формы
Для Каждого Элемент Из Объект.Элементы Цикл
Если Картинки.Свойство(Элемент.Имя) Тогда
Элемент.Картинка = Картинки[Элемент.Имя];
КонецЕсли;
КонецЦикла;
КонецПроцедуры

Чтобы добавить картинки в ресурсы обработки: 1. Откройте обработку в конфигураторе. 2. Перейдите на вкладку Ресурсы и нажмите Добавить → Картинка. 3. Загрузите файлы и присвойте им имена (например, ИконкаСохранить).

⚠️ Внимание: Внешние обработки могут конфликтовать с обновлениями типовой конфигурации. После обновления платформы 1С проверяйте работоспособность кода, особенно если он взаимодействует с внутренними методами форм.

4. Работа с командными панелями и панелями действий

Кнопки в командных панелях (например, в верхней части формы документа) и панелях действий (левое меню) настраиваются иначе, чем обычные элементы формы. Здесь картинки привязаны к командам, а не к визуальным элементам.

Чтобы изменить иконку команды: 1. Найдите команду в дереве конфигурации (раздел Команды). 2. В свойствах команды укажите путь к картинке в параметре Картинка. 3. Обновите конфигурацию и перезапустите клиент.

Пример программной замены иконки команды "Создать":

&НаСервере
Процедура ЗаменитьИконкуКоманды()
Команда = Метаданные.Команды.НайтиПоИмени("Создать");
Если Команда <> Неопределено Тогда
ПутьККартинке = КаталогПрограммы() + "\new_icon.png";
Команда.Картинка = Новый Картинка(ПутьККартинке);
Метаданные.Записать(); // Сохраняем изменения
КонецЕсли;
КонецПроцедуры

Через конфигуратор (статически)

Динамически через код на клиенте

Внешние обработки

Не меняю иконки-->

5. Оптимизация иконок для 1С: форматы и размеры

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

Основные правила: 1. Форматы: Поддерживаются .bmp (без сжатия), .png (с прозрачностью), .jpg (не рекомендуется из-за артефактов). 2. Размеры: Оптимальные — 16×16 (для кнопок), 32×32 (для командных панелей). Максимальный размер — 128×128, но он редко используется. 3. Цвета: Используйте 256-цветную палитру для .bmp или 24-bit для .png. Избегайте градиентов — они плохо смотрятся в маленьком размере.

Для создания иконок под 1С рекомендуем:

• 🎨 Использовать редакторы: GIMP (бесплатный), Adobe Photoshop, или онлайн-сервисы вроде Iconion.
• 🔍 Проверять чёткость на масштабе 400% — если иконка размывается, упростите дизайн.
• 🌈 Для прозрачности в .png используйте альфа-канал, но учитывайте, что в 1С 8.2 могут быть проблемы с отображением.

6. Типичные ошибки и их решения

При работе с иконками в 1С разработчики часто сталкиваются с типичными проблемами. Разберём самые распространённые и способы их устранения.

• 🚫 Иконка не меняется после обновления конфигурации
  • Причина: Кэш метаданных. Решение: Очистите кэш через Файл → Открыть... → Обновление конфигурации базы данных с флагом "Очистить кэш".
  • Если используется 1С:Предприятие 8.3.20+, попробуйте перезапустить клиент с ключом /ClearCache.
• 🖼️ Картинка отображается размыто или с артефактами
  • Причина: Неправильный размер или формат. Решение: Пересохраните иконку в PNG-24 с размерами 16×16 или 32×32.
  • Для 1С 8.2 используйте BMP с палитрой 256 цветов.
• ⚠️ Ошибка "Недопустимый формат картинки"
  • Причина: Файл повреждён или имеет несопротивленный формат. Решение: Откройте картинку в редакторе и пересохраните в другом формате.
  • Проверьте, что файл не заблокирован антивирусом.

Если иконки не отображаются в веб-клиенте или мобильном приложении, убедитесь, что: 1. Картинки загружены в PNG (веб-клиент не поддерживает BMP). 2. Пути к файлам указаны относительно каталога базы или используются ресурсы. 3. В настройках публикации на веб-сервере разрешена загрузка внешних файлов.

7. Автоматизация замены иконок для больших проектов

В крупных конфигурациях (например, 1С:ERP или 1С:КА 2) ручная замена иконок занимает много времени. Для автоматизации используйте скрипты на 1Script или PowerShell, которые массово обновляют картинки в метаданных.

Пример скрипта для замены иконок всех кнопок с именем "Печать":

// 1Script для обхода метаданных
Для Каждого Объект Из Метаданные.Объекты Цикл
Если Объект.Тип = ТипМетаданных.Документ Тогда
Форма = Объект.Формы.НайтиПоИмени("ФормаОбъекта");
Если Форма <> Неопределено Тогда
Для Каждого Элемент Из Форма.Элементы Цикл
Если Элемент.Имя = "Печать" Тогда
Элемент.Картинка = Новый Картинка("C:\Icons\print.png");
КонецЕсли;
КонецЦикла;
КонецЕсли;
КонецЕсли;
КонецЦикла;

Для интеграции с системами контроля версий (Git, SVN) храните иконки в отдельной папке проекта и подгружайте их при сборке конфигурации. Это упрощает обновление дизайна и откат изменений.

• 🔄 Инструменты для массовой замены:
  • 1С:Анализ кода — находит все упоминания картинок в модулях.
  • EDT (Eclipse Development Tools) — позволяет редактировать метаданные в текстовом виде.
  • Скрипты на Python с использованием библиотеки py1c.

⚠️ Внимание: При автоматизированной замене иконок в типовых конфигурациях учитывайте, что обновления от 1С могут сбросить ваши изменения. Используйте расширения конфигурации или внешние обработки, чтобы минимизировать риски.

FAQ: Ответы на частые вопросы

Если РазрешениеЭкрана.Ширина > 1920 Тогда
Картинка = Новый Картинка("big_icon.png");
Иначе
Картинка = Новый Картинка("small_icon.png");
КонецЕсли;