CDXYSetBarOlapRATIO < Main

---+ .XY SET BAR OLAP:RATIO

_This subroutine sets the overlap ratio among bars within a bar group in a multi-bar chart._

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

This subroutine sets the overlap ratio among bars within a bar group in a multi-bar chart.

You have to define a Layer via [[CDXYAddBarLayer][.XY ADD BAR LAYER]] for this subroutine to have any effect.

By default, in a multi-bar chart, the bars are not overlapped, but are separated with a gap in between. This subroutine can be used to set an alternative style, where the bars partially overlap. Also see [[CDXYSetBarGap][.XY SET BAR GAP]].

The parameter is optional, and if blank or not passed, will be reset to the default value.

&lt;olap_ratio&gt; - The overlapping ratio between adjacent bars in a bar group. Should be between 0 to 1.

Also see [[CDXYSetBarOlapOrder][.XY SET BAR OLAP:ORDER]] to the order by itself or [[CDXTSetBarOlap][.XY SET BAR OLAP]] to set both the ratio and order at the same time.
---++ Comments:

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

<br />%COMMENT%

-- Main.JeanNeron - 2011-10-19

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