Получает картинку сводной диаграммы.
Синтаксис
ПолучитьКартинку(<Ширина>, <Высота>, <ФорматКартинки>)Полное описание, параметры и ограничения
СводнаяДиаграмма.ПолучитьКартинку (PivotChart.GetPicture)
СводнаяДиаграмма (PivotChart)
ПолучитьКартинку (GetPicture)
Доступен, начиная с версии 8.1.
Синтаксис:
ПолучитьКартинку(<Ширина>, <Высота>, <ФорматКартинки>)
Параметры:
<Ширина> (необязательный)
Тип: Число.
Ширина картинки в пикселях. Если <Ширина> или <Высота> = 0, используются текущие размеры сводной диаграммы. Если они равны 0, используются размеры по умолчанию.
Значение по умолчанию: 0.
<Высота> (необязательный)
Тип: Число.
Высота картинки в пикселях. Если <Высота> или <Ширина> = 0, используются текущие размеры сводной диаграммы. Если они равны 0, используются размеры по умолчанию.
Значение по умолчанию: 0.
<ФорматКартинки> (необязательный)
Тип: ФорматКартинки.
Определяет формат картинки.
Допустимые значения для растровых картинок: BMP, PNG и исходный тип. Для векторных картинок допускается указывать только исходный тип.
Значение по умолчанию: BMP.
Возвращаемое значение:
Тип: Картинка.
Описание:
Получает картинку сводной диаграммы.
Доступность:
Толстый клиент.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Оформить фон и области полей без изменения данных
У всей диаграммы и областей полей разные настройки прозрачности. Цвета не являются статусом товара или его остатка.
Где и как запускать
Полный модуль управляемой формы собственной учебной внешней обработки. Построение выполняется на сервере без контекста; показ — на клиенте. Вставляйте на уровне модуля.
Подготовка
Создайте новую внешнюю обработку с управляемой основной формой в учебной базе. Каждый урок — отдельная копия модуля.
На форме создайте команду УчебныйПример и перетащите её на форму как кнопку. В действии команды выберите процедуру УчебныйПример(Команда).
Вставьте весь модуль из примера: УчебныйПример, ПостроитьУчебныйДокумент и УчебнаяТаблица. Серверный вызов возвращает собственный табличный документ клиенту; директивы не удаляйте.
Никакие макеты, документы и справочники конфигурации не нужны. Всё построение — в памяти, без печати, записи файлов и отправки в сервисы.
Показ и ручную проверку выполняйте в тонком клиенте Windows 8.5.1.1343. Каждый урок — отдельная копия формы с пустым модулем до вставки.
&НаКлиенте
Процедура УчебныйПример(Команда)
ТабДок = ПостроитьУчебныйДокумент();
ТабДок.Показать("Учебный документ — без печати и сохранения");
КонецПроцедуры
&НаСервереБезКонтекста
Функция ПостроитьУчебныйДокумент()
ТабДок = Новый ТабличныйДокумент;
Источник = Новый ТаблицаЗначений;
Источник.Колонки.Добавить("Товар", Новый ОписаниеТипов("Строка"));
Источник.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число"));
Источник.Колонки.Добавить("Сумма", Новый ОписаниеТипов("Число"));
СтрокаТовара = Источник.Добавить();
СтрокаТовара.Товар = "Книга";
СтрокаТовара.Количество = 3;
СтрокаТовара.Сумма = 750;
СтрокаТовара = Источник.Добавить();
СтрокаТовара.Товар = "Ручка";
СтрокаТовара.Количество = 1;
СтрокаТовара.Сумма = 50;
Менеджер = Новый МенеджерВременныхТаблиц;
Запрос = Новый Запрос;
Запрос.МенеджерВременныхТаблиц = Менеджер;
Запрос.УстановитьПараметр("Источник", Источник);
Запрос.Текст = "ВЫБРАТЬ Д.Товар, Д.Количество, Д.Сумма
|ПОМЕСТИТЬ ВТУчебныеТовары ИЗ &Источник КАК Д;
|ВЫБРАТЬ Д.Товар, Д.Количество, Д.Сумма
|ИЗ ВТУчебныеТовары КАК Д
|ИТОГИ СУММА(Количество), СУММА(Сумма) ПО Товар";
Попытка
Пакет = Запрос.ВыполнитьПакет();
Результат = Пакет.Получить(1);
Исключение
Менеджер.Закрыть();
ВызватьИсключение;
КонецПопытки;
Менеджер.Закрыть();
Диаграмма = Новый СводнаяДиаграмма;
Диаграмма.ТипСводнойДиаграммы = ТипСводнойДиаграммы.Гистограмма;
Диаграмма.ИсточникДанных = Результат;
Диаграмма.Точки.Добавить("Товар");
Диаграмма.Ресурсы.Добавить("Количество");
Диаграмма.Ресурсы.Добавить("Сумма");
Диаграмма.ОбластьЗаголовка.Текст = "Учебные товары: количество и сумма — разные единицы";
Диаграмма.Обновить();
Диаграмма.ПрозрачныйФон = Ложь;
Диаграмма.ЦветФона = Новый Цвет(250, 252, 255);
Диаграмма.ПрозрачныйФонОбластейПолей = Ложь;
Диаграмма.ЦветФонаОбластейПолей = Новый Цвет(235, 242, 250);
Диаграмма.ЦветТекстаОбластейПолей = Новый Цвет(25, 45, 65);
Диаграмма.Рамка = Новый Рамка(ТипРамкиЭлементаУправления.Одинарная);
Диаграмма.ЦветРамки = Новый Цвет(110, 130, 150);
Сообщить(Не Диаграмма.ПрозрачныйФон);
Сообщить(Не Диаграмма.ПрозрачныйФонОбластейПолей);
Сообщить(ТипЗнч(Диаграмма.Рамка) = Тип("Рамка"));
Изображение = Диаграмма.ПолучитьКартинку(900, 500, ФорматКартинки.PNG);
Сообщить(ТипЗнч(Изображение) = Тип("Картинка"));
Рисунок = ТабДок.Рисунки.Добавить(ТипРисункаТабличногоДокумента.Картинка);
Рисунок.Картинка = Изображение;
Рисунок.АвтоРазмер = Ложь;
Рисунок.Лево = 5;
Рисунок.Верх = 12;
Рисунок.Ширина = 180;
Рисунок.Высота = 100;
ТабДок.Область(1, 1).Текст = "Только учебные данные: книга 3/750, ручка 1/50; количество 4, сумма 800";
ТабДок.ТолькоПросмотр = Истина;
Возврат ТабДок;
КонецФункции
Разбор по шагам
Разделяем фон всего изображения и фон областей выбранных полей.
Текст областей полей оформляем контрастным цветом, не создаём дополнительный ресурс источника.
Тип рамки задаётся Рамка, цвет рамки — отдельным Цвет.
В пиксельном снимке фон дополнительно зависит от настроек областей; прозрачность рисунка документа не подменяет значения источника.
Как проверить результат
Три проверки настроек Истина; дополнительная проверка полученной картинки Истина.
Проверьте контраст изображения на форме вручную, сумма источника остаётся 800.
Ожидаемый результат
Согласовано оформление фона и рамки самостоятельного изображения.
На что обратить внимание
Прозрачный фон не скрывает значения ресурса и не защищает их.
Один цвет не следует одновременно использовать как легенду двух разных единиц измерения.
СводнаяДиаграмма доступна на сервере/в толстом клиенте. Здесь тонкому клиенту возвращается обычный табличный документ с картинкой, не интерактивная сводная диаграмма.
Количество и сумма имеют разные единицы: совместная учебная шкала не подходит для достоверного бизнес-сравнения величин.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Разделить оформление плоской и объёмной сводной диаграммы
Тип, градиент, окантовка и свет относятся к изображению. Они не корректируют исходные значения товара.
Где и как запускать
Полный модуль управляемой формы собственной учебной внешней обработки. Построение выполняется на сервере без контекста; показ — на клиенте. Вставляйте на уровне модуля.
Подготовка
Создайте новую внешнюю обработку с управляемой основной формой в учебной базе. Каждый урок — отдельная копия модуля.
На форме создайте команду УчебныйПример и перетащите её на форму как кнопку. В действии команды выберите процедуру УчебныйПример(Команда).
Вставьте весь модуль из примера: УчебныйПример, ПостроитьУчебныйДокумент и УчебнаяТаблица. Серверный вызов возвращает собственный табличный документ клиенту; директивы не удаляйте.
Никакие макеты, документы и справочники конфигурации не нужны. Всё построение — в памяти, без печати, записи файлов и отправки в сервисы.
Показ и ручную проверку выполняйте в тонком клиенте Windows 8.5.1.1343. Каждый урок — отдельная копия формы с пустым модулем до вставки.
&НаКлиенте
Процедура УчебныйПример(Команда)
ТабДок = ПостроитьУчебныйДокумент();
ТабДок.Показать("Учебный документ — без печати и сохранения");
КонецПроцедуры
&НаСервереБезКонтекста
Функция ПостроитьУчебныйДокумент()
ТабДок = Новый ТабличныйДокумент;
Источник = Новый ТаблицаЗначений;
Источник.Колонки.Добавить("Товар", Новый ОписаниеТипов("Строка"));
Источник.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число"));
Источник.Колонки.Добавить("Сумма", Новый ОписаниеТипов("Число"));
СтрокаТовара = Источник.Добавить();
СтрокаТовара.Товар = "Книга";
СтрокаТовара.Количество = 3;
СтрокаТовара.Сумма = 750;
СтрокаТовара = Источник.Добавить();
СтрокаТовара.Товар = "Ручка";
СтрокаТовара.Количество = 1;
СтрокаТовара.Сумма = 50;
Менеджер = Новый МенеджерВременныхТаблиц;
Запрос = Новый Запрос;
Запрос.МенеджерВременныхТаблиц = Менеджер;
Запрос.УстановитьПараметр("Источник", Источник);
Запрос.Текст = "ВЫБРАТЬ Д.Товар, Д.Количество, Д.Сумма
|ПОМЕСТИТЬ ВТУчебныеТовары ИЗ &Источник КАК Д;
|ВЫБРАТЬ Д.Товар, Д.Количество, Д.Сумма
|ИЗ ВТУчебныеТовары КАК Д
|ИТОГИ СУММА(Количество), СУММА(Сумма) ПО Товар";
Попытка
Пакет = Запрос.ВыполнитьПакет();
Результат = Пакет.Получить(1);
Исключение
Менеджер.Закрыть();
ВызватьИсключение;
КонецПопытки;
Менеджер.Закрыть();
Диаграмма = Новый СводнаяДиаграмма;
Диаграмма.ТипСводнойДиаграммы = ТипСводнойДиаграммы.Гистограмма;
Диаграмма.ИсточникДанных = Результат;
Диаграмма.Точки.Добавить("Товар");
Диаграмма.Ресурсы.Добавить("Количество");
Диаграмма.Ресурсы.Добавить("Сумма");
Диаграмма.ОбластьЗаголовка.Текст = "Учебные товары: количество и сумма — разные единицы";
Диаграмма.Обновить();
Диаграмма.ТипСводнойДиаграммы = ТипСводнойДиаграммы.Гистограмма;
Диаграмма.Градиент = Ложь;
Диаграмма.Окантовка = Истина;
Диаграмма.Свет = Ложь;
Диаграмма.РежимПробелов = РежимПробеловДиаграммы.ПоловинаШирины;
Сообщить(Диаграмма.ТипСводнойДиаграммы = ТипСводнойДиаграммы.Гистограмма);
Сообщить(Не Диаграмма.Градиент);
Сообщить(Диаграмма.Окантовка);
Сообщить(Диаграмма.РежимПробелов = РежимПробеловДиаграммы.ПоловинаШирины);
Изображение = Диаграмма.ПолучитьКартинку(900, 500, ФорматКартинки.PNG);
Сообщить(ТипЗнч(Изображение) = Тип("Картинка"));
Рисунок = ТабДок.Рисунки.Добавить(ТипРисункаТабличногоДокумента.Картинка);
Рисунок.Картинка = Изображение;
Рисунок.АвтоРазмер = Ложь;
Рисунок.Лево = 5;
Рисунок.Верх = 12;
Рисунок.Ширина = 180;
Рисунок.Высота = 100;
ТабДок.Область(1, 1).Текст = "Только учебные данные: книга 3/750, ручка 1/50; количество 4, сумма 800";
ТабДок.ТолькоПросмотр = Истина;
Возврат ТабДок;
КонецФункции
Разбор по шагам
Для плоской гистограммы выключаем градиент и задаём окантовку закрашиваемых областей.
Свет имеет смысл для объёмной диаграммы: отключённый флаг не меняет арифметику.
ПоловинаШирины регулирует визуальные пробелы, не удаляет половину точек.
Изменение типа на ГистограммаОбъемная проверяйте отдельно визуально в копии урока.
Как проверить результат
Четыре проверки настроек Истина, затем проверка типа картинки Истина.
Сумма исходных данных остаётся 800; фактический вид столбцов проверяйте в показанном документе.
Ожидаемый результат
Оформление диаграммы отделено от данных и точности сравнения.
На что обратить внимание
Объёмный эффект может затруднять визуальное сравнение величин.
Окантовка и Свет не являются дополнительными рядами данных.
СводнаяДиаграмма доступна на сервере/в толстом клиенте. Здесь тонкому клиенту возвращается обычный табличный документ с картинкой, не интерактивная сводная диаграмма.
Количество и сумма имеют разные единицы: совместная учебная шкала не подходит для достоверного бизнес-сравнения величин.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.