CDXYSetBarShape < Main

---+ .XY SET BAR SHAPE

_This subroutine sets the shape of the bars in the current Data Point, Data Set Template, Data Group, or XY Bar Layer._

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

This subroutine sets the shape of the bars in the current Data Point, Data Set Template, Data Group, or XY Bar Layer.

&lt;shape_name&gt; must refer to a shape you previously defined using [[CDShapeInitialize][.SHAPE INITIALIZE]]. The subroutine will cancel if this parameter is not passed.

&lt;data_point_no&gt; is optional, and if passed, should refer to a point added via [[CDPointAddNew][.POINT ADD NEW]]. The first data point you add will have a &lt;data_point_no&gt; of 1, the second will be 2, and so on.

If &lt;data_point_no&gt; is not passed, then the shape will be applied in the following order:

- "current" data point, if there is one, otherwise <br />- "current" data set template, if there is one, otherwise<br /> - "current" data group, if there is one, otherwise<br /> - "current" data layer, if there is one, otherwise an error is returned.

See [[CDOverviewDatasetDefinition][Datasets Overview]] for more information on working with data.

Also see [[CDXYSetBarShapeDP][.XY SET BAR SHAPE:DP]] to set the shape for the "current" data point, [[CDXYSetBarShapeDS][.XY SET BAR SHAPE:DS]] to set the shape for the "current" data set template, [[CDXYSetBarShapeDG][.XY SET BAR SHAPE:DG]] to set the shape for the "current" data group, and [[CDXYSetBarShapeLR][.XY SET BAR SHAPE:LR]] to set the shape for the "current" layer.

&lt;shape_name&gt; becomes the "current" shape spec after calling this routine.
---++ Comments:

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

<br />%COMMENT%

-- Main.JeanNeron - 2011-10-21
This topic: Main > WebHome > APPX510Features > CDChartDirectorDesignerAPI > CDChartDirectorXYChartRoutines > CDXYSetBarShape
Topic revision: r4 - 2012-02-25 - JeanNeron