TcxCustomGridTableViewData Class

Represents the base class which provides data from a data store as an array of records.

Declaration

TcxCustomGridTableViewData = class(
    TcxCustomGridViewData
)

Remarks

The TcxCustomGridTableViewData class is a bridge between the data controller and the View’s data representation. It adapts values provided by the data controller for displaying within a View. The Records property provides the collection of records currently displayed within a View. This collection references both data rows and group rows (in a Table View). If a record is hidden under a collapsed row, it is not accessible via the Records collection. When you group data by column(s) or change the record order, the collection is recreated to reflect the current record arrangement.

Every record represents an object of the TcxCustomGridRecord class. It provides the ability to get record values, display values as text, provide indexes (record indexes and record level). Using properties of the TcxCustomGridRecord class, it is possible to focus, select a record and expand/collapse a record (the latter only for group and master records though).

There are several types of records derived from the TcxCustomGridRecord class: data row, master data row, new item row, group row, and card (in a Card View). For more information refer to the TcxCustomGridRecord class topic.

If the View contains a new item record (a new item row in a grid View), the NewItemRecord property refers to the corresponding record in the ViewData.

The View’s ViewData property allows you to access properties of the TcxCustomGridTableViewData class for this View.