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

Telerik.Charting.ChartYAxis

Represents a chart Y Axis.

Inheritance Hierarchy

  • System.Object
  • Telerik.Charting.StateManagedObject : IChartingStateManagedItem, IChartingStateManager, IDisposable
  • Telerik.Charting.RenderedObject : IOrdering
  • Telerik.Charting.ChartAxis
  • Telerik.Charting.ChartYAxis

Properties

Appearance StyleAxis

ChartAxis style

AutoScale Boolean

Enables or disables automatic axis scaling.

AxisLabel ChartLabel

ChartAxis label

AxisMode ChartYAxisMode

Gets or sets the style of the Y axis.

AxisType ChartAxisType

Gets the axis type: Y or Y2 axes

AxisType ChartAxisType

Gets the axis type: X, Y and Y2 axis

Chart Chart

Reference to a Chart class instance

Container IContainer

Link to container element

EndPoint PointF

Gets or Sets the end point of axis line

IsLogarithmic Boolean

Use Logarithmic scale or not.

IsMajorTickVisible Boolean

Gets the major axis ticks visibility

IsMinorTickVisible Boolean

Gets the minor axis ticks visibility

IsParentVisible Boolean

Gets if PlotArea should be rendered or not

IsTickVisible Boolean

Gets the axis ticks visibility

IsZeroBased Boolean

Specifies whether the axis begins from 0.

Item ChartAxisItem

Returns the axis item at the specified position.

Items ChartAxisItem

Returns a collection of axis items.

ItemsBound Single

Max axis item coordinate (X or Y). Farther value.

ItemsBound Single

Gets the larger value of axis items dimensions: height or width

LabelStep Double

Draw each 1,2,...,n item

LogarithmBase Double

Logarithm base. Min possible value is 2

MajorPoints PointF[]

Points array for a major ticks and grid lines

MaxItemsCount ChartAxisItem

Gets or sets maximal count of the axis items when auto scaling.

MaxValue Double

Specifies the max value of the axis range.

MaxValue Double

Specifies the max value of the axis range.

MinorPoints PointF[]

Points array for a minor ticks and grid lines

MinValue Double

Specifies the min value of the axis range.

MinValue Double

Specifies the min value of the axis range.

Parent ChartPlotArea

Parent element (PlotArea)

PixelsPerValue Single

Pixels per axis unit.

PlotRect RectangleF

Gets the PlotArea's rectangle

ScaleBreaks ScaleBreak

Scale breaks settings

Segments AxisSegmentCollection

Segments collection

StartPoint PointF

Gets or Sets the start point of axis line

Step Double

Specifies the step at which axis values are calculated

Step Double

Specifies the step at which axis values are calculated

TicksLength Int32

Gets the longest tick length

ViewState StateBag

Sate bag to store view state content

ViewStateIgnoresCase Boolean

Gets if view sate should ignore case

Visible ChartAxisVisibility

Specifies whether the axis should be rendered.

VisibleValues ChartAxisVisibility

Determines the type of shown values

YAxisType ChartYAxisType

Defines a type of YAxis

Methods

AddItem

Adds a ChartAxisItem to the axis.

Returns

Telerik.Charting.ChartAxisItem

AddItem

Adds a ChartAxisItemsCollection to the axis.

Returns

Telerik.Charting.ChartAxisItem

AddItem

Adds ChartAxisItems to the axis.

Returns

Telerik.Charting.ChartAxisItem

AddItem

Adds ChartAxisItems to the axis.

Returns

Telerik.Charting.ChartAxisItem

AddItem

Adds a new ChartAxisItem object to the axis with the specified label and color.

Parameters

label System.String

Axis label

color System.Drawing.Color

Item text color

Returns

Telerik.Charting.ChartAxisItem

AddItem

Adds a new ChartAxisItem object to the axis with the specified label and color.

Parameters

label System.String

Axis label

color System.Drawing.Color

Item text color

visible System.Boolean

Visibility

Returns

Telerik.Charting.ChartAxisItem

AddItem

Adds a new ChartAxisItem object to the axis with the specified label.

