IFormControl.BeginUpdate

Fore Syntax

BeginUpdate([Value: ControlsUpdateMode = 0]);

Fore.NET Syntax

None.

Parameters

ControlsUpdateMode. Recalculate form components' size.

Description

The BeginUpdate method deactivates the form rerendering.

Comments

This method is used to speed up the work when a great number of components are created dynamically. After calling this method and till the EndUpdate method is called, the form rerendering is disabled on form or components resizing. Changing of the TabOrder value does not affect the order of components displaying. The internal events of the form are disabled. Use the EndUpdate method to resume form rerendering and apply all changes.

Example

Executing this example requires a form, the Button1 button on this form, and a panel named Panel1.

Sub Button1OnClick(Sender: Object; Args: IMouseEventArgs);
Var
    Edit1, Edit2: IEditBox;
Begin
    Self.BeginUpdate(ControlsUpdateMode.LockResizeOnUpdate);
    Edit1 := New EditBox.Create;
    Edit2 := New EditBox.Create;
    Edit1.Parent := Panel1;
    Edit2.Parent := Panel1;
    Edit1.Anchors.Right := 100;
    Edit2.Anchors.Right := 100;
    Edit1.Text := "Value 1:";
    Edit2.Text := "Value 2:";
    Edit2.Top := Edit1.Top + Edit1.Height;
    Self.EndUpdate;
End Sub Button1OnClick;

On clicking the button two text editors are created on the panel. Form rerendering is disabled before components creation to make the process quicker. All the changes are applied after the components are created and their properties are configured.