TdxDockingController.BeginUpdate Method

Prevents the dock controls layout from being updated until the EndUpdate method is called.

Declaration

procedure BeginUpdate;

Remarks

The BeginUpdate and EndUpdate methods should be used in combination. The first increments the internal counter (which is initially zero) by one. The second decrements the counter. Layout updates are only allowed while the counter value is zero. Thus, you can use the BeginUpdate and EndUpdate methods to perform batch layout modifications.

Suppose you need to change the layout of dock controls via code by performing three sequential docking operations. By default, the layout will be updated after each modification. To avoid this, enclose your code into the BeginUpdate and EndUpdate method calls. In this case, the layout will be updated only once which will result in a performance benefit.