Parameters

label System.String

Axis label text

Returns

Telerik.Charting.ChartAxisItem

AddItem

Adds a new ChartAxisItem object to the axis with the specified label.

Parameters

label System.String

Axis label text

value System.Double

Axis item value

Returns

Telerik.Charting.ChartAxisItem

AddRange

Automatically adds new axis items in AutoScale mode.

Parameters

minValue System.Double

Min range value

maxValue System.Double

Max range value

step System.Double

Axis step value

Returns

System.Void

AdjustingMinMax

Adjusting min/max value according to the set axis properties

Parameters

minValue System.Double@

Min range value

maxValue System.Double@

Max range value

dValue System.Double

Rounding digits limit

Returns

System.Void

AutoCalcAxisExtents

Auto determines the min and max value of the axis

Returns

System.Void

BringForward

Send element at one step forward in the render order list

Returns

System.Void

BringToFront

Set element at the first position in render order list

Returns

System.Void

CalculateAxisItemsLayout

Calculates axis items layout settings

Parameters

renderEngine Telerik.Charting.RenderEngine

Render Engine reference

getItemBoundOnly System.Boolean

Should method calculate the ItemsBound value only

maxBound System.Nullable{System.Single}

Already calculated ItemsBound value

Returns

System.Void

CalculateAxisLabel

Calculates axis label's layout settings

Parameters

renderEngine Telerik.Charting.RenderEngine

RenderEngine

Returns

System.Void

CalculateGridsAndTicks

Calculates grid lines and ticks positions

Returns

System.Void

CalculateGridsAndTicks

Calculates grid lines and ticks positions

Returns

System.Void

CalculateLayout

Calculates axis layout settings

Parameters

renderEngine Telerik.Charting.RenderEngine

Render Engine reference

Returns

System.Void

CalculateLayout

Calculates axis layout settings

Parameters

renderEngine Telerik.Charting.RenderEngine

RenderEngine

Returns

System.Void

CalculateSegmentsPosition

Calculates segments positions

Returns

System.Void

CalculateStep

Axis Step calculation method for AutoScaled axes

Parameters

minValue System.Double@

Min range value

maxValue System.Double@

Max range value

Returns

System.Double Calculated Step value

CheckAxisItemVisibility

Checks the axis item visibility

Parameters

item Telerik.Charting.ChartAxisItem

Axis item

Returns

System.Boolean True if item should be rendered

CheckRange

Checks the range values

Parameters

minValue System.Double

Min axis value

maxValue System.Double

Max axis value

step System.Double

Axis step value

Returns

System.Void

Clear

Clears data values of the axis.

Returns

System.Void

ClearAutoPropertiesForAxisItems

Excludes the excessive serialization of axis items properties

Returns

System.Void

CloneState

Makes a view state clone

Returns

System.Web.UI.StateBag StateBag

CorrectAxisItemPosition

Used to automatically correct the axis item AlignedPosition in AutoLayout

Parameters

position Telerik.Charting.Styles.Position

Position

Returns

System.Void

CorrectAxisLabelPosition

Used to correct initial axis label AlignedPosition for AutoLayout

Parameters

position Telerik.Charting.Styles.Position

Position

Returns

System.Void

CreateSegments

Creates axis segments when Scale breaks enabled

Returns

System.Void

CreateSegmentsRenderingRegions

Creates rendering areas for a several axis segments in case of Scale breaks

Parameters

renderEngine Telerik.Charting.RenderEngine

Render Engine reference

Returns

System.Void

DisableCachedValues

Restores initial values of cached axis settings

Returns

System.Void

Dispose

Releases unmanaged and - optionally - managed resources

Parameters

disposing System.Boolean

true to release both managed and unmanaged resources; false to release only unmanaged resources.

Returns

System.Void

FormatLabel

Formats the axis item value with a selected ValueFormat value

Parameters

val System.Double

Item value

Returns

System.String Formatted string

GetAxisEndCoord

Gets the end value coordinate

Returns

System.Single Coordinate

GetAxisEndCoord

Gets the end value coordinate

Returns

