Создает картинку из двоичных данных. В режиме запуска "Веб-клиент" конструктор не используется.
Синтаксис
Новый Картинка(<ДвоичныеДанные>, <ПрозрачныйФон>)Полное описание, параметры и ограничения
Картинка.Формирование из двоичных данных
Картинка (Picture)
Формирование из двоичных данных
Доступен, начиная с версии 8.0.
Синтаксис:
Новый Картинка(<ДвоичныеДанные>, <ПрозрачныйФон>)
Параметры:
<ДвоичныеДанные> (обязательный)
Тип: ДвоичныеДанные.
Двоичные данные изображения, из которого будет сформирован объект Картинка.
<ПрозрачныйФон> (необязательный)
Тип: Булево.
Определяет, будет ли использован цвет прозрачности при создании картинки.
Используется только для картинок, формат которой не поддерживает прозрачности.
За цвет прозрачности принимается цвет последнего пикселя (правый - нижний).
Значение по умолчанию: Ложь.
Описание:
Создает картинку из двоичных данных.
В режиме запуска "Веб-клиент" конструктор не используется.
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Получить PNG диаграммы в памяти и проверить размер картинки
Задаём 640×360 пикселей и формат PNG явно. Получение картинки не равно сохранению отчёта на диск или подтверждению читаемости подписей.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Учебная база, серверный общий модуль УчебныеЗадачи, фрагмент внутри ВыполнитьПример() Экспорт.
Числа вымышлены. Файлы, печать и запросы к данным конфигурации не используются.
Для визуальной проверки в собственной управляемой обработке создайте реквизит КартинкаГрафика типа Картинка и поле картинки. Возвращайте Изображение из серверной функции и присваивайте реквизиту, не строке пути.
Диаграмма = Новый Диаграмма;
Диаграмма.ТипДиаграммы = ТипДиаграммы.Гистограмма;
План = Диаграмма.УстановитьСерию("plan");
План.Текст = "План, шт.";
Факт = Диаграмма.УстановитьСерию("actual");
Факт.Текст = "Факт, шт.";
Месяцы = Новый Массив;
Месяцы.Добавить(Новый Структура("Ключ,Название,План,Факт", "2026-01", "Январь", 10, 8));
Месяцы.Добавить(Новый Структура("Ключ,Название,План,Факт", "2026-02", "Февраль", 12, 11));
Месяцы.Добавить(Новый Структура("Ключ,Название,План,Факт", "2026-03", "Март", 15, 16));
Для Каждого Месяц Из Месяцы Цикл
Точка = Диаграмма.УстановитьТочку(Месяц.Ключ);
Точка.Текст = Месяц.Название;
Диаграмма.УстановитьЗначение(Точка, План, Месяц.План);
Диаграмма.УстановитьЗначение(Точка, Факт, Месяц.Факт);
КонецЦикла;
Диаграмма.ОбластьЗаголовка.Текст = "Учебный план/факт, шт.";
Диаграмма.ВидПодписей = ВидПодписейКДиаграмме.Значение;
Диаграмма.ФорматЗначенийВПодписях = "ЧДЦ=0;ЧН=0";
Диаграмма.ЦветФона = Новый Цвет(255, 255, 255);
Диаграмма.ПрозрачныйФон = Ложь;
Изображение = Диаграмма.ПолучитьКартинку(640, 360, ФорматКартинки.PNG);
Сообщить(Изображение.Ширина() = 640);
Сообщить(Изображение.Высота() = 360);
БайтыPNG = Изображение.ПолучитьДвоичныеДанные();
Если БайтыPNG = Неопределено Тогда
ВызватьИсключение "Не получены двоичные данные собственного PNG";
КонецЕсли;
Сообщить(БайтыPNG.Размер() > 0);
Копия = Новый Картинка(БайтыPNG);
Сообщить(Копия.Ширина() = 640 И Копия.Высота() = 360);
Сообщить("PNG сформирован только в памяти, файл не записывался.");Разбор по шагам
Полная собственная матрица план/факт создаётся в памяти и оформляется до получения картинки.
ПолучитьКартинку получает размеры и формат явно: нулевые размеры означают отдельное поведение текущего элемента или размеров по умолчанию.
Ширина() и Высота() картинки — методы, не свойства. Проверяем заданные 640×360.
ПолучитьДвоичныеДанные даёт PNG; проверяем наличие и размер, затем создаём отдельную Картинка из этих байтов.
Записать не вызывается. Картинка в памяти может быть показана через собственный реквизит, но это отдельная визуальная проверка.
Как проверить результат
Четыре булевых сообщения Истина: размеры исходной и повторно созданной картинки совпадают, байты не пустые.
При показе через реквизит формы отдельно проверьте читаемость месяцев, легенды и чисел. Ненулевой размер байтов этого не доказывает.
Ожидаемый результат
Растровое представление получено с контролируемыми размерами и пройдено обратное создание картинки без файла.
На что обратить внимание
Возможность получить картинку в серверном контексте не подтверждает установленный шрифт или идеальную верстку на любом клиенте.
Не используйте размеры 0, если нужен предсказуемый размер внешнего изображения.
При реальной выгрузке файл, доставка и права доступа требуют отдельного явного решения; здесь их нет.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Показать зелёный значок книги и синий значок ручки
Создаём SVG-картинки только из собственного буквального кода, добавляем колонку Картинка в данные формы и привязываем значок строки к этой колонке.
Где и как запускать
Полный модуль собственной управляемой формы учебной внешней обработки; настольный клиент.
Подготовка
В учебной базе: Файл → Новый → Внешняя обработка. Создайте управляемую форму и назначьте её основной. Дайте обработке имя УчебнаяТаблица.
Не добавляйте вручную реквизит Товары и одноимённые элементы: код создаст их при открытии. Модуль формы для этой задачи должен быть пустым.
В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Сохраните отдельную учебную EPF и откройте через Файл → Открыть.
Данные Книга/Ручка создаются в памяти формы. Справочники, документы и регистры вашей конфигурации не читаются и не записываются.
Используйте отдельную собственную конфигурацию с именем УчебнаяКонфигурацияСинтаксиса. Это не рабочая таблица и не динамический список каталога: только две собственные строки в форме.
Если код содержит ПриОткрытии, дополнительно свяжите событие формы ПриОткрытии с этой процедурой в свойствах формы.
Мобильные уроки запускать именно в мобильном клиенте своей учебной конфигурации. Для мобильного приложения можно перенести полный модуль в отдельную общую управляемую форму и открыть её собственной командой: произвольная EPF там не предполагается.
Флаги адаптации карточек, текущей строки и действий строки не являются правами на данные. Мобильный вид не подтверждается запуском только в настольном клиенте.
&НаСервере
Функция СоздатьСвойЗначок(ЦветФигуры)
SVG = "<svg xmlns=""http://www.w3.org/2000/svg"" width=""16"" height=""16"" viewBox=""0 0 16 16""><circle cx=""8"" cy=""8"" r=""6"" fill=""" + ЦветФигуры + """/></svg>";
ДанныеКартинки = ПолучитьДвоичныеДанныеИзСтроки(SVG, КодировкаТекста.UTF8, Ложь);
Возврат Новый Картинка(ДанныеКартинки);
КонецФункции
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
НовыеРеквизиты = Новый Массив;
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Товары", Новый ОписаниеТипов("ТаблицаЗначений")));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Код", Новый ОписаниеТипов("Строка"), "Товары", "Код"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Наименование", Новый ОписаниеТипов("Строка"), "Товары", "Название"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)), "Товары", "Количество"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Значок", Новый ОписаниеТипов("Картинка"), "Товары", "Значок"));
ЭтаФорма.ИзменитьРеквизиты(НовыеРеквизиты);
Данные = Новый ТаблицаЗначений;
Данные.Колонки.Добавить("Код", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Наименование", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)));
Данные.Колонки.Добавить("Значок", Новый ОписаниеТипов("Картинка"));
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "A-01";
СтрокаТовара.Наименование = "Книга";
СтрокаТовара.Количество = 3;
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "B-02";
СтрокаТовара.Наименование = "Ручка";
СтрокаТовара.Количество = 1;
Данные[0].Значок = СоздатьСвойЗначок("#149650");
Данные[1].Значок = СоздатьСвойЗначок("#2864dc");
ЭтаФорма.ЗначениеВРеквизитФормы(Данные, "Товары");
Таблица = ЭтаФорма.Элементы.Добавить("ТаблицаТоваров", Тип("ТаблицаФормы"));
Таблица.ПутьКДанным = "Товары";
Таблица.Заголовок = "Учебные товары";
Таблица.Шапка = Истина;
Таблица.АвтоВводНезаполненного = Ложь;
Таблица.АвтоВводНовойСтроки = Ложь;
Для Каждого ИмяКолонки Из СтрРазделить("Код,Наименование,Количество", ",") Цикл
Колонка = Элементы.Добавить("Товары" + ИмяКолонки, Тип("ПолеФормы"), Таблица);
Колонка.Вид = ВидПоляФормы.ПолеВвода;
Колонка.ПутьКДанным = "Товары." + ИмяКолонки;
Колонка.Заголовок = ИмяКолонки;
КонецЦикла;
Таблица.КартинкаСтрок = СоздатьСвойЗначок("#d02020");
Таблица.ПутьКДаннымКартинкиСтроки = "Товары.Значок";
Сообщить(ТипЗнч(Таблица.КартинкаСтрок) = Тип("Картинка"));
Сообщить(Таблица.ПутьКДаннымКартинкиСтроки = "Товары.Значок");
Сообщить(ТипЗнч(Данные[0].Значок) = Тип("Картинка"));
Сообщить(ТипЗнч(Данные[1].Значок) = Тип("Картинка"));
КонецПроцедурыРазбор по шагам
Создать дополнительный реквизит и колонку Значок с типом Картинка до переноса таблицы в данные формы.
Создать зелёный и синий кружки как собственные SVG-байты, положить в две собственные строки. В SVG нет ссылок на внешние файлы или запросов.
Назначить также общую красную КартинкаСтрок и указать путь Товары.Значок. При колонке типа Картинка общая картинка по контракту игнорируется.
Открыть свою форму и проверить строковые значки. Колонка Значок хранится в данных, отдельного видимого поля этой колонки код не создаёт.
Как проверить результат
Четыре проверки дают Истина: картинки имеют правильный тип, путь совпадает с собственным реквизитом.
В интерфейсе у книги зелёный круг, у ручки синий, а не один общий красный. Фактическую поддержку SVG и вид значка проверьте в целевом клиенте.
Ожидаемый результат
Настоящий пример данных и интерфейсной привязки картинок строки без файлов на диске и неизвестного исходного объекта.
На что обратить внимание
Колонка Картинка делает КартинкаСтрок неиспользуемой для выбора картинки этой строки: красный кружок добавлен, чтобы показать приоритет источника.
Для числовой или булевой колонки правила другие: нужен индекс набора картинок. Этот урок не выдаёт одиночную картинку за набор из двух кадров.
Абсолютные картинки строки не рекомендуются для больших таблиц. Здесь их две и они маленькие; для рабочего списка нужен отдельный выбор общего набора/ссылок и оценка нагрузки.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.