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

ChartDateAxisBuilder

Properties

Axis - IChartDateAxis

The base time interval for the axis labels. The default baseUnit is determined automatically from the value range.

Methods

BaseUnit(Kendo.Mvc.UI.ChartAxisBaseUnit)

Sets the date axis base unit.

Parameters

baseUnit - ChartAxisBaseUnit

The Base Unit of the date axis.

Example


            @(Html.Kendo().Chart()
                    .Name("chart")
                    .CategoryAxis(axis => axis
                        .Date().BaseUnit(ChartAxisBaseUnit.Days)
                    )
            )

Min(System.DateTime)

Sets the start date of the axis.

Parameters

min - System.DateTime

The start date of the axis.

Example


            @(Html.Kendo().Chart(Model)
                       .Name("Chart")
                       .XAxis(a => a.Date().Min(DateTime.Parse("2012/01/01")))
            )

Max(System.DateTime)

Sets the end date of the axis.

Parameters

max - System.DateTime

The end date of the axis.

Example


            @(Html.Kendo().Chart(Model)
                       .Name("Chart")
                       .XAxis(a => a.Date().Max(DateTime.Parse("2012/01/01")))
            )

MajorUnit(System.Double)

Sets the interval between major divisions in base units.

Parameters

majorUnit - System.Double

The interval between major divisions in base units.

Example


            @(Html.Kendo().Chart(Model)
                       .Name("Chart")
                       .XAxis(a => a.Date().BaseUnit(ChartAxisBaseUnit.Months).MajorUnit(4))
            )

MinorUnit(System.Double)

Sets the interval between minor divisions in base units. It defaults to 1/5th of the majorUnit

Parameters

minorUnit - System.Double

The interval between minor divisions in base units.

Example


            @(Html.Kendo().Chart(Model)
                       .Name("Chart")
                       .XAxis(a => a.Date().BaseUnit(ChartAxisBaseUnit.Days).MajorUnit(4).MinorUnit(2))
            )

AxisCrossingValue(System.DateTime)

Sets value at which the first perpendicular axis crosses this axis.

Parameters

axisCrossingValue - System.DateTime

The value at which the first perpendicular axis crosses this axis.

Example


            @(Html.Kendo().Chart(Model)
                       .Name("Chart")
                       .XAxis(axis => axis.Date().AxisCrossingValue(DateTime.Parse("2012/01/01")))
            )

AxisCrossingValue(System.DateTime[])

Sets value at which perpendicular axes cross this axis.

Parameters

axisCrossingValues - System.DateTime[]

The values at which perpendicular axes cross this axis.

Example


            @(Html.Kendo().Chart(Model)
                       .Name("Chart")
                       .CategoryAxis(axis => axis.Date().AxisCrossingValue(DateTime.Parse("2012/01/01"), DateTime.Parse("2012/01/10")))
                       .ValueAxis(axis => axis.Numeric().Title("Axis 1"))
                       .ValueAxis(axis => axis.Numeric("secondary").Title("Axis 2"))
            )

AxisCrossingValue(System.Collections.Generic.IEnumerable)

Sets value at which perpendicular axes cross this axis.

Parameters

axisCrossingValues - System.Collections.Generic.IEnumerable<DateTime>

The values at which perpendicular axes cross this axis.

Example


            @(Html.Kendo().Chart(Model)
                       .Name("Chart")
                       .CategoryAxis(axis => axis.Date().AxisCrossingValue(new DateTime[] {
                           DateTime.Parse("2012/01/01"), DateTime.Parse("2012/01/10")
                       }))
                       .ValueAxis(axis => axis.Numeric().Title("Axis 1"))
                       .ValueAxis(axis => axis.Numeric("secondary").Title("Axis 2"))
            )

Labels(System.Action)

Configures the axis labels.

Parameters

configurator - System.Action<ChartDateAxisLabelsBuilder>

The configuration action.

Example


            @(Html.Kendo().Chart()
                       .Name("Chart")
                       .XAxis(axis => axis
                           .Date()
                           .Labels(labels => labels
                               .Culture(new CultureInfo("es-ES"))
                               .Visible(true)
                           )
                       )
            )

Labels(System.Action)

Configures the axis labels.

Parameters

configurator - System.Action<ChartAxisLabelsBuilder>

The configuration action.

Example


            @(Html.Kendo().Chart()
                       .Name("Chart")
                       .XAxis(axis => axis
                           .Date()
                           .Labels(labels => labels
                               .Culture(new CultureInfo("es-ES"))
                               .Visible(true)
                           )
                       )
            )

Notes(System.Action)

Defines the items.

Parameters

