Тип: Цвет. Содержит цвет текста подписи
Полное описание, параметры и ограничения
ОбластьПодписиДиаграммы.ЦветТекста (ChartLabelArea.TextColor)
ОбластьПодписиДиаграммы (ChartLabelArea)
ЦветТекста (TextColor)
Доступен, начиная с версии 8.3.10.
Использование:
Чтение и запись.
Описание:
Тип: Цвет.
Содержит цвет текста подписи
Доступность:
Тонкий клиент, веб-клиент, сервер, толстый клиент, внешнее соединение.
Использование в версии:
Доступен, начиная с версии 8.3.10.
Методическая информация
Практические примеры
Разместить область построения и подписать шкалу целых штук
Относительные координаты области 0–1 не являются количеством товара. Задаём честную числовую ось 0–20 и шаг шкалы 5.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
В учебной базе создайте новую внешнюю обработку УчебнаяДиаграмма с пустой управляемой формой; назначьте форму основной.
Не создавайте реквизит График и поле ДиаграммаТоваров вручную: код создаёт их в ПриСозданииНаСервере.
В свойствах формы → События назначьте ПриСозданииНаСервере одноимённой процедуре. Сохраните EPF и откройте её в учебном тонком клиенте Windows.
Каждый урок использует отдельный модуль/копию формы. Данные вымышлены: план и факт в штуках за три месяца, не данные учёта.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
НовыеРеквизиты = Новый Массив;
НовыеРеквизиты.Добавить(Новый РеквизитФормы("График", Новый ОписаниеТипов("Диаграмма")));
ЭтаФорма.ИзменитьРеквизиты(НовыеРеквизиты);
Диаграмма = Новый Диаграмма;
Диаграмма.ТипДиаграммы = ТипДиаграммы.Гистограмма;
План = Диаграмма.УстановитьСерию("plan");
План.Текст = "План, шт.";
Факт = Диаграмма.УстановитьСерию("actual");
Факт.Текст = "Факт, шт.";
Месяцы = Новый Массив;
Месяцы.Добавить(Новый Структура("Ключ,Название,План,Факт", "2026-01", "Январь", 10, 8));
Месяцы.Добавить(Новый Структура("Ключ,Название,План,Факт", "2026-02", "Февраль", 12, 11));
Месяцы.Добавить(Новый Структура("Ключ,Название,План,Факт", "2026-03", "Март", 15, 16));
Для Каждого Месяц Из Месяцы Цикл
Точка = Диаграмма.УстановитьТочку(Месяц.Ключ);
Точка.Текст = Месяц.Название;
Диаграмма.УстановитьЗначение(Точка, План, Месяц.План);
Диаграмма.УстановитьЗначение(Точка, Факт, Месяц.Факт);
КонецЦикла;
Ось = Диаграмма.ОсьЗначений;
Ось.СпособОпределенияМинимальногоЗначения = СпособОпределенияОграничивающегоЗначенияДиаграммы.ИспользоватьЗначение;
Ось.СпособОпределенияМаксимальногоЗначения = СпособОпределенияОграничивающегоЗначенияДиаграммы.ИспользоватьЗначение;
Ось.МинимальноеЗначение = 0;
Ось.МаксимальноеЗначение = 20;
Ось.БазовоеЗначение = 0;
Область = Диаграмма.ОбластьПостроения;
Область.Расположение = РасположениеОбластиПостроенияДиаграммы.УказываетсяРасположение;
Область.Лево = 0.15;
Область.Верх = 0.12;
Область.Право = 0.92;
Область.Низ = 0.82;
Область.Рамка = Новый Рамка(ТипРамкиЭлементаУправления.Одинарная);
Область.ЦветРамки = Новый Цвет(210, 215, 225);
Область.ЦветПоверхности = Новый Цвет(245, 247, 250);
Область.ЛинииШкал = Новый Линия(ТипЛинииДиаграммы.Сплошная, 1);
Шкала = Область.ШкалаЗначений;
Шкала.Отображение = ОтображениеВДиаграмме.Отображать;
Шкала.ОтображениеЗаголовка = ОтображениеЗаголовкаШкалыДиаграммы.Отображать;
Шкала.СпособЗаполненияТекстаЗаголовка = СпособЗаполненияТекстаЗаголовкаШкалыДиаграммы.ИспользоватьТекст;
Шкала.ТекстЗаголовка = "Количество, шт.";
Шкала.ШагШкалы = 5;
Шкала.ФорматПодписей = "ЧДЦ=0;ЧН=0";
Шкала.ОтображениеЛинийСетки = ОтображениеЛинийСеткиДиаграммы.Отображать;
Шкала.ЛинияСетки = Новый Линия(ТипЛинииДиаграммы.Точечная, 1);
Шкала.ЛинияШкалы = Новый Линия(ТипЛинииДиаграммы.Сплошная, 1);
Шкала.ЦветЛинииСетки = Новый Цвет(225, 230, 238);
Шкала.ЦветЛинииШкалы = Новый Цвет(80, 90, 110);
Шкала.ЦветПодписей = Новый Цвет(25, 40, 60);
Шкала.ШрифтПодписей = Новый Шрифт("Arial", 10);
Шкала.ОбластьЗаголовка.ЦветТекста = Новый Цвет(25, 40, 60);
Шкала.ОбластьЗаголовка.Шрифт = Новый Шрифт("Arial", 10, Истина);
ШкалаТочек = Область.ШкалаТочек;
ШкалаТочек.ОриентацияПодписей = ОриентацияПодписейДиаграммы.ПроизвольныйУголНаклона;
ШкалаТочек.УголНаклонаПодписей = -25;
ШкалаТочек.МаксимальноеКоличестовРядовПодписей = 1;
Сообщить(Ось.МинимальноеЗначение = 0 И Ось.МаксимальноеЗначение = 20);
Сообщить(Шкала.ШагШкалы = 5);
Сообщить(Область.Лево < Область.Право И Область.Верх < Область.Низ);
ЭтаФорма.График = Диаграмма;
Поле = Элементы.Добавить("ДиаграммаТоваров", Тип("ПолеФормы"));
Поле.Вид = ВидПоляФормы.ПолеДиаграммы;
Поле.ПутьКДанным = "График";
Поле.РастягиватьПоГоризонтали = Истина;
Поле.РастягиватьПоВертикали = Истина;
КонецПроцедуры
Разбор по шагам
ОсьЗначений отвечает за диапазон чисел, ШкалаЗначений — за визуальные подписи и линии. Это два связанных, но разных объекта.
Задаём диапазон 0–20 с нулевой базой: максимум данных 16 помещается без обрезки. Способы определения границ явно используют значения.
УказываетсяРасположение включает координаты области. Лево/Право и Верх/Низ заданы в долях от 0 до 1, не в пикселях.
Шаг 5 даёт отметки 0,5,10,15,20. Точечная бледная сетка помогает считыванию и не конкурирует со столбцами.
Текст заголовка Количество, шт. выбран явно. Месяцы на шкале точек наклонены на −25° и ограничены одним рядом подписей.
Как проверить результат
Три сообщения Истина. На форме различимы шкала количества и подписи месяцев.
Диапазон заканчивается 20, столбец факта 16 не обрезан; рамка области не накладывается на числа.
Уменьшите окно для проверки подписей; при нехватке места пересмотрите координаты или используйте автоматическое расположение.
Ожидаемый результат
Настройка оси, шкалы и области построения объяснена с разными единицами измерения.
На что обратить внимание
Фиксированные относительные координаты требуют визуальной проверки на нужном размере окна и масштабе интерфейса.
ЦветПоверхности влияет на поверхность объёмных представлений, а не заменяет ЦветФона плоской диаграммы.
УголНаклонаПодписей используется при ПроизвольныйУголНаклона; без этого режима присваивание угла не решает читаемость.
Название МаксимальноеКоличестовРядовПодписей содержит необычное написание именно в API платформы: не исправляйте его в коде.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Подсветить диапазон 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 здесь заведомо правильная.
Подсветка зоны не является проверкой бизнес-правила при записи документа: эта задача только визуализирует собственные числа.
Название ПроцентПолупрозрачностиГраницы в экспорте имеет необычное описание типа; используем официально допустимое Неопределено, не выдумываем строковую настройку.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.