Тип: Строка. Содержит формат компонента процентов в подписях.
Полное описание, параметры и ограничения
Диаграмма.ФорматПроцентовВПодписях (Chart.PercentLabelFormat)
Диаграмма (Chart)
ФорматПроцентовВПодписях (PercentLabelFormat)
Не рекомендуется использовать, начиная с версии 8.3.16.
Рекомендуется использовать:
ФорматПроцентовВПодписях
Доступен, начиная с версии 8.0.
Использование:
Чтение и запись.
Описание:
Тип: Строка.
Содержит формат компонента процентов в подписях.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.0.
Не рекомендуется использовать, начиная с версии 8.3.16.
Описание изменено в версии 8.3.16.
Методическая информация
Практические примеры
Показать доли каналов продаж за один месяц кольцевой диаграммой
Три серии 60/30/10 в одной активной точке образуют 100 штук: проценты совпадают с числами только потому, что общий итог равен 100.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
В учебной базе создайте новую внешнюю обработку УчебнаяДиаграмма с пустой управляемой формой; назначьте форму основной.
Не создавайте реквизит График и поле ДиаграммаТоваров вручную: код создаёт их в ПриСозданииНаСервере.
В свойствах формы → События назначьте ПриСозданииНаСервере одноимённой процедуре. Сохраните EPF и откройте её в учебном тонком клиенте Windows.
Каждый урок использует отдельный модуль/копию формы. Данные вымышлены: план и факт в штуках за три месяца, не данные учёта.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
НовыеРеквизиты = Новый Массив;
НовыеРеквизиты.Добавить(Новый РеквизитФормы("График", Новый ОписаниеТипов("Диаграмма")));
ЭтаФорма.ИзменитьРеквизиты(НовыеРеквизиты);
Диаграмма = Новый Диаграмма;
Диаграмма.ТипДиаграммы = ТипДиаграммы.Кольцевая;
Диаграмма.АвтоТранспонирование = Ложь;
Месяц = Диаграмма.УстановитьТочку("2026-09");
Месяц.Текст = "Сентябрь";
Магазин = Диаграмма.УстановитьСерию("store");
Магазин.Текст = "Магазин";
Сайт = Диаграмма.УстановитьСерию("site");
Сайт.Текст = "Сайт";
Маркетплейс = Диаграмма.УстановитьСерию("market");
Маркетплейс.Текст = "Маркетплейс";
Диаграмма.УстановитьЗначение(Месяц, Магазин, 60);
Диаграмма.УстановитьЗначение(Месяц, Сайт, 30);
Диаграмма.УстановитьЗначение(Месяц, Маркетплейс, 10);
Диаграмма.АктивнаяТочка = Месяц;
Диаграмма.ВнутреннийРадиусКольцевойДиаграммы = 55;
Диаграмма.АвтоРаздвижениеСерий = АвтоРаздвижениеСерий.Нет;
Магазин.Раздвигать = Ложь;
Сайт.Раздвигать = Истина;
Маркетплейс.Раздвигать = Ложь;
Диаграмма.ВидПодписей = ВидПодписейКДиаграмме.СерияПроцент;
Диаграмма.РазделительПодписей = ": ";
Диаграмма.ФорматПроцентовВПодписях = "ЧДЦ=0;ЧН=0";
Диаграмма.Градиент = Ложь;
Диаграмма.Окантовка = Ложь;
Диаграмма.ОбластьЗаголовка.Текст = "Каналы продаж, сентябрь: всего 100 шт.";
Сообщить(Диаграмма.ПолучитьЗначение(Месяц, Магазин).Значение = 60);
Сообщить(Диаграмма.ПолучитьЗначение(Месяц, Сайт).Значение = 30);
Сообщить(Диаграмма.ПолучитьЗначение(Месяц, Маркетплейс).Значение = 10);
ЭтаФорма.График = Диаграмма;
Поле = Элементы.Добавить("ДиаграммаТоваров", Тип("ПолеФормы"));
Поле.Вид = ВидПоляФормы.ПолеДиаграммы;
Поле.ПутьКДанным = "График";
Поле.РастягиватьПоГоризонтали = Истина;
Поле.РастягиватьПоВертикали = Истина;
КонецПроцедуры
Разбор по шагам
Для одного месяца создаём одну точку и три серии-канала. АктивнаяТочка выбирает, для какого месяца строить круговое представление.
Радиус 55 означает 55% внешнего радиуса. Это размер отверстия, не доля продаж сайта.
Отключаем автоматическое раздвижение всех секторов и явно выдвигаем только собственную серию Сайт.
СерияПроцент формирует подписи канала и его доли. Общий итог 100 штук даёт доли 60%,30%,10%.
Плоское оформление без градиента и окантовки помогает сравнивать доли; исходные значения проверены отдельно.
Как проверить результат
Три сообщения Истина. На форме одна кольцевая диаграмма с тремя каналами и выдвинутым сектором сайта.
Проверьте подписи 60%,30%,10%; отверстие 55% не должно восприниматься как четвёртый сектор.
Ожидаемый результат
Активная точка, процентный формат и геометрия кольца разобраны на понятной структуре данных.
На что обратить внимание
Проценты совпадают с количеством только при общем итоге 100. При изменении исходных чисел доли пересчитаются.
Круговая диаграмма не подходит для сравнения большого числа близких долей или временных рядов.
Для отрицательных значений выберите другой тип анализа: доли каналов в этой задаче положительные.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Сделать подписи чисел читаемыми и запретить редактирование учебных показателей мышью
Настраиваем подписи, рамку, контраст и формат нуля. Эти изменения оформления не пересчитывают данные план/факт.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
В учебной базе создайте новую внешнюю обработку УчебнаяДиаграмма с пустой управляемой формой; назначьте форму основной.
Не создавайте реквизит График и поле ДиаграммаТоваров вручную: код создаёт их в ПриСозданииНаСервере.
В свойствах формы → События назначьте ПриСозданииНаСервере одноимённой процедуре. Сохраните EPF и откройте её в учебном тонком клиенте Windows.
Каждый урок использует отдельный модуль/копию формы. Данные вымышлены: план и факт в штуках за три месяца, не данные учёта.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
НовыеРеквизиты = Новый Массив;
НовыеРеквизиты.Добавить(Новый РеквизитФормы("График", Новый ОписаниеТипов("Диаграмма")));
ЭтаФорма.ИзменитьРеквизиты(НовыеРеквизиты);
Диаграмма = Новый Диаграмма;
Диаграмма.ТипДиаграммы = ТипДиаграммы.Гистограмма;
План = Диаграмма.УстановитьСерию("plan");
План.Текст = "План, шт.";
Факт = Диаграмма.УстановитьСерию("actual");
Факт.Текст = "Факт, шт.";
Месяцы = Новый Массив;
Месяцы.Добавить(Новый Структура("Ключ,Название,План,Факт", "2026-01", "Январь", 10, 8));
Месяцы.Добавить(Новый Структура("Ключ,Название,План,Факт", "2026-02", "Февраль", 12, 11));
Месяцы.Добавить(Новый Структура("Ключ,Название,План,Факт", "2026-03", "Март", 15, 16));
Для Каждого Месяц Из Месяцы Цикл
Точка = Диаграмма.УстановитьТочку(Месяц.Ключ);
Точка.Текст = Месяц.Название;
Диаграмма.УстановитьЗначение(Точка, План, Месяц.План);
Диаграмма.УстановитьЗначение(Точка, Факт, Месяц.Факт);
КонецЦикла;
Диаграмма.ВидПодписей = ВидПодписейКДиаграмме.Значение;
Диаграмма.ПоложениеПодписей = ПоложениеПодписейКДиаграмме.КрайАвто;
Диаграмма.РазделительПодписей = ": ";
Диаграмма.ФорматЗначенийВПодписях = "ЧДЦ=0;ЧН=0";
Диаграмма.ФорматПроцентовВПодписях = "ЧДЦ=1;ЧН=0";
Диаграмма.ШрифтПодписей = Новый Шрифт("Arial", 10);
Диаграмма.ЦветТекстаПодписей = Новый Цвет(25, 40, 60);
Диаграмма.ПрозрачныйФонПодписей = Ложь;
Диаграмма.ЦветФонаПодписей = Новый Цвет(255, 255, 255);
Диаграмма.РамкаПодписей = Новый Рамка(ТипРамкиЭлементаУправления.Одинарная);
Диаграмма.ЦветРамкиПодписей = Новый Цвет(190, 195, 205);
Диаграмма.ПрозрачныйФон = Ложь;
Диаграмма.ЦветФона = Новый Цвет(250, 251, 253);
Диаграмма.Рамка = Новый Рамка(ТипРамкиЭлементаУправления.БезРамки);
Диаграмма.ЦветРамки = Новый Цвет(190, 195, 205);
Диаграмма.Анимация = АнимацияДиаграммы.НеИспользовать;
Диаграмма.РежимВыделения = РежимВыделенияДиаграммы.ВыделениеЗначений;
Диаграмма.РежимРедактированияЗначений = РежимРедактированияЗначенийДиаграммы.НеИспользовать;
План.РежимРедактированияЗначений = РежимРедактированияЗначенийДиаграммы.НеИспользовать;
Факт.РежимРедактированияЗначений = РежимРедактированияЗначенийДиаграммы.НеИспользовать;
План.ФорматВТаблицеДанных = "ЧДЦ=0;ЧН=0";
Факт.ФорматЗначенийВПодписях = "ЧДЦ=0;ЧН=0";
Факт.ФорматПроцентовВПодписях = "ЧДЦ=1;ЧН=0";
Сообщить(Диаграмма.ПолучитьЗначение(Диаграмма.Точки.Получить(2), Факт).Значение = 16);
Сообщить(Диаграмма.РежимРедактированияЗначений = РежимРедактированияЗначенийДиаграммы.НеИспользовать);
ЭтаФорма.График = Диаграмма;
Поле = Элементы.Добавить("ДиаграммаТоваров", Тип("ПолеФормы"));
Поле.Вид = ВидПоляФормы.ПолеДиаграммы;
Поле.ПутьКДанным = "График";
Поле.РастягиватьПоГоризонтали = Истина;
Поле.РастягиватьПоВертикали = Истина;
КонецПроцедуры
Разбор по шагам
ВидПодписей=Значение показывает число без лишнего повторения серии и месяца. Разделитель нужен лишь для составных видов подписей.
Формат ЧДЦ=0;ЧН=0 показывает целые штуки и явный ноль. Формат процентов подготовлен отдельно, но текущий вид процентов не выводит.
Светлый непрозрачный фон и тёмный текст сохраняют контраст над столбцами. У подписей рамка видна, у всей диаграммы БезРамки — не видна.
Отключаем анимацию для спокойного учебного сравнения и редактирование значений мышью для всей диаграммы и обеих серий.
Выделение значения остаётся включённым. Числовой контроль мартовского факта подтверждает, что оформление не изменило 16.
Как проверить результат
Два сравнения Истина. На форме читаются целые числовые подписи поверх светлых плашек.
Попытка перетянуть показатель не должна редактировать значение; выделение отдельного значения допустимо.
Для проверки нуля замените мартовский факт в собственной матрице на 0 и повторите урок.
Ожидаемый результат
Диаграмма стала читаемой без изменения числовой модели; редактирование явно отделено от выделения.
На что обратить внимание
НеИспользовать ограничивает интерактивное редактирование, но не программный УстановитьЗначение и не права учётной базы.
ЦветРамки при типе БезРамки не виден; это не поломка настройки.
Форматирование округляет представление, а не исходное значение. Для дробных показателей выберите другие ЧДЦ.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.