Back to Devexpress

TcxCustomDataController.IsPattern Property

vcl-cxcustomdata-dot-tcxcustomdatacontroller-c3ead270.md

latest3.1 KB
Original Source

TcxCustomDataController.IsPattern Property

Indicates whether the current detail data controller is a pattern, as defined below.

Declaration

delphi
property IsPattern: Boolean read; write;

Property Value

Type
Boolean

Remarks

A non-pattern data controller is any data controller containing records with which the end-user can interact (via the ExpressQuantumGrid , for instance). The IsPattern function returns False for:

  1. Clones of a detail data controller

  2. Data controllers without master data controllers (such data controllers have no patterns at all)

The term “pattern” can be applied only to detail data controllers. A pattern data controller does not contain data and is only used to provide settings when creating its clones (instances of a detail data controller corresponding to particular records in a master data controller).

The TcxCustomDataController topic provides more information on patterns and clones.

The following image demonstrates a Structure Navigator of ExpressQuantumGrid displaying a master-detail relationship between two Views (MasterTableView and DetailTableView):

The Views are associated with the master and detail data controllers respectively, say MasterDataController and DetailDataController. MasterDataController is a non-pattern, as it has no master data controller. DetailDataController is a pattern. It is used only as a template for creating its clones.

Settings of detail clones can be changed independently. Also, changing settings of a pattern detail data controller does not affect its existing clones until the ClearDetails method of a non-pattern master data controller is called. This recreates existing detail clones with the current settings from the pattern detail data controller.

See Also

TcxCustomDataController.ClearDetails

TcxCustomDataController.CollapseDetails

TcxCustomDataController.GetDetailDataController

TcxCustomDataController.GetMasterDataController

TcxCustomDataController.GetMasterRecordIndex

TcxCustomDataController.GetPatternDataController

TcxCustomDataController.IsDetailMode

Data Representation

TcxCustomDataController Class

TcxCustomDataController Members

cxCustomData Unit