ChartDateCategoryAxisBuilder
Configures the date category axis for the Chart.
Properties
Container - Chart
Gets or sets the data to display in the Chart.
Axis - IChartDateCategoryAxis
The categories displayed on the axis
Methods
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.Collections.Generic.IEnumerable)
Defines categories.
Parameters
categories - System.Collections.Generic.IEnumerable<DateTime>
The list of categories
Example
@(Html.Kendo().Chart()
.Name("Chart")
.CategoryAxis(axis => axis
.Date().Categories(Model.Categories)
)
)
Categories(System.DateTime[])
Defines categories.
Parameters
categories - System.DateTime[]
The list of categories
Example
@(Html.Kendo().Chart()
.Name("chart")
.CategoryAxis(axis => axis
.Date().Categories(DateTime.Now, DateTime.Now.AddDays(1), DateTime.Now.AddDays(2))
)
)
BaseUnit(Kendo.Mvc.UI.ChartAxisBaseUnit)
Sets the date category axis base unit.
Parameters
baseUnit - ChartAxisBaseUnit
The date category axis base unit
Example
@(Html.Kendo().Chart()
.Name("chart")
.CategoryAxis(axis => axis
.Date().BaseUnit(ChartAxisBaseUnit.Days)
)
)
BaseUnitStep(System.Int32)
Sets the step (interval) between categories in base units. Specifiying 0 (auto) will set the step to such value that the total number of categories does not exceed MaxDateGroups.
Parameters
baseUnitStep - System.Int32
the step (interval) between categories in base units. Set 0 for automatic step. The default value is 1.
Example
@(Html.Kendo().Chart()
.Name("chart")
.CategoryAxis(axis => axis
.Date().BaseUnit(ChartAxisBaseUnit.Days).BaseUnitStep(7)
)
)
MaxDateGroups(System.Int32)
Specifies the maximum number of groups (categories) that the chart will attempt to produce when either BaseUnit is set to Fit or BaseUnitStep is set to 0 (auto). This option is ignored in all other cases.
Parameters
maxDateGroups - System.Int32
the maximum number of groups (categories). The default value is 10.
Example
@(Html.Kendo().Chart()
.Name("chart")
.CategoryAxis(axis => axis
.Date().BaseUnit(ChartAxisBaseUnit.Days).MaxDateGroups(30)
)
)
MaxDivisions(System.Double)
The maximum number of ticks and labels to display. Applicabable for date category axis.
Parameters
value - System.Double
The value for MaxDivisions
Example
@(Html.Kendo().Chart()
.Name("chart")
.CategoryAxis(axis => axis
.Date().MaxDivisions(100)
)
)
RoundToBaseUnit(System.Boolean)
If set to false, the min and max dates will not be rounded off to the nearest baseUnit. This option is most useful in combination with explicit min and max dates. It will be ignored if either Bar, Column, OHLC or Candlestick series are plotted on the axis.
Parameters
roundToBaseUnit - System.Boolean
A boolean value that indicates if the axis range should be rounded to the nearest base unit. The default value is true.
Example
@(Html.Kendo().Chart()
.Name("chart")
.CategoryAxis(axis => axis
.Date().RoundToBaseUnit(false)
)
)
WeekStartDay(System.DayOfWeek)
Sets the week start day.
Parameters
weekStartDay - System.DayOfWeek
The week start day when the base unit is Weeks. The default is Sunday.
Example
@(Html.Kendo().Chart()
.Name("chart")
.CategoryAxis(axis => axis
.Date().WeekStartDay(DayOfWeek.Monday)
)
)
Justify(System.Boolean)
Positions categories and series points on major ticks. This removes the empty space before and after the series. This option will be ignored if either Bar, Column, OHLC or Candlestick series are plotted on the axis.
Parameters
justified - System.Boolean
A boolean value that indicates if the empty space before and after the series should be removed. The default value is false.
Example
@(Html.Kendo().Chart()
.Name("chart")
.CategoryAxis(axis => axis
.Date().Justify(true)
)
)
Justify()
Positions categories and series points on major ticks. This removes the empty space before and after the series. This option will be ignored if either Bar, Column, OHLC or Candlestick series are plotted on the axis.
Example
@(Html.Kendo().Chart()
.Name("chart")
.CategoryAxis(axis => axis
.Date().Justify(true)
)
)
AutoBaseUnitSteps(System.Action)
Specifies the discrete baseUnitStep values when either BaseUnit is set to Fit or BaseUnitStep is set to 0 (auto).
Parameters
configurator - System.Action<ChartAxisBaseUnitStepsBuilder>
The configuration action.
Example
@(Html.Kendo().Chart()
.Name("chart")
.CategoryAxis(axis => axis
.Date().AutoBaseUnitSteps(steps => steps.Days(1, 5, 10))
)
)
Min(System.DateTime)
Sets the date category axis minimum (start) date.
Parameters
min - System.DateTime
The date category axis minimum (start) date
Example
@(Html.Kendo().Chart()
.Name("chart")
.CategoryAxis(axis => axis
.Date().Min(DateTime.Now)
)
)
Max(System.DateTime)
Sets the date category axis maximum (end) date.
Parameters
max - System.DateTime
The date category axis maximum (end) date
Example
@(Html.Kendo().Chart()
.Name("chart")
.CategoryAxis(axis => axis
.Date().Max(DateTime.Now)
)
)
AxisCrossingValue(System.Double)
Sets value at which the first perpendicular axis crosses this axis.
Parameters
axisCrossingValue - System.Double
The value at which the first perpendicular axis crosses this axis.
Example
@(Html.Kendo().Chart(Model)
.Name("Chart")
.CategoryAxis(axis => axis.Date().AxisCrossingValue(4))
.ValueAxis(axis => axis.Numeric().Title("Axis 1"))
.ValueAxis(axis => axis.Numeric("secondary").Title("Axis 2"))
)
AxisCrossingValue(System.Double[])
Sets value at which perpendicular axes cross this axis.
Parameters
axisCrossingValues - System.Double[]
The values at which perpendicular axes cross this axis.
Example
@(Html.Kendo().Chart(Model)
.Name("Chart")
.CategoryAxis(axis => axis.Date().AxisCrossingValue(0, 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<Double>
The values at which perpendicular axes cross this axis.
Example
@(Html.Kendo().Chart(Model)
.Name("Chart")
.CategoryAxis(axis => axis.Date().AxisCrossingValue(new double[] { 0, 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")
.CategoryAxis(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")
.CategoryAxis(axis => axis
.Date()
.Labels(labels => labels
.Culture(new CultureInfo("es-ES"))
.Visible(true)
)
)
)
Select(System.Nullable,System.Nullable)
Sets the selection range
Parameters
from - System.Nullable<DateTime>
The selection range start.
to - System.Nullable<DateTime>
The selection range end. Note: The specified date is not included in the selected range unless the axis is justified. In order to select all categories specify a value larger than the last date.
Example
@(Html.Kendo().Chart(Model)
.Name("Chart")
.CategoryAxis(axis => axis.Select(DateTime.Today.AddMonths(-1), DateTime.Today))
)
Select(System.Action)
Configures the selection
Parameters
configurator - System.Action<ChartAxisSelectionBuilder>
The configuration action.
Example
@(Html.Kendo().Chart(Model)
.Name("Chart")
.CategoryAxis(axis => axis.Select(select =>
select.Mousewheel(mw => mw.Reverse())
))
)
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(data =>
{
data.Add().Value(1);
data.Add().Value(2);
})
)
)
)
MajorTicks(System.Action)
Configures the major ticks.
Parameters
configurator - System.Action<ChartAxisTicksBuilder>
The configuration action.
Example
@(Html.Kendo().Chart(Model)
.Name("Chart")
.ValueAxis(axis => axis
.MajorTicks(ticks => ticks
.Visible(false)
)
)
)
Crosshair(System.Action)
Configures the major ticks.
Parameters
configurator - System.Action<ChartAxisCrosshairBuilder>
The configuration action.
Example
@(Html.Kendo().Chart(Model)
.Name("Chart")
.ValueAxis(axis => axis
.Crosshair(crosshair => crosshair
.Visible(false)
)
)
)
Name(System.String)
Sets the axis name.
Parameters
name - System.String
The axis name.
Example
@(Html.Kendo().Chart(Model)
.Name("Chart")
.ValueAxis(axis => axis
.Name("axisName")
)
)
MinorTicks(System.Action)
Configures the minor ticks.
Parameters
configurator - System.Action<ChartAxisTicksBuilder>
The configuration action.
Example
@(Html.Kendo().Chart(Model)
.Name("Chart")
.ValueAxis(axis => axis
.MinorTicks(ticks => ticks
.Visible(false)
)
)
)
MajorGridLines(System.Action)
Configures the major grid lines.
Parameters
configurator - System.Action<ChartMajorGridLinesBuilder>
The configuration action.
Example
@(Html.Kendo().Chart()
.Name("Chart")
.CategoryAxis(axis => axis
.Categories(s => s.DateString)
.MajorGridLines(lines => lines.Visible(true))
)
)
MajorGridLines(System.Int32,System.String,Kendo.Mvc.UI.ChartDashType)
Sets color and width of the major grid lines and enables them.
Parameters
width - System.Int32
The major gridlines width
color - System.String
The major gridlines width
dashType - ChartDashType
The major gridlines line dashType.
Example
@(Html.Kendo().Chart()
.Name("Chart")
.CategoryAxis(axis => axis
.Categories(s => s.DateString)
.MajorGridLines(2, "red", ChartDashType.Dot)
)
)
MinorGridLines(System.Action)
Configures the minor grid lines.
Parameters
configurator - System.Action<ChartMinorGridLinesBuilder>
The configuration action.
Example
@(Html.Kendo().Chart()
.Name("Chart")
.CategoryAxis(axis => axis
.Categories(s => s.DateString)
.MinorGridLines(lines => lines.Visible(true))
)
)
MinorGridLines(System.Int32,System.String,Kendo.Mvc.UI.ChartDashType)
Sets color and width of the minor grid lines and enables them.
Parameters
width - System.Int32
The minor gridlines width
color - System.String
The minor gridlines width
dashType - ChartDashType
The minor grid lines dash type
Example
@(Html.Kendo().Chart()
.Name("Chart")
.CategoryAxis(axis => axis
.Categories(s => s.DateString)
.MinorGridLines(2, "red", ChartDashType.Dot)
)
)
Line(System.Action)
Configures the axis line.
Parameters
configurator - System.Action<ChartLineBuilder>
The configuration action.
Example
@(Html.Kendo().Chart()
.Name("Chart")
.CategoryAxis(axis => axis
.Categories(s => s.DateString)
.Line(line => line.Color("#f00"))
)
)
Line(System.Int32,System.String,Kendo.Mvc.UI.ChartDashType)
Sets color and width of the lines and enables them.
Parameters
width - System.Int32
The axis line width
color - System.String
The axis line width
dashType - ChartDashType
The axis line dashType.
Example
@(Html.Kendo().Chart()
.Name("Chart")
.CategoryAxis(axis => axis
.Categories(s => s.DateString)
.Line(2, "#f00", ChartDashType.Dot)
)
)
Labels(System.Boolean)
Sets the visibility of numeric axis chart labels.
Parameters
visible - System.Boolean
The visibility. The default value is false.
Example
@(Html.Kendo().Chart()
.Name("Chart")
.CategoryAxis(axis => axis.Labels(true))
)
PlotBands(System.Action)
Defines the plot bands items.
Parameters
configurator - System.Action<ChartAxisPlotBandsFactory>
The add action.
Example
@(Html.Kendo().Chart()
.Name("Chart")
.ValueAxis(axis => axis
.Numeric()
.Min(0).Max(10)
.PlotBands(bands => {
bands.Add().From(0).To(4).Color("lightgreen");
bands.Add().From(4).To(10).Color("lightblue");
})
)
)
Title(System.Action)
Configures the chart axis title.
Parameters
configurator - System.Action<ChartAxisTitleBuilder>
The configuration action.
Example
@(Html.Kendo().Chart()
.Name("Chart")
.CategoryAxis(axis => axis
.Categories(s => s.DateString)
.Title(title => title.Text("Axis"))
)
)
Title(System.String)
Sets the axis title.
Parameters
title - System.String
The axis title.
Example
@(Html.Kendo().Chart()
.Name("Chart")
.CategoryAxis(axis => axis
.Categories(s => s.DateString)
.Title("Axis")
)
)
Pane(System.String)
Renders the axis in the pane with the specified name.
Parameters
pane - System.String
The pane name.
Example
@(Html.Kendo().Chart()
.Name("Chart")
.Panes(panes => {
panes.Add().Title("Value");
panes.Add("volumePane").Title("Volume");
})
.CategoryAxis(axis => axis
.Categories(s => s.DateString)
.Pane("volumePane")
)
)
Color(System.String)
Sets the color for all axis elements. Can be overriden by individual settings.
Parameters
color - System.String
The axis color.
Example
@(Html.Kendo().Chart()
.Name("Chart")
.CategoryAxis(axis => axis
.Categories(s => s.DateString)
.Color("#ff0000")
)
)
Reverse(System.Boolean)
Sets the axis reverse option.
Parameters
reverse - System.Boolean
A value indicating if the axis labels should be rendered in reverse.
Example
@(Html.Kendo().Chart()
.Name("Chart")
.CategoryAxis(axis => axis
.Categories(s => s.DateString)
.Reverse(true)
)
)
Reverse()
Sets the axis reverse option.
Example
@(Html.Kendo().Chart()
.Name("Chart")
.CategoryAxis(axis => axis
.Categories(s => s.DateString)
.Reverse(true)
)
)
Visible(System.Boolean)
Sets the axis visibility
Parameters
visible - System.Boolean
The axis visibility.
Example
@(Html.Kendo().Chart()
.Name("Chart")
.CategoryAxis(axis => axis
.Visible(false)
)
)
StartAngle(System.Double)
The angle (degrees) where the 0 value is placed. It defaults to 0.
Parameters
startAngle - System.Double
Angles increase counterclockwise and 0 is to the right. Negative values are acceptable.
NarrowRange(System.Boolean)
A value indicating if the automatic axis range should snap to 0.
Parameters
narrowRange - System.Boolean
The narrowRange value.
Example
@(Html.Kendo().Chart()
.Name("Chart")
.ValueAxis(axis => axis
.Numeric()
.NarrowRange(false)
)
)
Background(System.String)
Sets the axis background color
Parameters
background - System.String
The axis background.
Example
@(Html.Kendo().Chart()
.Name("Chart")
.ValueAxis(axis => axis
.Numeric()
.Background("lightblue")
)
)
RangeLabels(System.Action)
Configures the axis range labels.
Parameters
configurator - System.Action<ChartAxisRangeLabelsBuilder>
The configuration action.
Example
@(Html.Kendo().Chart()
.Name("Chart")
.CategoryAxis(axis => axis
.RangeLabels(labels => labels
.Color("Red")
.Visible(true)
)
)
)