Тип: ИнформационныеИнтервалыДиаграммы. Коллекция информационных интервалов, границы которых соответствуют точкам.
Полное описание, параметры и ограничения
Диаграмма.ИнформационныеИнтервалыТочек (Chart.PointsReferenceBands)
Диаграмма (Chart)
ИнформационныеИнтервалыТочек (PointsReferenceBands)
Доступен, начиная с версии 8.3.12.
Использование:
Только чтение.
Описание:
Тип: ИнформационныеИнтервалыДиаграммы.
Коллекция информационных интервалов, границы которых соответствуют точкам.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Может использоваться в реквизитах управляемой формы.
Использование в версии:
Доступен, начиная с версии 8.3.12.
Методическая информация
Практические примеры
Подсветить диапазон 10–15 штук и собственное окно месяцев
Начало/Конец задают значения по оси, а НачалоОбластиОтображения/КонецОбластиОтображения — доли протяжённости по другой оси. Разбираем обе пары.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
В учебной базе создайте новую внешнюю обработку УчебнаяДиаграмма с пустой управляемой формой; назначьте форму основной.
Не создавайте реквизит График и поле ДиаграммаТоваров вручную: код создаёт их в ПриСозданииНаСервере.
В свойствах формы → События назначьте ПриСозданииНаСервере одноимённой процедуре. Сохраните EPF и откройте её в учебном тонком клиенте Windows.
Каждый урок использует отдельный модуль/копию формы. Данные вымышлены: план и факт в штуках за три месяца, не данные учёта.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
НовыеРеквизиты = Новый Массив;
НовыеРеквизиты.Добавить(Новый РеквизитФормы("График", Новый ОписаниеТипов("Диаграмма")));
ЭтаФорма.ИзменитьРеквизиты(НовыеРеквизиты);
Диаграмма = Новый Диаграмма;
Диаграмма.ТипДиаграммы = ТипДиаграммы.Гистограмма;
План = Диаграмма.УстановитьСерию("plan");
План.Текст = "План, шт.";
Факт = Диаграмма.УстановитьСерию("actual");
Факт.Текст = "Факт, шт.";
Месяцы = Новый Массив;
Месяцы.Добавить(Новый Структура("Ключ,Название,План,Факт", "2026-01", "Январь", 10, 8));
Месяцы.Добавить(Новый Структура("Ключ,Название,План,Факт", "2026-02", "Февраль", 12, 11));
Месяцы.Добавить(Новый Структура("Ключ,Название,План,Факт", "2026-03", "Март", 15, 16));
Для Каждого Месяц Из Месяцы Цикл
Точка = Диаграмма.УстановитьТочку(Месяц.Ключ);
Точка.Текст = Месяц.Название;
Диаграмма.УстановитьЗначение(Точка, План, Месяц.План);
Диаграмма.УстановитьЗначение(Точка, Факт, Месяц.Факт);
КонецЦикла;
Интервалы = Диаграмма.ИнформационныеИнтервалыЗначений;
Зона = Интервалы.Добавить();
Зона.Начало = 10;
Зона.Конец = 15;
Зона.НачалоОбластиОтображения = 0;
Зона.КонецОбластиОтображения = 1;
Зона.Цвет = Новый Цвет(225, 238, 225);
Зона.ПроцентПолупрозрачности = 65;
Зона.Граница = Новый Линия(ТипЛинииДиаграммы.Точечная, 1);
Зона.ЦветГраницы = Новый Цвет(90, 145, 90);
Зона.ПроцентПолупрозрачностиГраницы = Неопределено;
Зона.Положение = ПоложениеГраницыИнформационногоИнтервалаДиаграммы.ВЗначении;
Зона.ТекстПодписи = "Учебный диапазон: 10–15 шт.";
Зона.Подсказка = "Февральский факт 11 входит в диапазон; январь 8 и март 16 — вне";
Зона.Расшифровка = Новый Структура("Минимум,Максимум", 10, 15);
Зона.ОбластьПодписи.ЦветТекста = Новый Цвет(45, 90, 45);
Зона.ОбластьПодписи.Шрифт = Новый Шрифт("Arial", 10);
Черновая = Интервалы.Вставить(0);
Черновая.Начало = 1;
Черновая.Конец = 2;
Сообщить(Интервалы.Индекс(Зона) = 1);
Интервалы.Сдвинуть(Зона, -1);
Сообщить(Интервалы.Индекс(Зона) = 0);
Интервалы.Удалить(Черновая);
Сообщить(Интервалы.Количество() = 1);
Сообщить(Интервалы.Получить(0).Начало = 10 И Интервалы.Получить(0).Конец = 15);
ОкноМесяцев = Диаграмма.ИнформационныеИнтервалыТочек.Добавить();
ОкноМесяцев.Начало = Диаграмма.Точки.Получить(0);
ОкноМесяцев.Конец = Диаграмма.Точки.Получить(1);
ОкноМесяцев.Положение = ПоложениеГраницыИнформационногоИнтервалаДиаграммы.МеждуЗначениями;
ОкноМесяцев.НачалоОбластиОтображения = 0;
ОкноМесяцев.КонецОбластиОтображения = 0.25;
ОкноМесяцев.Цвет = Новый Цвет(225, 232, 245);
ОкноМесяцев.ПроцентПолупрозрачности = 70;
ОкноМесяцев.ТекстПодписи = "Контрольное окно январь–февраль";
Февраль = Диаграмма.ПолучитьЗначение(Диаграмма.Точки.Получить(1), Факт).Значение;
Сообщить(Февраль >= Зона.Начало И Февраль <= Зона.Конец);
ЭтаФорма.График = Диаграмма;
Поле = Элементы.Добавить("ДиаграммаТоваров", Тип("ПолеФормы"));
Поле.Вид = ВидПоляФормы.ПолеДиаграммы;
Поле.ПутьКДанным = "График";
Поле.РастягиватьПоГоризонтали = Истина;
Поле.РастягиватьПоВертикали = Истина;
КонецПроцедуры
Разбор по шагам
Зона значений от 10 до 15 штук протягивается по всей оси точек: относительные границы 0 и 1.
65% полупрозрачности относится к заливке. Границы заданы точечной линией, их прозрачность Неопределено оставляет автоматический расчёт.
Текст и подсказка объясняют границы. Факт февраля 11 проверяется числовым сравнением, а не только попаданием картинки в цветную область.
Коллекция получает собственную черновую зону, после сдвига она удаляется. Рабочая учебная зона остаётся 10–15.
Интервал точек использует январь и февраль, а относительная высота 0–0.25 ограничивает его область отображения по оси значений.
Положение МеждуЗначениями предназначено для границ между дискретными точками; точное визуальное размещение проверьте в своём клиенте.
Как проверить результат
Пять сравнений Истина; зона значений одна и февральский факт 11 входит в неё.
Визуально различимы количественная зона 10–15 и частично протянутый интервал месяцев; значения не изменены.
Ожидаемый результат
Числовой диапазон, окно категорий и относительная протяжённость имеют разный смысл и разные единицы.
На что обратить внимание
Если относительное начало больше или равно относительному концу, интервал не отображается. Пара 0–1 здесь заведомо правильная.
Подсветка зоны не является проверкой бизнес-правила при записи документа: эта задача только визуализирует собственные числа.
Название ПроцентПолупрозрачностиГраницы в экспорте имеет необычное описание типа; используем официально допустимое Неопределено, не выдумываем строковую настройку.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.