ChartCategoryAxisBuilder
Properties
Container - Chart
Gets or sets the data to display in the Chart.
Axis - IChartCategoryAxis
The categories displayed on the axis
Methods
Date()
Creates a Date category axis.
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
Example
@(Html.Kendo().Chart(Model)
.Name("chart")
.Series(series =>
{
series.Column(model => model.Value, model => model.UserColor);
})
.CategoryAxis(axis => axis
.Categories(model => model.Day)
)
)
Type(Kendo.Mvc.UI.ChartCategoryAxisType)
Overrides the category axis type.
Parameters
type - ChartCategoryAxisType
The axis type. The default is determined by the category items type.
Example
@(Html.Kendo().Chart()
.Name("chart")
.CategoryAxis(axis => axis.Type(ChartCategoryAxisType.Date))
)
Categories(System.Collections.IEnumerable)
Defines categories.
Parameters
categories - System.Collections.IEnumerable
The list of categories
Example
@(Html.Kendo().Chart()
.Name("Chart")
.CategoryAxis(axis => axis
.Categories(Model.Categories)
)
)
Categories(System.String[])
Defines categories.
Parameters
categories - System.String[]
The list of categories
Example
@(Html.Kendo().Chart(Model)
.Name("chart")
.Series(series =>
{
series.Column(new double[] { 1.988, 2.733, 3.994 }).Name("World");
})
.CategoryAxis(axis => axis
.Categories("2002", "2003", "2004")
)
)
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.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.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.AxisCrossingValue(new double[] { 0, 10 }))
.ValueAxis(axis => axis.Numeric().Title("Axis 1"))
.ValueAxis(axis => axis.Numeric("secondary").Title("Axis 2"))
)
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.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.Justify(true))
)
Select(System.Double,System.Double)
Sets the selection range
Parameters
from - System.Double
The selection range start.
to - System.Double
The selection range end. Note: The category with the specified index 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 category index.
Example
@(Html.Kendo().Chart(Model)
.Name("Chart")
.CategoryAxis(axis => axis.Select(0, 3))
)
Select(System.Action)
Configures the selection
Parameters
configurator - System.Action<ChartAxisSelectionBuilder>
The configuration action.
Example
@(Html.Kendo().Chart(Model)
.Name("StockChart")
.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);
})
)
)
)
Min(System.Double)
Sets the minimum value.
Parameters
value - System.Double
Example
@(Html.Kendo().Chart()
.Name("chart")
.CategoryAxis(axis => axis
.Categories("2002", "2003", "2004", "2005", "2006").Min(2)
)
)
Max(System.Double)
Sets the maximum value.
Parameters
value - System.Double
Example
@(Html.Kendo().Chart()
.Name("chart")
.CategoryAxis(axis => axis
.Categories("2002", "2003", "2004", "2005", "2006").Max(5)
)
)
MaxDivisions(System.Double)
The maximum number of ticks and labels to display.
Parameters
value - System.Double
The value for MaxDivisions
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.Action)
Configures the axis labels.
Parameters
configurator - System.Action<ChartAxisLabelsBuilder>
The configuration action.
Example
@(Html.Kendo().Chart()
.Name("Chart")
.CategoryAxis(axis => axis
.Labels(labels => labels
.Color("Red")
.Visible(true)
)
)
)
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)
)
)
)