RAD Studio VCL Reference
TDataSet.ControlsDisabled Method

Indicates whether data-aware controls update their display to reflect changes to the dataset.

function ControlsDisabled: Boolean;
__fastcall Boolean ControlsDisabled();

Call ControlsDisabled to ascertain whether the updating of data display in data-aware controls is currently disabled. If ControlsDisabled is true, controls are currently disabled. ControlsDisabled is true as long as the reference count that keeps track of disabling for the dataset is greater than zero. This count is incremented every time the DisableControls method is called and decremented when EnableControls is called. Applications call DisableControls to improve performance and prevent constant updates during automated iterations through records in the dataset. 

In complex applications, when controls may be disabled multiple times by different processes, you can use ControlsDisabled as a check in a procedure to reenable controls should each call to DisableControls not be paired with a subsequent call to EnableControls. For example,

procedure ReEnableControls (DataSet: TDataSet);
while DataSet.ControlsDisabled do


void __fastcall TForm1::ReEnableControls(TDataSet *DataSet)
while (DataSet->ControlsDisabled())


Copyright(C) 2009 Embarcadero Technologies, Inc. All Rights Reserved.
What do you think about this topic? Send feedback!