Возвращает ширину картинки (в пикселях).
Синтаксис
Ширина()Полное описание, параметры и ограничения
Картинка.Ширина (Picture.Width)
Картинка (Picture)
Ширина (Width)
Доступен, начиная с версии 8.3.14.
Синтаксис:
Ширина()
Возвращаемое значение:
Тип: Число, Неопределено.
Если картинка создана с вариантами, то возвращает информацию по текущему варианту.
Если картинка является частью коллекции картинок, возвращает Неопределено.
Описание:
Возвращает ширину картинки (в пикселях).
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.3.14.
Методическая информация
Практические примеры
Получить 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, если нужен предсказуемый размер внешнего изображения.
При реальной выгрузке файл, доставка и права доступа требуют отдельного явного решения; здесь их нет.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Проверить назначение общей картинки, не пытаться выгрузить байты через метаданные
На картинке Адрес изучаем настройки доступности для выбора и оформления. Свойство Картинка в этом API не возвращает содержимое ресурса.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Запускайте в учебной копии конфигурации. Примеры читают структуру метаданных, но не создают объекты, не записывают регистры и не проводят документы.
Сверяйте вывод с деревом конфигурации в Конфигураторе. Имена, длины и настройки в УНФ, КА2, БП, УТ 11 и УТ 10.3 могут различаться.
Имена объектов взяты из XML КА2 Progress: C:\claude\KA2\Progress\XML_CF_KA2_PROGRESS. Исходные XML не изменяйте. Выполняйте код только в своей учебной копии соответствующей конфигурации.
В другой конфигурации предварительно найдите аналогичный объект в Конфигураторе и замените только строку имени в поиске. Отсутствие имени обрабатывается до чтения свойств; оно не доказывает отсутствие аналогичной возможности.
Каждый урок запускайте отдельно. Код не вызывает бизнес-функции модулей и обработчики команд, не переключает привилегированный режим и не меняет параметры сеанса.
Описание = Метаданные.ОбщиеКартинки.Найти("Адрес");
Если Описание = Неопределено Тогда
ВызватьИсключение "В учебной конфигурации отсутствует ОбщиеКартинки.Адрес";
КонецЕсли;
Сообщить(СтрШаблон("%1 (%2): выбор %3; оформление %4",
Описание.Имя, Описание.Синоним, Описание.ДоступностьДляВыбора, Описание.ДоступностьДляОформления));
Сообщить("Описание: " + Описание.Комментарий);
Сообщить(Описание.Картинка = Неопределено);
Картинка = БиблиотекаКартинок.Адрес;
Сообщить(ТипЗнч(Картинка) = Тип("Картинка"));
Сообщить(СтрШаблон("Размер ресурса: %1 × %2", Картинка.Ширина(), Картинка.Высота()));Разбор по шагам
Ищем описание общей картинки по имени Адрес.
Две доступности относятся к назначению ресурса, не к правам на документы.
Проверяем контракт Картинка = Неопределено для описания метаданных.
Настоящую Картинку получаем через БиблиотекаКартинок.Адрес, как указано в установленной справке; это не свойство описания метаданных.
Ширина() и Высота() относятся к полученному ресурсу; файл изображения не записываем.
Как проверить результат
Сверьте оба флага в свойствах общей картинки в Конфигураторе.
Оба сравнения дают Истина: значение метаданных — Неопределено, значение библиотеки — Картинка. Размеры зависят от самого ресурса, не задавайте их по памяти.
Ожидаемый результат
Различены настройки общего ресурса и получение его содержимого.
На что обратить внимание
Не путайте Картинка у описания ОбщаяКартинка со свойством Картинка общей команды: контракты различаются.
Имя Адрес специфично для показанной выгрузки.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.