Class AxisX

This class represents horizontal Chart Axis.

Inheritance
System.Object
Axis
AxisX
Inherited Members
Namespace: Telerik.Windows.Controls.Charting
Assembly: Telerik.Windows.Controls.Charting.dll

Syntax

public class AxisX : Axis, ILogicalItem, IDataAxis, INotifyPropertyChanged

Constructors

AxisX()

Initializes a new instance of the AxisX class.

Declaration
public AxisX()

Fields

IsDateTimeProperty

Identifies the IsDateTime dependency property.

Declaration
public static readonly DependencyProperty IsDateTimeProperty
Field Value
System.Windows.DependencyProperty

LayoutModeProperty

Identifies the LayoutMode dependency property.

Declaration
public static readonly DependencyProperty LayoutModeProperty
Field Value
System.Windows.DependencyProperty

ShouldRoundMinValueOnZoomProperty

Identifies the ShouldRoundMinValueOnZoom dependency property.

Declaration
public static readonly DependencyProperty ShouldRoundMinValueOnZoomProperty
Field Value
System.Windows.DependencyProperty

ShouldScaleStepOnZoomProperty

Identifies the ShouldScaleStepOnZoom dependency property.

Declaration
public static readonly DependencyProperty ShouldScaleStepOnZoomProperty
Field Value
System.Windows.DependencyProperty

TicksDistanceProperty

Identifies the TicksDistance dependency property.

Declaration
public static readonly DependencyProperty TicksDistanceProperty
Field Value
System.Windows.DependencyProperty

Properties

IsDateTime

Gets or sets the value indicating whether DateTime values are used.

Declaration
public bool IsDateTime { get; set; }
Property Value
System.Boolean

The value.

LabelStep

Gets or sets the label step.

Declaration
public int LabelStep { get; set; }
Property Value
System.Int32

The label step.
Implements

LayoutMode

Gets or sets the AxisLayoutMode used.

Declaration
public AxisLayoutMode LayoutMode { get; set; }
Property Value
AxisLayoutMode

The value.

ShouldRoundMinValueOnZoom

Gets or sets a value indicating whether the axis MinValue should be rounded or not whenever zooming action occurs.

Declaration
public bool ShouldRoundMinValueOnZoom { get; set; }
Property Value
System.Boolean

Remarks

The default value is false (i.e. it will not be rounded). This property is applicable only for scenarios with manual axis range and is generally combined with AxisX.ShouldRoundMinValueOnZoom property in order to achieve constant mapping between series items and axis ticks in zoom / scroll scenarios (set ShouldScaleStepOnZoom = false and ShouldRoundMinValueOnZoom = true).

ShouldScaleStepOnZoom

Gets or sets a value indicating whether the axis step value should be preserved or scaled down whenever zooming action occurs.

Declaration
public bool ShouldScaleStepOnZoom { get; set; }
Property Value
System.Boolean

Remarks

The default value is true (i.e. the step will be scaled down). This property is applicable only for scenarios with manual axis range and is generally combined with AxisX.ShouldRoundMinValueOnZoom property in order to achieve constant mapping between series items and axis ticks in zoom / scroll scenarios (set ShouldScaleStepOnZoom = false and ShouldRoundMinValueOnZoom = true).

StepLabelLevelCount

Gets or sets the number of levels (steps) that will be used to distribute the axis item labels.

Declaration
public int StepLabelLevelCount { get; set; }
Property Value
System.Int32

Implements
Remarks

If you set this property to 2, the first item label will be placed on first level, the second - on second level, the third - on the first level, etc.

StepLabelLevelHeight

Gets or sets the height of each step label level (row).

Declaration
public int StepLabelLevelHeight { get; set; }
Property Value
System.Int32

Implements

TicksDistance

Gets or sets the minimum ticks distance on the X axis.

Declaration
public int TicksDistance { get; set; }
Property Value
System.Int32

The ticks distance.

Methods

Calculate2DMaxItemsCount()

Calculates the max items count for 2D axis.

Declaration
protected override int Calculate2DMaxItemsCount()
Returns
System.Int32

Overrides

ConvertPhysicalUnitsToData(Double)

Converts physical pixels to data units.

Declaration
public override double ConvertPhysicalUnitsToData(double inputValue)
Parameters
System.Double inputValue

The input value.
Returns
System.Double

Returns data units measured by the current axis.
Overrides

InitializeAxisValuesForAutoRange()

Initializes the axis values (MinValue, MaxValue, Step) when AutoRange is enabled.

Declaration
protected override void InitializeAxisValuesForAutoRange()
Overrides

UpdateAxisValuesOnZoom(ref Double, ref Double, ref Double)

Updates the axis values on zoom in scenarios with manual axis range.

Declaration
protected override void UpdateAxisValuesOnZoom(ref double minValue, ref double maxValue, ref double step)
Parameters
System.Double minValue

The min value.
System.Double maxValue

The max value.
System.Double step

The step.
Overrides

Explicit Interface Implementations

IDataAxis.EffectiveLayoutMode

Declaration
AxisLayoutMode IDataAxis.EffectiveLayoutMode { get; }
Returns
AxisLayoutMode

Implements

IDataAxis.ItemOverlapFactor

Declaration
double IDataAxis.ItemOverlapFactor { get; }
Returns
System.Double

Implements

IDataAxis.ItemWidthFactor

Declaration
double IDataAxis.ItemWidthFactor { get; }
Returns
System.Double

Implements

Extension Methods