Edit this page

Properties

This topic aims to get you familiar with the specific properties of each databar type.

DataBinding

  • Value (a property of RadDataBar) - expects a value which will be used to determine the size of the bar.

  • ValuePath (a property of RadStackedDataBar and RadStacked100DataBar) - expects the name of the property from the underlying data item, which will determine the value of each bar in the stack.

RadDataBar

  • BarHeightPercent - specifies the height in percent for the bar to be displayed. For example a value of 0.5 will mean that the Bar will take 50% of the available space and there will be 25% available space on top and 25% on bottom.

  • LabelPosition - It's an enum with several options that you may choose from: Left, Right, EndOfBarInside or EndOfBarOutside. If LabelPosition is set to EndOfBarOutside/EndOfBarInside - the LabelDistance is the maximum distance in pixels between the bar and the textblock. If LabelPosition is set to Left/Right - LabelDistance is the margin of the text block.

  • LabelFormat - used to specify a label format expression custom numeric format string to customize the labels.

  • AxisVisibility - controls the visibility of the axis that marks the position origin value.

  • AxisStroke - sets stroke for the axis

  • LabelVisibility - controls whether the label should appear or not.

  • LabelStyle - for customization of the databar labels.

  • BorderBrush - provides a Brush to customize the border of the databar. Note that you'll also need to specify a BorderThickness.

  • ValueBrush and NegativeValueBrush - provides a Brush to customize the appearance of the positive and negative bars respectively.

  • ValueBorderBrush and NegativeValueBorderBrush - provides a Brush to customize the border of the positive and negative bars respectively.

  • ShowOutOfRangeIndicators - boolean property that controls the visibility of the out-of-range indicators. By default it's value is true. You can read more about it in our Overflow and UnderOverflow templates topic.

  • OriginValue - defines an origin for the databar to start at. For example:

    XAML

     <telerik:RadDataBar Height="20" Value="50" BorderBrush="Gray" BorderThickness="1" Margin="2" />
     <telerik:RadDataBar Height="20" Value="50" OriginValue="30" BorderBrush="Gray" BorderThickness="1" Margin="2" />
     <telerik:RadDataBar Height="20" Value="60" OriginValue="30" BorderBrush="Gray" BorderThickness="1" Margin="2" />
     <telerik:RadDataBar Height="20" Value="120" OriginValue="30" BorderBrush="Gray" BorderThickness="1" Margin="2" />
     <telerik:RadDataBar Height="20" Value="20" OriginValue="30" BorderBrush="Gray" BorderThickness="1" Margin="2" />
     <telerik:RadDataBar Height="20" Value="10" OriginValue="30" BorderBrush="Gray" BorderThickness="1" Margin="2" />
     <telerik:RadDataBar Height="20" Value="-10" OriginValue="30" BorderBrush="Gray" BorderThickness="1" Margin="2" />
     <telerik:RadDataBar Height="20" Value="-100" OriginValue="30" BorderBrush="Gray" BorderThickness="1" Margin="2" />
    

    The result is below:
    raddatabar-originvalue

RadStackedDataBar and RadStacked100DataBar

  • BarBrushes - a Brush collection that is to be used with the bars.

    The BrushCollection class is currently located in the Telerik.Windows.Controls.DataBars namespace so please mind adding a reference to it.Here's an example:

    XAML

     <telerik:RadStacked100DataBar.BarBrushes>
        <dataBars:BrushCollection>
            <SolidColorBrush Color="Red" />
            <SolidColorBrush Color="Green" />
            <SolidColorBrush Color="Blue" />
        </dataBars:BrushCollection>
     </telerik:RadStacked100DataBar.BarBrushes>
    
  • BarBorderBrushes - a Border Brush collection that is to be used with the bars.

  • ShowToolTips - controls the visibility of the tooltips.

  • ToolTipFormat - used to specify a format expression custom numeric format string to customize the tooltips.

  • AxisVisibility - controls the visibility of the axis that will appear at the start of the first bar

  • AxisStroke - sets stroke for the axis

  • ToolTipPath - sets the name of the property from the underlying data item, which will determine what to be displayed with the tooltip.

  • ValuePath - sets the name of the property from the underlying data item, which will determine what the value of the bar is.

  • ValueBrush and NegativeValueBrush - provides a Brush to customize the appearance of the positive and negative bars respectively.

  • ValueBorderBrush and NegativeValueBorderBrush - provides a Brush to customize the border of the positive and negative bars respectively.

RadHorizontalAxis

  • LabelStep - indicates that one out of n ticks should have a label where n is the value of the property.

  • MajorTickLength - controls the size of the major ticks.

  • Minimum and Maximum - the start and end value for the axis.

  • MinorTickLength - controls the size of the minor ticks.

  • Step - indicates the step of the ticks. For instance - if the minumum is "-20" and the maximum is "10" and the step is "3" - ticks will be visualized to indicate -20, -17, -14 .. 4, 7, 10.

  • Stroke - the stroke brush for the Axis

  • TicksDistance - specifies a value indicating that every axis tick should be placed at least n pixels away from the next one, where n is the value of the property. Use when you have too much data to display on the axis to control the number of ticks shown.

    The TickDitance property has a smaller priority than Step. If both Step and TickDistance are set - the axis algorithm that distributes the ticks will only take into consideration the Step property. These two properties should not be used in conjunction.