configurator - System.Action<ChartAxisNotesBuilder>

The items of the notes.

Example


            @(Html.Kendo().Chart()
                      .Name("Chart")
                      .ValueAxis(a => a.Numeric()
                          .Note(note => note
                               .Data(items =>
                               {
                                   items.Add().Value(1);
                                   items.Add().Value(2);
                               })
                          )
                       )
            )

MajorTicks(System.Action)

Configures the axis major ticks.

Parameters

configurator - System.Action<ChartAxisTicksBuilder>

The action that configures the major ticks options.

Example


            @(Html.Kendo().Chart()
                 .Name("chart")
                 .CategoryAxis(axis => axis
                    .MajorTicks(m => m.Visible(false))
                 )
            )

Crosshair(System.Action)

Defines the crosshair configuration options.

Parameters

configurator - System.Action<ChartAxisCrosshairBuilder>

The action that configures the crosshair settings.

Example


            @(Html.Kendo().Chart()
                 .Name("chart")
                 .CategoryAxis(axis => axis
                    .Crosshair(c => c.Visible(true).Color("green"))
                 )
            )

Name(System.String)

Sets the axis name.

Parameters

name - System.String

The value that configures the axis name.

Example


            @(Html.Kendo().Chart()
                 .Name("chart")
                 .CategoryAxis(axis => axis.Name("year-axis"))
            )

MinorTicks(System.Action)

Configures the axis minor ticks.

Parameters

configurator - System.Action<ChartAxisTicksBuilder>

The action that configures the minor ticks options.

Example


            @(Html.Kendo().Chart()
                 .Name("chart")
                 .CategoryAxis(axis => axis
                    .MinorTicks(m => m.Visible(false))
                 )
            )

MajorGridLines(System.Action)

Configures the axis major grid lines. These lines are an extension of the major ticks through the body of the chart.

Parameters

configurator - System.Action<ChartMajorGridLinesBuilder>

The action that configures the major grid lines options.

Example


            @(Html.Kendo().Chart()
                       .Name("chart")
                       .CategoryAxis(axis => axis
                           .MajorGridLines(lines => lines.Visible(true))
                       )
            )

MajorGridLines(System.Int32,System.String,Kendo.Mvc.UI.ChartDashType)

Sets the width, color, and dash type of the major grid lines and enables them. These lines are an extension of the major ticks through the body of the chart.

Parameters

width - System.Int32

The value of the width.

color - System.String

The value of the color (CSS syntax).

dashType - ChartDashType

The enum value that defines the dash type.

Example


            @(Html.Kendo().Chart()
                       .Name("chart")
                       .CategoryAxis(axis => axis
                           .MajorGridLines(2, "red", ChartDashType.Dot)
                       )
            )

MinorGridLines(System.Action)

Configures the axis minor grid lines. These lines are an extension of the minor ticks through the body of the chart.

Parameters

configurator - System.Action<ChartMinorGridLinesBuilder>

The action that configures the minor grid lines options.

Example


            @(Html.Kendo().Chart()
                       .Name("chart")
                       .CategoryAxis(axis => axis
                           .MinorGridLines(lines => lines.Visible(true))
                       )
            )

MinorGridLines(System.Int32,System.String,Kendo.Mvc.UI.ChartDashType)

Sets the width, color, and dash type of the minor grid lines and enables them. These lines are an extension of the minor ticks through the body of the chart.

Parameters

width - System.Int32

The value of the width.

color - System.String

The value of the color (CSS syntax).

dashType - ChartDashType

The enum value that defines the dash type.

Example


            @(Html.Kendo().Chart()
                       .Name("chart")
                       .CategoryAxis(axis => axis
                           .MinorGridLines(2, "red", ChartDashType.Dot)
                       )
            )

Line(System.Action)

Defines the configuration of the axis lines. The line settings also affect the major and minor ticks but not the grid lines.

Parameters

configurator - System.Action<ChartLineBuilder>

The action that configures the lines options.

Example


            @(Html.Kendo().Chart()
                       .Name("chart")
                       .CategoryAxis(axis => axis
                           .Line(line => line.Color("#f00"))
                       )
            )

Line(System.Int32,System.String,Kendo.Mvc.UI.ChartDashType)

Sets the width, color, and dash type of the lines and enables them. The line settings also affect the major and minor ticks but not the grid lines.

Parameters

width - System.Int32

The value of the width.

color - System.String

The value of the color (CSS syntax).

dashType - ChartDashType

The enum value that defines the dash type.

Example


            @(Html.Kendo().Chart()
                       .Name("chart")
                       .CategoryAxis(axis => axis
                           .Line(2, "#f00", ChartDashType.Dot)
                       )
            )

