CT Chart arrays

version 1

CT Chart arrays (area; type; size; categoryArray; seriesArray; valuesArray) Number

CT Chart arrays creates a graph based on the specified arrays and returns the graph's Object ID. This command can be used to create either a two-dimensional or three-dimensional graph.

The following table lists the codes for the type parameter.

The size parameter determines how much space the graph fills when it is generated and how the graph size changes when you resize the window:

• If you pass 1 (size Variable), the graph will fill the 4D chart area or the window. It will keep this size until you modify it using the handles.

• If you pass 2 (size Relative to the window), the graph will fill the 4D chart area or the external window. If you later change the size of the window, the graph will adapt automatically. However, once you modify the size of the graph using the handles, this change will not take place anymore.

• If you pass 3 (size Relative to the document), the graph will adapt to the dimensions of the page that you selected in the Page Setup dialog. It will keep this size until you modify the graph size using the handles.

The categoryArray parameter contains the X-axis categories.

seriesArray contains the series. In a two-dimensional graph, the series is displayed on the Category axis. In a three-dimensional graph, the series is displayed on the Series axis.

valuesArray is a on-edimensional array that contains all the values to be graphed on the Values axis. valuesArray must be filled in so that there is a value for each element of the categoryArray and seriesArray. That is, if there are n categories and m series, there will be n*m elements in valuesArray.

The following illustration shows the order in which valuesArray should be filled. n represents the total number of categories. m represents the total number of series.

For example, consider the following data and resulting Values array:

CT Chart data, CT Chart selection.