Enables you to specify whether a particular detail is empty. This event is in effect if the GridOptionsDetail.AllowExpandEmptyDetails option is set to false.
[DXCategory("MasterDetail")] public event MasterRowEmptyEventHandler MasterRowEmpty
<DXCategory("MasterDetail")> Public Event MasterRowEmpty As MasterRowEmptyEventHandler
The MasterRowEmpty event's data class is MasterRowEmptyEventArgs. The following properties provide information specific to this event:
|IsEmpty||Gets or sets a value specifying whether a detail contains data.|
|RelationIndex||Gets the relation index that identifies the affected detail. Inherited from CustomMasterRowEventArgs.|
|RowHandle||Gets the handle of the currently processed master row in the current View. Inherited from CustomMasterRowEventArgs.|
The MasterRowEmpty event is only in effect if the GridOptionsDetail.AllowExpandEmptyDetails option is set to false. It is raised for each master-detail relationship for each master row within the View. The event allows you to complete the following tasks:
- Mark a detail View that contains data as "empty" by setting the event's IsEmpty parameter to true.
- Mark a detail View that does not contain data as "not empty" by setting the event's IsEmpty parameter to false. In this case, data for this View needs to be provided via the GridView.MasterRowGetChildList event.
Refer to the Working with Master-Detail Relationships in Code topic for information on supplying detail data manually.