New to Telerik UI for ASP.NET Core? Download free 30-day trial

ChartCategoryAxisBuilder

Methods

Date()

Sets the axis type to date.

Categories(System.Linq.Expressions.Expression)

Defines bound categories.

Parameters

expression - System.Linq.Expressions.Expression<Func>

The expression used to extract the categories value from the chart model.

Categories(System.String[])

Sets the axis categories.

Parameters

categories - System.String[]

The value for the categories.

Categories(System.DateTime[])

Sets the axis categories.

Parameters

value - System.DateTime[]

The value for the categories.

Select(System.Object,System.Object)

Sets the selection range.

Parameters

from - System.Object
to - System.Object

Title(System.String)

Sets the axis title.

Parameters

value - System.String

AutoBaseUnitSteps(System.Action)

The discrete categoryAxis.baseUnitStep values when either categoryAxis.baseUnit is set to "fit" orcategoryAxis.baseUnitStep is set to "auto".The axis will try to divide the active period into successively larger intervals. It will start from x-second intervals, where x is picked from the autoBaseUnitSteps.seconds array. Then it will move to minutes, seconds and so on. This will continue until the number of intervals is less thanmaxDateGroups.

Parameters

configurator - System.Action<ChartCategoryAxisAutoBaseUnitStepsSettingsBuilder>

The configurator for the autobaseunitsteps setting.

AxisCrossingValue(System.Object[])

Category index at which the first value axis crosses this axis (when set as an object).Category indices at which the value axes cross the category axis (when set as an array).

Parameters

value - System.Object[]

The value for AxisCrossingValue

Background(System.String)

The background color of the axis.

Parameters

value - System.String

The value for Background

BaseUnitStep(System.Int32)

The step (interval) between categories in base units. Setting it to "auto" will set the step to such value that the total number of categories does not exceed categoryAxis.maxDateGroups.This option is ignored if categoryAxis.baseUnit is set to "fit".

Parameters

value - System.Int32

The value for BaseUnitStep

Color(System.String)

The color to apply to all axis elements. Accepts a valid CSS color string, including hex and rgb. Can be overridden by categoryAxis.labels.color andcategoryAxis.line.color.

Parameters

value - System.String

The value for Color

Crosshair(System.Action)

The crosshair configuration options.

Parameters

configurator - System.Action<ChartCategoryAxisCrosshairSettingsBuilder>

The configurator for the crosshair setting.

Field(System.String)

The data item field which contains the category name. Requires the dataSource option to be set. The field name should be a valid Javascript identifier and should contain only alphanumeric characters (or "$" or "_"), and may not start with a digit.

Parameters

value - System.String

The value for Field

Justify(System.Boolean)

If set to true the chart will position categories and series points on major ticks. This removes the empty space before and after the series.The default value is false except for "area", "verticalArea", "rangeArea" and "verticalRangeArea".

Parameters

value - System.Boolean

The value for Justify

Justify()

If set to true the chart will position categories and series points on major ticks. This removes the empty space before and after the series.The default value is false except for "area", "verticalArea", "rangeArea" and "verticalRangeArea".

Labels(System.Action)

The axis labels configuration.

Parameters

configurator - System.Action<ChartCategoryAxisLabelsSettingsBuilder>

The configurator for the labels setting.

Line(System.Action)

The configuration of the axis lines. Also affects the major and minor ticks, but not the grid lines.

Parameters

configurator - System.Action<ChartCategoryAxisLineSettingsBuilder>

The configurator for the line setting.

MajorGridLines(System.Action)

The configuration of the major grid lines. These are the lines that are an extension of the major ticks through the body of the chart.

Parameters

configurator - System.Action<ChartCategoryAxisMajorGridLinesSettingsBuilder>

The configurator for the majorgridlines setting.

MajorTicks(System.Action)

The configuration of the category axis major ticks.

Parameters

configurator - System.Action<ChartCategoryAxisMajorTicksSettingsBuilder>

The configurator for the majorticks setting.

Max(System.Object)

The last date displayed on the category date axis. By default, the minimum date is the same as the last category. This is often used in combination with the categoryAxis.min and categoryAxis.roundToBaseUnit options to set up a fixed date range.

Parameters

value - System.Object

The value for Max

MaxDateGroups(System.Double)

The maximum number of groups (categories) to display whencategoryAxis.baseUnit is set to "fit" orcategoryAxis.baseUnitStep is set to "auto".

