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:

    Example 1: RadDataBar properties

         <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 like so: "xmlns:dataBars="clr-namespace:Telerik.Windows.Controls.DataBars;assembly=Telerik.Windows.Controls.DataVisualization". Here's an example:

    Example 2: RadStacked100DataBar BarBrushes property

         <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.

Was this article helpful? Yes No

Give article feedback

Tell us how we can improve this article

Dummy