TcxGridChartViewData.CategoryCount Property

Specifies the total number of series values within each series used to render the View.

Declaration

property CategoryCount: Integer read; write;

Property Value

Type
Integer

Remarks

Use the CategoryCount property to obtain the total number of series values within each series used to render the View. Values of all series, data groups, and the default categories provided by the data controller can be accessed via the Values, GroupValues, and Categories collections, respectively.

By setting the CategoryCount property you can explicitly specify the total number of series values in each series that will be used to render the View. This is useful when it’s necessary to display the chart for a portion of series values. Setting the CategoryCount property automatically affects all the series which are contained within the View (i.e., all the records within the data controller which correspond to the series displayed within the View). If the new value of this property is less than the current value of the property then only the first CategoryCount series values (according to the order of the series values within the View’s data controller) are left within the View’s data controller.

Note

If the new value of this property is greater than the current value of the property then the corresponding number of empty records is added to the data store of the View’s data controller. This is a special case and is valid only in provider and unbound modes.