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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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