Class
RadDataBarBase

The base class for RadDataBars implementing common properties and logic.

Definition

Namespace:Telerik.Windows.Controls

Assembly:Telerik.Windows.Controls.DataVisualization.dll

Syntax:

cs-api-definition
public abstract class RadDataBarBase : Control

Inheritance: objectRadDataBarBase

Derived Classes: RadDataBarRadStackedDataBar

Constructors

RadDataBarBase()

Initializes a new instance of the RadDataBarBase class.

Declaration

cs-api-definition
protected RadDataBarBase()

Fields

AppliedAxisMarginProperty

Identifies the AppliedAxisMargin dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty AppliedAxisMarginProperty

Field Value

DependencyProperty

AppliedAxisVisibilityProperty

Identifies the AppliedAxisVisibility dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty AppliedAxisVisibilityProperty

Field Value

DependencyProperty

AxisStrokeProperty

Identifies the AxisStroke dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty AxisStrokeProperty

Field Value

DependencyProperty

AxisStyleProperty

Identifies the AxisStyle dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty AxisStyleProperty

Field Value

DependencyProperty

AxisVisibilityProperty

Identifies the AxisVisibility dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty AxisVisibilityProperty

Field Value

DependencyProperty

BarBorderThicknessProperty

Identifies the BarBorderThickness dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty BarBorderThicknessProperty

Field Value

DependencyProperty

BarHeightPercentProperty

Identifies the BarHeightPercent dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty BarHeightPercentProperty

Field Value

DependencyProperty

BarStyleProperty

Identifies the BarStyle dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty BarStyleProperty

Field Value

DependencyProperty

MaximumProperty

Identifies the Maximum dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty MaximumProperty

Field Value

DependencyProperty

MinimumProperty

Identifies the Minimum dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty MinimumProperty

Field Value

DependencyProperty

OriginValueProperty

Identifies the OriginValue dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty OriginValueProperty

Field Value

DependencyProperty

OverflowTemplateProperty

Identifies the OverflowTemplate dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty OverflowTemplateProperty

Field Value

DependencyProperty

UnderflowTemplateProperty

Identifies the UnderflowTemplate dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty UnderflowTemplateProperty

Field Value

DependencyProperty

Properties

AppliedAxisMargin

Gets the Margin that is actually applied to the axis.

Declaration

cs-api-definition
public Thickness AppliedAxisMargin { get; }

Property Value

Thickness

Remarks

This property is set internally depending on the Minimum, Maximum, OriginValue properties and the ActualWidth of the data bar.

AppliedAxisVisibility

Gets the visibility that is actually applied to the axis.

Declaration

cs-api-definition
public Visibility AppliedAxisVisibility { get; }

Property Value

Visibility

Remarks

This property is set internally depending on the AxisVisibility property and whether the OriginValue is between the Minimum and Maximum.

AxisStroke

Gets or sets the stroke of the axis, which is positioned vertically at the origin value.

Declaration

cs-api-definition
public Brush AxisStroke { get; set; }

Property Value

Brush

AxisStyle

Gets or sets the style that is applied to the axis.

Declaration

cs-api-definition
public Style AxisStyle { get; set; }

Property Value

Style

Remarks

The axis is the vertical line positioned at the origin value.

AxisVisibility

Gets or sets the visibility of the axis, which is positioned vertically at the origin value.

Declaration

cs-api-definition
public Visibility AxisVisibility { get; set; }

Property Value

Visibility

BarBorderThickness

Gets or sets the Stroke of the DataBarShape.

Declaration

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

Property Value

double

BarHeightPercent

Gets or sets the height percent (from 0 to 1) of the bar shape.

Declaration

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

Property Value

double

BarStyle

Gets or sets the style that is applied to the DataBarShape.

Declaration

cs-api-definition
public Style BarStyle { get; set; }

Property Value

Style

Maximum

Gets or sets the Maximum.

Declaration

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

Property Value

double

Minimum

Gets or sets the Minimum.

Declaration

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

Property Value

double

OriginValue

Gets or sets the origin value.

Declaration

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

Property Value

double

OverflowTemplate

Gets or sets the OverflowTemplate. This is used to denote that (and is shown only if) the value (in DataBar) or the positive sum (in StackedDataBar) is greater than the specified Maximum.

Declaration

cs-api-definition
public DataTemplate OverflowTemplate { get; set; }

Property Value

DataTemplate

UnderflowTemplate

Gets or sets the UnderflowTemplate. This is used to denote that (and is shown only if) the value (in DataBar) or the negative sum (in StackedDataBar) is less than the specified Minimum.

Declaration

cs-api-definition
public DataTemplate UnderflowTemplate { get; set; }

Property Value

DataTemplate

Methods

MeasureOverride(Size)

Overrides the Measure pass to define a specific behavior for measuring.

Declaration

cs-api-definition
protected override Size MeasureOverride(Size availableSize)

Parameters

availableSize

Size

Returns

Size

NormalizeAndCoerceValue(double)

Normalizes the value in correspondence to the minimum and maximum and coerces it to be a number between 0 and 1.

Declaration

cs-api-definition
protected double NormalizeAndCoerceValue(double value)

Parameters

value

double

The value that is to be normalized and coerced.

Returns

double

The coerced normalized value.

Remarks

For instance the normalized value of 1120 is 1.0 if the minimum is 1000 and maximum is 1100. The normalized value of 1000 is 0.0 if the minimum is 2000 and maximum is 3000.

NormalizeValue(double)

Normalizes the value in correspondence to the Minimum and Maximum.

Declaration

cs-api-definition
protected double NormalizeValue(double value)

Parameters

value

double

The value that is to be normalized.

Returns

double

The normalized value.

Remarks

For example, the normalized value of 140 is 0.4 if the minimum is 100 and maximum is 200. The normalized value of 1120 is 1.2 if the minimum is 1000 and maximum is 1100.

OnMaximumPropertyChanged(DependencyPropertyChangedEventArgs)

Called when the Maximum has changed.

Declaration

cs-api-definition
protected virtual void OnMaximumPropertyChanged(DependencyPropertyChangedEventArgs e)

Parameters

e

DependencyPropertyChangedEventArgs

The DependencyPropertyChangedEventArgs instance containing the event data.

OnMinimumPropertyChanged(DependencyPropertyChangedEventArgs)

Called when the Minimum has changed.

Declaration

cs-api-definition
protected virtual void OnMinimumPropertyChanged(DependencyPropertyChangedEventArgs e)

Parameters

e

DependencyPropertyChangedEventArgs

The DependencyPropertyChangedEventArgs instance containing the event data.

OnOriginValuePropertyChanged(DependencyPropertyChangedEventArgs)

Called when the OriginValue has changed.

Declaration

cs-api-definition
protected virtual void OnOriginValuePropertyChanged(DependencyPropertyChangedEventArgs e)

Parameters

e

DependencyPropertyChangedEventArgs

The DependencyPropertyChangedEventArgs instance containing the event data.

UpdateOutOfRangeTemplates()

Called when the visibility of the out-of-range templates should be updated.

Declaration

cs-api-definition
protected virtual void UpdateOutOfRangeTemplates()