IHorizBarSeries
Hierarchy Properties Methods

Type Library
TeeChartx

Description
Follow this link for a visual representation of this Series type.

The HorizBarSeries class outputs all points as horizontal bars.

Several HorizBarSeries can be displayed side-to-side, one behind the other, stacked or stacked 100% by using the MultiBar property.

Set the ParentChart property to the desired Chart class. Use the AddBar or AddXY methods to manually fill area points.

Right-click the class at design-time to access the DataSource Wizard Dialog to connect the Series to another Series or to any Table or Query class.

Warning:

The most important concept in HorizBarSeries is that point values are INVERTED. That means Y values are the bar order position while X values are the bars values.

The AddBar method does the conversion automatically and is the recommended method to add points. When using the AddXY method you should calculate the correct Y position.

Example:

Example [Visual Basic]:

{ This code adds 10 horizontal bars.

The loop counter is used as the Y bar value (the bar order) }

With TChart1

.AddSeries scHorizBar

For i = 1 To 10

.Series(0).AddXY MyValues(i), i, MyLabels(i), MyColor(i)

Next i

End With

The BarBrush property determines the pattern used to fill bars, while the BarPen property is used to draw the bar edges.

Set the desired bar style ( cilynder, pyramid, etc ) by changing the BarStyle property.

Use the BarWidthPercent property to control the relative distance between bars. You can specify an exact bar height by using the BarHeight property.

The Dark3D property controls if bar sides are filled with a darker color than front bar faces.

The OffsetPercent property determines the bars vertical displacement. This can be used to create overlayed bars with several bar series classes.

Bar series leave margins both at top and bottom Chart sides. You can turn off this default behaviour setting the SideMargins property to False.

By default, bar left positions start at zero horizontal coordinate. Set the Origin property to the desired starting left value or set the UseOrigin to False to make bar left sides start at minimum bars value.

Please refer to CustomBarSeries ancestor description for all common Series properties like Marks, Axis dependence, methods and events.