Class
CartesianAxis

Provides the abstract base class for axes used in Cartesian coordinate systems, supporting positioning and scale break functionality.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.ChartView.dll

Syntax:

cs-api-definition
public abstract class CartesianAxis : LineAxis, IDisposable, INotifyPropertyChanged, ICustomTypeDescriptor, IChartElementPresenter, IStylableElement, IStylableNode, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IShapedElement

Inheritance: objectDisposableObjectRadObjectUIChartElementAxisLineAxisCartesianAxis

Derived Classes: CategoricalAxisDateTimeContinuousAxisNumericalAxis

Implements: IBorderElementIBoxElementIBoxStyleIChartElementPresenterICustomTypeDescriptorIDisposableIFillElementINotifyPropertyChangedIShapedElementIStylableElementIStylableNode

Inherited Members LineAxis.IsInversePropertyLineAxis.OnPropertyChanged(RadPropertyChangedEventArgs)LineAxis.IsInverseAxis.LabelFitModePropertyAxis.LabelFormatPropertyAxis.LabelIntervalPropertyAxis.LabelOffsetPropertyAxis.LabelRotationAnglePropertyAxis.LastLabelVisibilityPropertyAxis.MajorTickOffsetPropertyAxis.ShowLabelsPropertyAxis.TickLengthPropertyAxis.TickWidthPropertyAxis.TitlePropertyAxis.MeasureContentOverride(ChartNode, object)Axis.MeasureLabel(ChartNode, object)Axis.GetLabelCacheKey(AxisLabelModel)Axis.MeasureTitle(object)Axis.BuildVisualState()Axis.ToString()Axis.CreateLabelElement(AxisLabelModel)Axis.IsPrimaryAxis.LabelFitModeAxis.LabelFormatAxis.LabelFormatProviderAxis.LabelIntervalAxis.LabelOffsetAxis.LabelRotationAngleAxis.LastLabelVisibilityAxis.LineWidthAxis.MajorTickOffsetAxis.ShowLabelsAxis.TickLengthAxis.TickWidthAxis.TitleAxis.TitleElementAxis.AxisTypeAxis.ModelAxis.EnableElementCacheUIChartElement.IsVisiblePropertyUIChartElement.ClassPropertyUIChartElement.VisualStatePropertyUIChartElement.IsMouseDownPropertyUIChartElement.IsMouseOverPropertyUIChartElement.FontPropertyUIChartElement.CustomFontPropertyUIChartElement.CustomFontSizePropertyUIChartElement.CustomFontStylePropertyUIChartElement.ForeColorPropertyUIChartElement.BackColorPropertyUIChartElement.BackColor2PropertyUIChartElement.BackColor3PropertyUIChartElement.BackColor4PropertyUIChartElement.NumberOfColorsPropertyUIChartElement.GradientStylePropertyUIChartElement.GradientAnglePropertyUIChartElement.GradientPercentagePropertyUIChartElement.GradientPercentage2PropertyUIChartElement.BorderBoxStylePropertyUIChartElement.BorderDrawModePropertyUIChartElement.BorderWidthPropertyUIChartElement.BorderLeftWidthPropertyUIChartElement.BorderRightWidthPropertyUIChartElement.BorderTopWidthPropertyUIChartElement.BorderBottomWidthPropertyUIChartElement.BorderGradientAnglePropertyUIChartElement.BorderGradientStylePropertyUIChartElement.BorderColorPropertyUIChartElement.BorderColor2PropertyUIChartElement.BorderColor3PropertyUIChartElement.BorderColor4PropertyUIChartElement.BorderInnerColorPropertyUIChartElement.BorderInnerColor2PropertyUIChartElement.BorderInnerColor3PropertyUIChartElement.BorderInnerColor4PropertyUIChartElement.BorderLeftColorPropertyUIChartElement.BorderTopColorPropertyUIChartElement.BorderRightColorPropertyUIChartElement.BorderBottomColorPropertyUIChartElement.BorderLeftShadowColorPropertyUIChartElement.BorderTopShadowColorPropertyUIChartElement.BorderRightShadowColorPropertyUIChartElement.BorderBottomShadowColorPropertyUIChartElement.BackgroundShapePropertyUIChartElement.BorderDashStylePropertyUIChartElement.BorderDashPatternPropertyUIChartElement.BorderCornerRadiusPropertyUIChartElement.ShapePropertyUIChartElement.PaddingPropertyUIChartElement.SmoothingModePropertyUIChartElement.GetValue(RadProperty)UIChartElement.Attach(UIChartElement)UIChartElement.Dettach()UIChartElement.Refresh()UIChartElement.Invalidate()UIChartElement.DpiScaleChanged(SizeF)UIChartElement.GetScaledFont(float)UIChartElement.GetCurrentShape()UIChartElement.GetThemeEffectiveType()UIChartElement.ApplyStyleSettingsCore(PropertySettingGroup)UIChartElement.ApplyStyle()UIChartElement.AddStylePropertySetting(IPropertySetting)UIChartElement.ApplyStyleByIndex(PropertySettingGroup, int)UIChartElement.ParentUIChartElement.LevelUIChartElement.ChildrenUIChartElement.IsMouseDownUIChartElement.IsMouseOverUIChartElement.ViewUIChartElement.IsVisibleUIChartElement.ForeColorUIChartElement.FontUIChartElement.BackColorUIChartElement.BackColor2UIChartElement.BackColor3UIChartElement.BackColor4UIChartElement.GradientStyleUIChartElement.GradientAngleUIChartElement.GradientPercentageUIChartElement.GradientPercentage2UIChartElement.NumberOfColorsUIChartElement.BorderLeftColorUIChartElement.BorderTopColorUIChartElement.BorderRightColorUIChartElement.BorderBottomColorUIChartElement.BorderLeftShadowColorUIChartElement.BorderTopShadowColorUIChartElement.BorderRightShadowColorUIChartElement.BorderBottomShadowColorUIChartElement.BorderBoxStyleUIChartElement.BorderDrawModeUIChartElement.BorderWidthUIChartElement.BorderLeftWidthUIChartElement.BorderTopWidthUIChartElement.BorderRightWidthUIChartElement.BorderBottomWidthUIChartElement.BorderGradientAngleUIChartElement.BorderGradientStyleUIChartElement.BorderColorUIChartElement.BorderColor2UIChartElement.BorderColor3UIChartElement.BorderColor4UIChartElement.BorderInnerColorUIChartElement.BorderInnerColor2UIChartElement.BorderInnerColor3UIChartElement.BorderInnerColor4UIChartElement.BorderDashStyleUIChartElement.BorderDashPatternUIChartElement.BorderCornerRadiusUIChartElement.SizeUIChartElement.ShapeUIChartElement.BackgroundShapeUIChartElement.PaddingUIChartElement.SmoothingModeUIChartElement.IsAttachedUIChartElement.DpiScaleFactorUIChartElement.ClassUIChartElement.VisualStateUIChartElement.ThemeRoleUIChartElement.ChildrenHierarchyUIChartElement.StyleUIChartElement.StateManagerUIChartElement.FallbackToDefaultThemeRadObject.BindingContextPropertyRadObject.RadTypeRadObject.ReplaceDefaultDescriptors(PropertyDescriptorCollection)RadObject.DisposeManagedResources()RadObject.ClearPropertyStore()RadObject.SuspendPropertyNotifications()RadObject.ResumePropertyNotifications()RadObject.GetPropertyValue(RadProperty)RadObject.SetDefaultValueOverride(RadProperty, object)RadObject.SetValue(RadProperty, object)RadObject.ResetValue(RadProperty)RadObject.ResetLocalValue(RadProperty)RadObject.ResetValue(RadProperty, ValueResetFlags)RadObject.UpdateValue(RadProperty)RadObject.GetValueSource(RadProperty)RadObject.GetRegisteredRadProperty(string)RadObject.UpdateValueCore(RadPropertyValue)RadObject.SetValueCore(RadPropertyValue, object, object, ValueSource)RadObject.ResetValueCore(RadPropertyValue, ValueResetFlags)RadObject.GetDefaultValue(RadPropertyValue, object)RadObject.CoerceValue(RadPropertyValue, object)RadObject.ShouldSerializeProperty(RadProperty)RadObject.CanRaisePropertyChangeNotifications(RadPropertyValue)RadObject.BindProperty(RadProperty, RadObject, RadProperty, PropertyBindingOptions)RadObject.UnbindProperty(RadProperty)RadObject.GetInheritedValue(RadProperty)RadObject.OnPropertyChanging(RadPropertyChangingEventArgs)RadObject.OnNotifyPropertyChanged(string)RadObject.OnShouldSerializeProperty(ShouldSerializePropertyEventArgs)RadObject.IsPropertyCancelable(RadPropertyMetadata)RadObject.PropertyValuesRadObject.PropertyFilterRadObject.RadObjectTypeRadObject.BindingContextRadObject.PropertyChangedRadObject.RadPropertyChangedRadObject.RadPropertyChangingDisposableObject.GetBitState(long)DisposableObject.SetBitState(long, bool)DisposableObject.OnBitStateChanged(long, bool, bool)DisposableObject.Dispose()DisposableObject.Dispose(bool)DisposableObject.PerformDispose(bool)DisposableObject.DisposeUnmanagedResources()DisposableObject.BitStateDisposableObject.EventsDisposableObject.IsDisposingDisposableObject.IsDisposedDisposableObject.DisposedDisposableObject.Disposing

