Sign in Join
FPDoc Onlineexperiment

TDataSet.EnableControls procedure

Member of TDataSetpublicIn unit DB

Enable event propagation of controls.

Declaration

pascal
procedure EnableControls

Description

EnableControls tells the dataset to resume sending data-related events to the controls. This must be used after a call to DisableControls to re-enable updating of controls.

Note that for each call to DisableControls, a matching call to EnableControls must be made: an internal count is kept and only when the count reaches zero, the controls are again notified of changes to the dataset. It is therefore essential that the call to EnableControls is put in a Finally block:

MyDataset.DisableControls;
Try
  // Do some intensive stuff
Finally
  MyDataset.EnableControls
end;

Errors

Failure to call enablecontrols will prevent the controls from receiving updates. The state can be checked with ControlsDisabled.

See also

An experiment, built from development snapshots. Not the official Free Pascal or Lazarus documentation.