CDXYSetBarGapBtw < Main

---+ .XY SET BAR GAP:BTW

_This subroutine sets the gap between the bars in a bar chart layer._

<br />%TOC%
---++ Usage:
<pre>      PASS         &lt;bar_gap&gt;                  FIELD            SHARE? N
      GOSUB    0CD .XY SET BAR GAP:BTW
      *        Check for error 
      IF       0CD .XY SET BAR GAP:BTW        NE</pre>
---++ Description:

<div id="_mcePaste">Sets the gap between the bars in a bar chart layer. The subroutine accepts 1 optional parameter:</div>

&lt;bar_gap&gt; - The portion of the space between the bars (or between bar groups for multi-bar layers).

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.

<div id="_mcePaste">If you want to set the gap between multi-bar layers (bar layers using the Side data combine method, or for stacked bar layers with multiple data groups, see[[CDXYAddBarLayer][.XY ADD BAR LAYER]]), see [[CDXYSetBarGap][.XY SET BAR GAP]] or [[CDXYSetBarGapWithin][.XY SET BAR GAP:WITHIN ]].</div>

Values greater than or equal to 1 will result in one pixel wide bars, since 100% of the space is allocated to the gap. The larger the gap, the narrower the bars have to be to fit in the space.
---++ Comments:

_Read what other users have said about this page or add your own comments._

<br />%COMMENT%

-- Main.JeanNeron - 2011-10-14

This topic: Main > WebHome > APPX510Features > CDChartDirectorDesignerAPI > CDChartDirectorXYChartRoutines > CDXYSetBarGapBtw
Topic revision: r3 - 2012-02-25 - JeanNeron