System.Single Coordinate

GetAxisStartCoord

Gets the start value coordinate

Returns

System.Single Coordinate

GetAxisStartCoord

Gets the start value coordinate

Returns

System.Single Coordinate

GetClientRectangle

Gets axis image rectangle

Remarks

Used with client-zoom in ASP.NET Ajax chart

Parameters

startPoint System.Drawing.PointF

Start point

endPoint System.Drawing.PointF

End point

Returns

System.Drawing.RectangleF Rectangle

GetClientRectangle

Gets axis image rectangle

Remarks

Used with client-zoom in ASP.NET Ajax chart

Returns

System.Drawing.RectangleF Rectangle

GetClientRectangle

Gets axis image rectangle

Remarks

Used with client-zoom in ASP.NET Ajax chart

Parameters

startPoint System.Drawing.PointF

Start point

endPoint System.Drawing.PointF

End point

Returns

System.Drawing.RectangleF Rectangle

GetClientRectangle

Gets axis image rectangle

Remarks

Used with client-zoom in ASP.NET Ajax chart

Returns

System.Drawing.RectangleF Rectangle

GetCoordinate

Gets value coordinate at axis

Parameters

val System.Double

Value

Returns

System.Single Coordinate

GetCoordinate

Gets value coordinate at axis

Parameters

val System.Double

Value

Returns

System.Single Coordinate

GetCoordinate

Gets value coordinate at axis

Parameters

val System.Double

Value

pixelsPerVal System.Single

Pixels per value

roundCoord System.Boolean

Make a coordinate value rounding or not

Returns

System.Single Coordinate

GetDistance

Gets distance between points

Parameters

point1 System.Drawing.PointF

First point

point2 System.Drawing.PointF

Second point

Returns

System.Single Distance

GetFirstItemHalfDimension

Gets the half of the first axis item's largest dimension

Returns

System.Single Half of the largest dimension

GetFirstItemHalfDimension

Gets the half of the first axis item's largest dimension

Returns

System.Single Half of the largest dimension

GetHeight

Gets the largest axis item height

Returns

System.Single Height value

GetItem

Gets the item at the specified index.

Returns

Telerik.Charting.ChartAxisItem

GetItemsBound

Gets the axis item's max bound: horizontally or vertically

Parameters

item Telerik.Charting.ChartAxisItem

Axis item

rotationAngle System.Single

Rotation angle's value

Returns

System.Single Max bound value

GetLastItemHalfDimension

Gets the half of the last axis item's largest dimension

Returns

System.Single Half of the largest dimension

GetLastItemHalfDimension

Gets the half of the last axis item's largest dimension

Returns

System.Single Half of the largest dimension

GetMaxItemBound

Gets the larger value of axis items dimensions: height or width

Returns

System.Single

GetOrder

Get this elements order position in container

Returns

System.Int32

GetPixelStep

Gets pixels between two axis items

Parameters

itemValue System.Decimal

Axis item value. Can be used to detect if value is located in the any axis segment

Returns

System.Single Distance in pixels

GetWidth

Gets the largest axis item width

Returns

System.Single Width value

GetZeroCoordinate

Gets the coordinate of zero value

Returns

System.Single Coordinate

GetZeroCoordinate

Gets the coordinate of zero value

Returns

System.Single Coordinate

GetZeroValue

Return the base value of the axis.

Returns

System.Double Axis zero value

GetZeroValue

Return the base value of the axis.

Returns

System.Double Axis zero value

Initialize

Initializes the axis with min and max values.

Returns

System.Void

Initialize

Initializes the axis with min and max values.

Returns

System.Void

InitializeItems

Initialize axis items collection in dependency of series items collection values limits

Returns

System.Void

InitializeItems

Initialize the axis items collection

Returns

System.Void

InitializeSegments

Makes preparations for an axis segmentation in case of Scale Breaks enabled

Returns

System.Void

IsVisible

Checks the axis item visibility

Returns

System.Boolean The Boolean value

LoadViewState

Loads Y axis settings from view state

Parameters

savedState System.Object

View state

Returns

System.Void

