Отрисовщик столбцов категорий

Данный отрисовщик является подтипом Отрисовщика категорий и используется вместе с Категорийной областью построения для создания столбчатых графиков. Он унаследует все свойства Категорийного отрисовщика и имеет свои собственные свойства.

Контролирование ширины столбцов

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

Граница элементов

Граница элементов в процентах от общей длины оси категорий (по умолчанию, 0.20 или двадцать процентов). Данное свойство контролирует пространство, предназначенное для интервалов между столбцами в пределах одной категории.

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

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

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

Максимальная ширина столбца в процентах от длины оси. Например, значение, равное  0.05, определяет, что ширина столбцов никогда не будет превышать пяти процентов от длины оси. Это позволяет улучшить внешний вид графиков, в которых отображаются один или два столбца.

Пример графика с ограниченной максимальной шириной столбцов:

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

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

Базовое значение

По умолчанию отрисовщик отображает столбец между нулем (базовым значением) и значением данных отображаемого элемента. Некоторые графики требуют ненулевое базовое значение.

Базовое значение

Базовое значение для столбцов.

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

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

Включать базовое значение в диапазон

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

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

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

Метки элементов

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

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

Альтернативное положение меток элементов

Данное свойство включает два значения:

  • Позиция меток положительных элементов: альтернативная позиция для меток положительных значений. Установите значение на null, если вы хотите скрыть значения, которые не помещаются внутри столбца.
  • Позиция меток отрицательных элементов: альтернативная позиция для меток отрицательных значений. Установите значение на null, если вы хотите скрыть значения, которые не помещаются внутри столбца.

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

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

Тени столбцов

Видимость тени

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

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

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

Окраска тени

Цвет заливки теней столбцов.

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

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

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

Смещение теней столбцов по оси Х.

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

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

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

Y

Смещение теней столбцов по оси Y.

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

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

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

Окраска столбцов

Отрисовщик столбцов отвечает за фактическое отображение отдельного столбца. Он обладает следующими свойствами:

Свойство

Имя

Тип

Описание

Тип

type

целое

Тип редактора: Стандартный или Градиентный:

  • Стандартный редактор столбцов использует для заливки один Цвет (текущий цвет серии данных).
  • Градиентный редактор столбцов применяет эффект нескольких областей градиента, чтобы придать столбцам оригинальный вид.

G1

g1

плавающее

Точка деления между первой и второй областями градиента (больше 0.0).

G2

g2

плавающее

Точка деления между второй и третьей градиентными областями (больше G1).

G3

g3

плавающее

Точка деления между третьей и четвертой градиентными областями (больше G2 и меньше 1.0).

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

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

Окантовка столбцов

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

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

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

Максимальная длина столбца

Устанавливает минимальную длину, применимую к столбцам. Вы можете задать малое значение (например, 1.0), чтобы предотвратить отображение слишком коротких столбцов.

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

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