Секторная область построения

Данная область построения используется Круговым и Кольцевым графиками.

Общие свойства

Начальный угол

Угол (в градусах), с которого начинается первый сектор. Ноль расположен в позиции 3 часов, и по мере увеличения угла, сектор растягивается против часовой стрелки по окружности графика (так, что 90 градусов приходится на позицию 12 часов).

Имя свойства: startAngle

Тип свойства: Float

Направление

Направление секторов графика: По часовой стрелке (по умолчанию) или Против часовой стрелки.

Имя свойства: direction

Тип свойства: String

Внутренний промежуток

Интервал во внутренней части секторного графика (область, где отображаются метки) в процентах от ширины и высоты области построения. Значением по умолчанию является 0.08 (8%).

Имя свойства: interiorGap

Тип свойства: Float

Круг

Флажок, контролирующий, будет график круглой или эллиптической формы.

Имя свойства: circular

Тип свойства: Boolean

Работа с пустыми и нулевыми значениями

Массив данных может содержать пустые, нулевые или отрицательные значения, которые не могут быть отображены на секторном графике. Для их отображения в секторном графике применяется специальная обработка. Если в массиве данных обнаружены пустые или нулевые значения, Круговая диаграмма по умолчанию помещает метку в позицию, где отображался бы сектор графика, если бы он имел положительные значения, и также добавляет элемент в легенду графика. Если вы хотите, чтобы нулевые и пустые значения игнорировались, используйте следующие свойства:

Игнорировать значения null

Флажок, контролирующий, будут ли игнорироваться пустые значения в массиве данных.

Имя свойства: ignoreNullValues

Тип свойства: Boolean

Игнорировать нулевые значения

Флажок, контролирующий, будут ли игнорироваться нулевые значения в массиве данных.

Имя свойства: ignoreZeroValues

Тип свойства: Boolean

Эффект тени

Область построения отобразит эффект "тени", контролируемый несколькими свойствами:

Окраска тени

Цвет, используемый для отображения эффекта "тени". Если отключено, тень не отображается.

Имя свойства: shadowPaint

Тип свойства: Data Table

Смещение тени по Х

Смещение эффекта тени по оси Х.

Имя свойства: shadowXOffset

Тип свойства: Float

Смещение тени по Y

Смещение эффекта тени по оси Y.

Имя свойства: shadowXOffset

Тип свойства: Float

Метки и всплывающие подсказки секторов

Генератор меток

Метки секторов формируются согласно следующим свойствам:

Свойство

Имя

Тип

Описание

Отключено

isNull

логическое

Флажок, включающий/отключающий метки элементов.

Формат меток

labelFormat

строка

Форматная строка, содержащая следующие символы:

  • {0} - имя серии
  • {1} - строковое представление значения
  • {2} - строковое представление значения в процентах
  • {3} - сумма всех значений

Числовой формат

numberFormat

строка

Шаблон числового формата.

Процентный формат

percentFormat

строка

Шаблон числового формата, используемый для процентных значений.

Имя свойства: labelGenerator

Тип свойства: Data Table

Генератор подсказок

Всплывающие подсказки секторов формируются согласно следующим свойствам:

Свойство

Имя

Type

Тип

Отключено

isNull

логическое

Флажок, который включает/отключает всплывающие подсказки.

Формат меток

labelFormat

строка

Форматная строка, содержащая следующие символы:

  • {0} - имя серии
  • {1} - строковое представление значения
  • {2} - строковое представление значения в процентах
  • {3} - сумма всех значений

Числовой формат

numberFormat

строка

Шаблон числового формата.

Процентный формат

percentFormat

строка

Шаблон числового формата, используемый для процентных значений.

Имя свойства: toolTipGenerator

Тип свойства: Data Table

Отделяемые секторы

Секторная область построения поддерживает отображение "отделяемых" секторов, когда сектор графика смещается от центра для выделения.

Пример отделяемого сектора:

Чтобы предоставить достаточное пространство для секторов, которые смещаются от центра графика, радиус основного сектора убавляется, поэтому график с отделяемыми секторами будет казаться меньше обычного секторного графика.

Выделение секций

Таблица, контролирующая "отделяемость" секторов:

Свойство

Имя

Тип

Описание

Серия

series

строка

Имя отделяемой серии данных.

Проценты

explodePercents

плавающее

Величина, на которую смещается сектор графика, выраженная в процентах от радиуса сектора.

Имя свойства: explodedPercents

Тип свойства: Data Table

Цвета секторов

Цвет, используемый для заливки каждого сектора на графике, по умоланию устанавливается автоматически.

Базовая окраска секций

Цвет сектора по умолчанию, используемый, если для серий нет заданных пользовательских настроек.

Имя свойства: baseSectionPaint

Тип свойства: Data Table

Автозаполнение окрасок секций

Флажок, контролирующий, будут ли использованы различные, определенные заранее цвета для заливки секторов.

Имя свойства: autoPopulateSectionPaints

Тип свойства: Boolean

Окраска секций

Таблица, определяющая цвет для каждого сектора.

Свойство

Имя

Тип

Описание

Серия

series

строка

Имя серии данных.

Цвет

paint

таблица данных

Цвет заливки серии (сектора).

Имя свойства: sectionPaints

Тип свойства: Data Table

Контуры секторов

Контуры секторов отображаются по умолчанию в виде тонкой серой линии. Секторная область построения предлагает следующие опции:

  • Полностью отключить отображение контуров;
  • Изменить контуры всех секторов, отредактировав значение по умолчанию;
  • Контролировать контур определенного сектора в отдельности.

