TdxSpreadSheetReportDesigner.OnPopulateField Event

Occurs prior to adding a dataset field to the report Field Chooser.

Declaration

property OnPopulateField: TdxSpreadSheetReportDesignerPopulateFieldEvent read; write;

Remarks

This event is fired when the Report Designer attempts to add a field obtained from a bound dataset to the report Field Chooser. You can handle the OnPopulateField event to prevent adding certain dataset fields to the field chooser.

The Sender parameter specifies the Report Designer that raised the event, i.e., tries to populate its Field Chooser with the fields obtained from one of the bound data sources.

The AField parameter specifies the dataset field that is going to be added to the Field Chooser’s tree-like list.

The Allow parameter specifies if the AField field will be added to the Field Chooser. Set the Allow parameter to False in your OnPopulateEvent event handler to prevent the respective field from appearing on the Field Chooser list.

Alternatively, you can show or hide any field on the Field Chooser’s list at any moment by using the Visible property of the corresponding stored field. To access all the stored dataset fields, use the Report Designer’s data controllers.