TcxGridChartItemDataBinding Class

An object which links a Chart View item to a data store.

Declaration

TcxGridChartItemDataBinding = class(
    TcxInterfacedPersistent,
    IcxEditRepositoryItemListener
)

Remarks

All Chart View items (series, data groups and the default categories) use a DataBinding object to link to a data store. Generally, the data binding is used to determine the value’s type. The value’s type is identified by the ValueTypeClass property whose value determines the manner in which the data is represented (as a string, integer, date, boolean, etc.). In bound mode the ValueTypeClass is assigned automatically based upon the field’s type. In the unbound and provider modes the ValueTypeClass has to be specified manually to ensure that the item works correctly. The ValueTypeClass and ValueType properties also provide a way in which unbound items can be implemented in data-aware Views.

The Data property is useful in provider mode, e.g. for indexing categories and series. When in provider mode the custom data source cannot track changes to the displayed items (for instance, moving items) so data referencing is inadequate. Use the Data property to assign a unique value to the items. When using your custom data source refer to the Data property to identify the items. See the Provider Mode topic for more information.

For series, the SummaryItem property of a DataBinding object provides access to a group summary calculated for the series.