ChartDirector 7.1 (C++ Edition)

BarLayer.setBarGap


Usage

void setBarGap(double barGap, double subBarGap = 0.2);

Description

Sets the gap between the bars in a bar chart layer.

In the setBarGap method, the gap between the bars is expressed as the portion of the space between the bars. For example, a bar gap of 0.2 means 20% of the distance between two adjacent bars is the gap between the bars.

A bar gap of 0 means there is no gap in between the bars. The bar gap can be negative. In this case, the bars will overlap. The predefined constant TouchBar ( = -1.7E-100) means the bars will "touch", that is, the bar borders overlap, so two adjacent bars will share the same border.

For multi-bar layers (bar layers using the Side data combine method, or for stacked bar layers with multiple data groups), barGap refers to the portion of the space between bar groups, while subBarGap refers to the portion of the space between bars within the bar group.

Arguments

ArgumentDefaultDescription
barGap(Mandatory)The portion of the space between the bars (or between bar groups for multi-bar layers).
subBarGap0.2This argument only applies to multi-bar charts. It is the portion of the space between the bars in a bar group.

Return Value

None