Parameters

value - System.Double

The value for MaxDateGroups

MaxDivisions(System.Double)

The maximum number of ticks, labels and grid lines to display. Applicable for date category axis. You can combine this property with a bigger value of the maxDateGroups property to increase the number of rendered data points in the Chart without drawing too many labels, ticks, and grid lines.

Parameters

value - System.Double

The value for MaxDivisions

Min(System.Object)

The first date displayed on the category date axis. By default, the minimum date is the same as the first category. This is often used in combination with the categoryAxis.min and categoryAxis.roundToBaseUnit options to set up a fixed date range.

Parameters

value - System.Object

The value for Min

MinorGridLines(System.Action)

The configuration of the minor grid lines. These are the lines that are an extension of the minor ticks through the body of the chart.

Parameters

configurator - System.Action<ChartCategoryAxisMinorGridLinesSettingsBuilder>

The configurator for the minorgridlines setting.

MinorTicks(System.Action)

The configuration of the category axis minor ticks.

Parameters

configurator - System.Action<ChartCategoryAxisMinorTicksSettingsBuilder>

The configurator for the minorticks setting.

Name(System.String)

The unique axis name. Used to associate a series with a category axis using the series.categoryAxis option.

Parameters

value - System.String

The value for Name

Pane(System.String)

The name of the pane that the category axis should be rendered in. The axis will be rendered in the first (default) pane if not set.

Parameters

value - System.String

The value for Pane

PlotBands(System.Action)

The plot bands of the category axis.

Parameters

configurator - System.Action<ChartCategoryAxisPlotBandFactory>

The configurator for the plotbands setting.

RangeLabels(System.Action)

The configuration of the date axis date range labels.

Parameters

configurator - System.Action<ChartCategoryAxisRangeLabelsSettingsBuilder>

The configurator for the rangelabels setting.

Reverse(System.Boolean)

If set to true the category axis direction will be reversed. By default categories are listed from left to right and from bottom to top.

Parameters

value - System.Boolean

The value for Reverse

Reverse()

If set to true the category axis direction will be reversed. By default categories are listed from left to right and from bottom to top.

RoundToBaseUnit(System.Boolean)

If set to true the chart will round the first and last date to the nearest base unit.The roundToBaseUnit option will be ignored if series.type is set to "bar", "column", "boxPlot", "ohlc", "candlestick" or "waterfall".

Parameters

value - System.Boolean

The value for RoundToBaseUnit

Select(System.Action)

The selected axis range. If set, axis selection will be enabled.The range is index based, starting from 0. Categories with indexes in the range [select.from, select.to) will be selected. That is, the last category in the range will not be included in the selection.If the categories are dates, the range must also be specified with date values.

Parameters

configurator - System.Action<ChartCategoryAxisSelectSettingsBuilder>

The configurator for the select setting.

StartAngle(System.Double)

The angle (degrees) of the first category on the axis.Angles increase clockwise and zero is to the left. Negative values are acceptable.

Parameters

value - System.Double

The value for StartAngle

Title(System.Action)

The title configuration of the category axis.

Parameters

configurator - System.Action<ChartCategoryAxisTitleSettingsBuilder>

The configurator for the title setting.

Visible(System.Boolean)

If set to true the chart will display the category axis. By default the category axis is visible.

Parameters

value - System.Boolean

The value for Visible

WeekStartDay(System.Double)

The week start day when categoryAxis.baseUnit is set to "weeks".The supported values are: kendo.days.Sunday - equal to 0; kendo.days.Monday - equal to 1; kendo.days.Tuesday - equal to 2; kendo.days.Wednesday - equal to 3; kendo.days.Thursday - equal to 4; kendo.days.Friday - equal to 5 or kendo.days.Saturday - equal to 6.

Parameters

value - System.Double

The value for WeekStartDay

Notes(System.Action)

The category axis notes configuration.

Parameters

configurator - System.Action<ChartCategoryAxisNotesSettingsBuilder>

The configurator for the notes setting.

BaseUnit(Kendo.Mvc.UI.ChartAxisBaseUnit)

Specifies the base time interval for the axis.

Parameters

value - ChartAxisBaseUnit

The value for BaseUnit

Type(Kendo.Mvc.UI.ChartCategoryAxisType)

Specifies the category axis type.

Parameters

value - ChartCategoryAxisType

The value for Type

In this article
Not finding the help you need?