Difference: CDXYAddBarLayer (3 vs. 4)

Revision 42011-10-21 - JeanNeron

Line: 1 to 1

META TOPICPARENT	name="CDChartDirectorDesignerAPI"

.XY ADD BAR LAYER

Line: 13 to 13

IF 0CD .XY ADD BAR LAYER NE

Description:

Changed:

<
<

This subroutine adds a Bar layer to the "current" chart spec and automatically links the "current" dataset to it if there is one. You must have intialized the chart as an XY Chart via .CHART INITIALIZE for this to have any effect. This subroutine is typically used to add multiple data sets to a single bar layer. A Bar layer is simply a group of data points you want to plot. An XY chart can have one or more Bar layers. For example, if we wanted to plot sales by month for the current year, that would be one layer. If we wanted to show last years sales as well, that would be a second layer, and so on. Normally, multiple layers are shown separately on XY charts, however, if we want to show everything in one layer, we can use this subroutine to create the layer, then add data using fill me in.

>
>

This subroutine adds a Bar layer to the "current" chart spec and automatically links the "current" dataset to it, if there is one. You must have intialized the chart as an XY Chart via .CHART INITIALIZE for this to have any effect.

This subroutine is used to add one or more bar layers to your chart. An XY chart must have at least one Layer.

This routine receives two optional values, a <data_combine_method> and a <bar_color_style>.

Changed:

<
<

If we are only going to have one set of data points on our chart, then the <data_combine_method> does not really apply. If we have multiple sets of data points, then the <data_combine_method> will determine how they will be shown. Valid values are:

>
>

If we are only going to have one data set on our chart, then the <data_combine_method> does not really apply. If we have multiple data sets, then the <data_combine_method> will determine how they will be shown. Valid values are:

side - The data sets are combined by plotting the bars side by side.

Line: 29 to 31

If blank or not passed, then each data set will be plotted in it's own layer.

Changed:

<
<

<bar_color_style> must be either blank or 'multiple'. Blank means that every bar in the layer will be the same color. 'Multiple' means that you will set the color of each bar via fill me in.

>
>

<bar_color_style> must be either blank or 'multiple'. Blank means that every bar in the layer will be the same color. 'Multiple' means that you will set the color of each bar via .XY SET BAR CLR.

If you have created your data set before calling this subroutine, then a default data group will be created and linked to this layer automatically.

Changed:

<
<

If you have created your data set before calling this subroutine, then your "current' dataset will be linked to the layer automatically.

>
>

See Datasets Overview for more information on working with Layers, Data Groups, Data Sets and Data Points.

Comments:

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

View topic | History: r14 < r13 < r12 < r11 | More topic actions...