Constructors

CartesianAxis()

Initializes a new instance of the CartesianAxis class.

Declaration

cs-api-definition
public CartesianAxis()

Fields

AutomaticBorderColorProperty

Identifies the AutomaticBorderColor dependency property.

Declaration

cs-api-definition
public static RadProperty AutomaticBorderColorProperty

Field Value

RadProperty

IsMultiAxisProperty

Identifies the IsMultiAxis dependency property.

Declaration

cs-api-definition
public static RadProperty IsMultiAxisProperty

Field Value

RadProperty

Properties

AutomaticBorderColor

Gets or sets a value indicating whether the color of the axis and series will be synchronized when in multi-axis mode.

Declaration

cs-api-definition
public bool AutomaticBorderColor { get; set; }

Property Value

bool

true if color is taken from the series; otherwise, false.

ClipLabels

Gets or sets a value indicating whether axis labels will be clipped to the axis width for horizontal axes and the axis height for vertical axes.

Declaration

cs-api-definition
public bool ClipLabels { get; set; }

Property Value

bool

HasScaleBreaks

Gets a value indicating whether the axis has scale breaks added to it.

Declaration

cs-api-definition
public bool HasScaleBreaks { get; }

Property Value

bool

HorizontalLocation

Gets or sets the horizontal location of the axis in relation to the plot area.