Видимость окантовки секций

Флажок, контролирующий, будут ли отображаться контуры секторов.

Имя свойства: sectionOutlinesVisible

Тип свойства: Boolean

Базовая окраска окантовки секций

Цвет контура по умолчанию, используемый, если для серии нет заданных пользовательских настроек.

Имя свойства: baseSectionOutlinePaint

Тип свойства: Data Table

Автозаполнение окрасок окантовки секций

Флажок, контролирующий, будут ли использованы различные, определенные заранее цвета контуров секторов.

Имя свойства: autoPopulateSectionOutlinePaints

Тип свойства: Boolean

Окраска окантовки секций

Таблица, определяющая цвет контура для каждого сектора.

Свойство

Имя

Тип

Описание

Серия

series

строка

Имя серии данных.

Цвет

paint

таблица данных

Цвет контура для серии (сектора).

Имя свойства: sectionOutlinePaints

Тип свойства: Data Table

Базовый штрих окантовки секций

Штрих контура секторов по умолчанию, используемый, если для серии нет заданных пользовательских настроек.

Имя свойства: baseSectionOutlineStroke

Тип свойства: Data Table

Автозаполнение штрихов окантовки секций

Флажок, контролирующий, будут ли использованы различные, определенные заранее цвета штриха контуров секторов.

Имя свойства: autoPopulateSectionOutlineStrokes

Тип свойства: Boolean

Штрихи окантовок секций

Таблица, определяющая штрих контура для каждого сектора.

Свойство

Имя

Тип

Описание

Серия

series

строка

Имя серии.

Штрих

stroke

таблица данных

Штрих контура для серии (сектора).

Имя свойства: sectionOutlineStrokes

Тип свойства: Data Table

Метки секторов

Шрифт меток

Шрифт, используемый для отображения меток секторов.

Имя свойства: labelFont

Тип свойства: Data Table

Окраска меток

Цвет, используемый для отображения меток секторов.

Имя свойства: labelPaint

Тип свойства: Data Table

Окраска фона меток

Цвет заливки блоков меток. Если отключено, блоки меток будут прозрачными (будет просматриваться цвет фона графика).

Имя свойства: labelBackgroundPaint

Тип свойства: Data Table

Окраска окантовки меток

Цвет контура вокруг меток секторов. Если отключено, блоки меток будут отображаться без контура.

Имя свойства: labelOutlinePaint

Тип свойства: Data Table

Штрих окантовки меток

Штрих контура вокруг меток секторов. Если отключено, блоки меток будут отображаться без контура.

Имя свойства: labelOutlineStroke

Тип свойства: Data Table

Окраска тени меток

Цвет тени под метками секторов. Если отключено, тень не отображается.

Имя свойства: labelShadowPaint

Тип свойства: Data Table

Отступы меток

Отступ для меток, т.е. пустое пространство вокруг текста и внутри контура. См. Прямоугольные вставки.

Имя свойства: labelPadding

Тип свойства: Data Table

Соединения с метками

Для регулярных (непростых, см. далее) меток секторов отображается линия, соединяющая сектор графика с соответствующей ему меткой. Данные соединения имеют следующие свойства:

Видимость линий меток

Флажок, контролирующий, будут ли отображаться линии соединения с метками.

Имя свойства: labelLinksVisible

Тип свойства: Boolean

Стиль линий меток

Стиль соединений с метками: Стандартный, Квадратический или Кубический

Имя свойства: labelLinkStyle

Тип свойства: String

Граница линий меток

Линия соединений с метками имеет сгиб или "локоть" в точке, расположенной немного за пределами секторного графика. Расстояние до точки от края графика выражается в процентах от радиуса сектора и является Границей соединений с метками. Значением по умолчанию является 0.025 (два с половиной процента).

Имя свойства: labelLinkMargin

Тип свойства: Float

Окраска линий меток

Цвет линий соединения частей секторов с соответствующими метками.

Имя свойства: labelLinkPaint

Тип свойства: Data Table

Штрих линий меток

Штрих линий соединения частей секторов с соответствующими метками.

Имя свойства: labelLinkStroke

Тип свойства: Data Table

Граница линий меток

Интервал между краями сектора и областями меток по левому и правому краю сектора в процентах от общей ширины графика. Значением по умолчанию является 0.025 (2.5%).

Имя свойства: labelGap

Тип свойства: Float

Максимальная ширина меток

Максимальная ширина метки в процентах от ширины области построения. Значением по умолчанию является 0.14 (четырнадцать процентов).

Имя свойства: maximumLabelWidth

Тип свойства: Float

Простые метки

Использование "простых" меток позволяет вам быть уверенным в том, что метки будут отображены в центре каждого сектора. Не предпринимается никаких попыток избежать наложения меток в случае, когда несколько маленьких секторов отображаются рядом друг с другом, поэтому используйте простые метки, когда их наложение не будет представлять проблему для вас.

Простые метки

Флажок, контролирующий, будут ли метки секторов отображаться в "простом" формате.

Имя свойства: simpleLabels

Тип свойства: Boolean

Смещение простых меток

Вставки, используемые для расчета точек привязки простых меток относительно ограничительного прямоугольника секторной области построения.

Имя свойства: simpleLabelOffset

Тип свойства: Data Table

Другие свойства

Минимальный угол сектора для отрисовки

Минимальный угол дуги для сектора графика.

Имя свойства: minimumArcAngleToDraw

Тип свойства: Float

Форма элементов легенды

Форма, отображаемая для каждого элемента легенды.

Имя свойства: legendItemShape

Тип свойства: Data Table