LoadViewState

Loading ViewState data

Parameters

savedState System.Object

Saved state bag

Returns

System.Void

LoadViewState

Loads data from a view state

Parameters

state System.Object

View state to load data from

Returns

System.Void

OnRender

Called after rendering

Returns

System.Void

OptimizeSegments

Replaces overlapped segments with one segment

Parameters

LocalSegments Telerik.Charting.AxisSegmentCollection

Calculated segments

items Telerik.Charting.ChartSeriesItemsCollection

Series items

Returns

Telerik.Charting.AxisSegmentCollection Optimized axis segments collection without overlapped segments

Remove

Remove this element from render order list

Returns

System.Void

RemoveAllItems

Removes all items

Returns

System.Void

RemoveItem

Removes the ChartAxisItem specified.

Returns

System.Void

RemoveItem

Removes the ChartAxisItems at the specified indexes.

Returns

System.Void

RemoveItem

Removes the ChartAxisItem at the specified index.

Parameters

itemIndex System.Int32

item's index

Returns

System.Void

RemoveLastItem

Removes the last item from the axis.

Returns

System.Void

ResetMaxValue

Resets the MaxValue to default

Returns

System.Void

ResetMinValue

Resets the MinValue to default

Returns

System.Void

ResetStep

Resets the Step value to default

Returns

System.Void

RestoreLabelPosition

Restores the initial axis label and common axis items positions settings

Returns

System.Void

SaveLabelPosition

Saves the initial axis label and common axis items positions settings

Returns

System.Void

SaveViewState

Saves axis settings to a state bag

Returns

System.Object

SaveViewState

Saves data to a State Bag

Returns

System.Object Saved axis data to a state bag

SaveViewState

Saves object data to a view state

Returns

System.Object Saved view state object

SendBackward

Send element at one step back in the render order list

Returns

System.Void

SendToBack

Send element at the end of render order list

Returns

System.Void

SetDirty

Sets the item dirty state

Returns

System.Void

SetItemColor

Sets new color for the axis item text at the specified position.

Parameters

itemIndex System.Int32

Item index in collection

newColor System.Drawing.Color

Item text color

Returns

System.Void

SetItemLabel

Sets new label text for the axis item at the specified position.

Parameters

itemIndex System.Int32

Item index in collection

newLabelText System.String

Axis item label text

Returns

System.Void

SetItemLabel

Sets new label for the axis item at the specified position.

Parameters

itemIndex System.Int32

Item index in collection

newLabel Telerik.Charting.ChartAxisItem

Axis item

Returns

System.Void

SetMaxValue

Sets the maximum axis range value

Parameters

maxValue System.Double

Value to set

Returns

System.Void

SetMinValue

Sets the min axis range value

Parameters

minValue System.Double

Value to set

Returns

System.Void

SetOrder

Set this object in new render order position

Parameters

index System.Int32

New position

Returns

System.Void

SetPositiveOrNegative

Sets the minimum and maximum axis range values

Parameters

minValue System.Double@

Min range value

maxValue System.Double@

Max range value

Returns

System.Void

SetRange

Recalculates items values in collection

Returns

System.Void

ShouldSerializeMaxValue

The axis MaxValue design time serialization reason

Returns

System.Boolean True is value have to be serialized

ShouldSerializeMinValue

The axis MinValue design time serialization reason

Returns

System.Boolean True is value have to be serialized

ShouldSerializeStep

The axis Step design time serialization reason

Returns

System.Boolean True is value have to be serialized

Telerik.Charting.IChartingStateManager.LoadViewState

Loads data from a view state

Parameters

state System.Object

View state to load data from

Returns

System.Void

Telerik.Charting.IChartingStateManager.SaveViewState

Saves object data to a view state

Returns

System.Object Saved view state object

Telerik.Charting.IChartingStateManager.TrackViewState

Tracks view state changes

Returns

System.Void

TrackViewState

Tracks view state changes

Returns

System.Void

TrackViewState

Tracking ViewState

Returns

System.Void

TrackViewState

Tracks view state changes

Returns

System.Void

In this article