Declaration

cs-api-definition
public AxisHorizontalLocation HorizontalLocation { get; set; }

Property Value

AxisHorizontalLocation

IsMultiAxis

Gets a value indicating whether this axis is part of a vertical or horizontal multi-axis layout.

Declaration

cs-api-definition
public bool IsMultiAxis { get; }

Property Value

bool

true if this axis is part of a multi-axis chart; otherwise, false.

ScaleBreakBackColor

Gets or sets the back color of the scale breaks of this axis.

Declaration

cs-api-definition
public Color ScaleBreakBackColor { get; set; }

Property Value

Color

ScaleBreakBorderColor

Gets or sets the border color of the scale breaks of this axis.

Declaration

cs-api-definition
public Color ScaleBreakBorderColor { get; set; }

Property Value

Color

ScaleBreakSize

Gets or sets the size of the gap drawn for each of the scale breaks of this axis.

Declaration

cs-api-definition
public double ScaleBreakSize { get; set; }

Property Value

double

ScaleBreakStyle

Gets or sets the style of the scale breaks of this axis.

Declaration

cs-api-definition
public ScaleBreakStyle ScaleBreakStyle { get; set; }

Property Value

ScaleBreakStyle

ScaleBreaks

Allows adding and removing scale breaks to this axis.

Declaration

cs-api-definition
public AxisScaleBreakCollection ScaleBreaks { get; }

Property Value

AxisScaleBreakCollection

StartPositionAxis

Gets or sets the axis used to determine the start position alignment for this axis.

Declaration

cs-api-definition
public Axis StartPositionAxis { get; set; }

Property Value

Axis

StartPositionValue

Gets or sets the value of the StartPositionAxis where this axis should be aligned.

Declaration

cs-api-definition
public object StartPositionValue { get; set; }

Property Value

object

VerticalLocation

Gets or sets the vertical location of the axis in relation to the plot area.

Declaration

cs-api-definition
public AxisVerticalLocation VerticalLocation { get; set; }

Property Value

AxisVerticalLocation

Methods

GetLocationOfValue(object)

Gets the location in pixels for the given value along the axis, accounting for whether the axis is vertical or horizontal.

Declaration

cs-api-definition
public abstract double GetLocationOfValue(object value)

Parameters

value

object

A value from the axis values range.

Returns

double

The location in pixels.

OnAttached(UIChartElement)

Called when the axis is attached to a parent element.

Declaration

cs-api-definition
protected override void OnAttached(UIChartElement parent)

Parameters

parent

UIChartElement

The parent chart element.

Overrides Axis.OnAttached(UIChartElement)

OnDettached()

Called when the axis is detached from its parent element.

Declaration

cs-api-definition
protected override void OnDettached()

Overrides Axis.OnDettached()

OnNotifyPropertyChanged(PropertyChangedEventArgs)

Raises the standard .NET PropertyChanged event.

Declaration

cs-api-definition
protected override void OnNotifyPropertyChanged(PropertyChangedEventArgs e)

Parameters

e

PropertyChangedEventArgs

The property changed event arguments.

Overrides RadObject.OnNotifyPropertyChanged(PropertyChangedEventArgs)

SyncVisualSettings()

Synchronizes the visual settings of the first series plotted upon this axis with the axis visual properties.

Declaration

cs-api-definition
protected virtual void SyncVisualSettings()