Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TcxGridChartOptionsView.CategoriesPerPage Property

Specifies the maximum number of categories simultaneously displayed within the active chart diagram.

#Declaration

Delphi
property CategoriesPerPage: Integer read; write; default 0;

#Property Value

Type Default Description
Integer 0

The maximum number of simultaneously visible categories in the active diagram.

#Remarks

When this property is set to a value other than the default, the active diagram is broken down into pages. This value specifies the maximum number of categories simultaneously displayed within the diagram (fits in “a page”). Otherwise, all categories will be displayed.

When categories do not fit in a single page, a scrollbar is displayed along a category axis.

To specify the index of the first visible category in a paged diagram, use the View’s Controller.FirstVisibleCategoryIndex property.

Use the View’s Controller.ActiveDiagramSupportsPaging property to determine whether the currently active diagram supports paging.

#Limitations

All diagrams except for pies support pagination.

#Default Value

The CategoriesPerPage property’s default value is 0.

See Also