TcxGridChartCategories.ValueCount Property

Specifies the total number of category values (the default categories) used to render the current View.

Declaration

property ValueCount: Integer read; write;

Property Value

Type
Integer

Remarks

All category values (the default categories) used to render the current View are stored within the Values collection. Use the ValueCount property to obtain the total number of values within this collection.

By setting the ValueCount property for the default categories you can explicitly specify the total number of category values that will be used to render the current View. This is useful when the chart needs to be displayed for some of series values or the available default categories only. Setting the ValueCount property automatically affects all the series which are contained within the View (actually, all the records within the View’s data controller which correspond to the series and default categories displayed within the View). If the new value that this property is set to is less than the old value then only the first ValueCount default categories (based upon the order of the default categories 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 old value of the property then a corresponding number of empty records are 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.