Labels(System.Boolean)

Sets the visibility of axis labels. By default, the labels are visible.

Parameters

visible - System.Boolean

The option that toggles the visibility of the labels.

Example


            @(Html.Kendo().Chart()
                       .Name("chart")
                       .CategoryAxis(axis => axis.Labels(false))
            )

PlotBands(System.Action)

Defines the plot bands of the axis.

Parameters

configurator - System.Action<ChartAxisPlotBandsFactory>

The action that configures the plot bands options.

Example


            @(Html.Kendo().Chart()
                       .Name("chart")
                       .CategoryAxis(axis => axis
                           .PlotBands(bands =>
                           {
                                bands.Add().From(0).To(4).Color("lightgreen");
                                bands.Add().From(4).To(10).Color("lightblue");
                            })
                       )
            )

Title(System.Action)

Defines the title configuration of the axis.

Parameters

configurator - System.Action<ChartAxisTitleBuilder>

The action that configures the title settings.

Example


            @(Html.Kendo().Chart()
                       .Name("chart")
                       .CategoryAxis(axis => axis
                           .Title(title => title.Text("Category").Background("yellow"))
                       )
            )

Title(System.String)

Sets the text of the axis title.

Parameters

title - System.String

The value that configures the text of the title.

Example


            @(Html.Kendo().Chart()
                       .Name("chart")
                       .CategoryAxis(axis => axis.Title("Category Axis"))
            )

Pane(System.String)

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

Parameters

pane - System.String

The value that configures the name of the pane.

Example


            @(Html.Kendo().Chart()
                       .Name("chart")
                       .Panes(panes => {
                           panes.Add().Title("Value");
                           panes.Add("volumePane").Title("Volume");
                       })
                       .CategoryAxis(axis => axis
                           .Pane("volumePane")
                       )
            )

Color(System.String)

Sets the color for all axis elements. It can be overridden by the individual settings (Labels or Lines).

Parameters

color - System.String

The value of the color.

Example


            @(Html.Kendo().Chart()
                       .Name("chart")
                       .CategoryAxis(axis => axis
                           .Color("#ff0000")
                       )
            )

Reverse(System.Boolean)

If set to "true", the axis direction will be reversed.

Parameters

reverse - System.Boolean

A value indicating if the axis labels must be rendered in reverse.

Example


            @(Html.Kendo().Chart()
                       .Name("chart")
                       .CategoryAxis(axis => axis
                           .Reverse(true)
                       )
            )

Reverse()

If set to "true", the axis direction will be reversed.

Example


            @(Html.Kendo().Chart()
                       .Name("chart")
                       .CategoryAxis(axis => axis
                           .Reverse(true)
                       )
            )

Visible(System.Boolean)

Sets the visibility of the axis.

Parameters

visible - System.Boolean

The option that toggles the visibility of the axis.

Example


            @(Html.Kendo().Chart()
                      .Name("chart")
                      .CategoryAxis(axis => axis
                          .Visible(false)
                      )
            )

StartAngle(System.Double)

Defines the angle (degrees) where the first axis value is placed. The angles increase clockwise and zero is to the left. The negative values are acceptable.

Parameters

startAngle - System.Double

The start angle value.

Example


            @(Html.Kendo().Chart()
                      .Name("chart")
                      .CategoryAxis(axis => axis
                          .StartAngle(180)
                      )
            )

NarrowRange(System.Boolean)

If set to "true", the Chart will narrow the value axis range to display data points in detail. When the option is disabled, the Chart will force the automatic axis range to start from 0 or the explicitly specified.

Parameters

narrowRange - System.Boolean

The value that enables or disables the NarrowRange option.

Example


            @(Html.Kendo().Chart()
                       .Name("chart")
                       .ValueAxis(axis => axis
                           .Numeric()
                           .NarrowRange(false)
                       )
            )

Background(System.String)

Sets the background color of the axis.

Parameters

background - System.String

The value that configures the background color.

Example


            @(Html.Kendo().Chart()
                       .Name("chart")
                       .CategoryAxis(axis => axis.Background("#ff0000"))
            )

RangeLabels(System.Action)

Defines the configuration of the range labels of the date axis.

Parameters

configurator - System.Action<ChartAxisRangeLabelsBuilder>

The action that configures the range labels settings.

Example


            @(Html.Kendo().Chart()
                       .Name("chart")
                       .CategoryAxis(axis => axis
                            .Date()
                            .RangeLabels(labels => labels.Color("green").Visible(true))
                       )
            )

In this article
Not finding the help you need?