Refresh([Force])

The Refresh method allows forcing a redrawn of a Screen's or Splitter's content. It must be used in E3 Viewer scripts with massive processing (loops, for example) or in method calls demanding a long time and also demanding a visual indication for the progress of a process to users.

Due to the general redrawn being a heavy operation, default version of the Refresh method (without the Force parameter) is optimized to ignore redrawn requests from E3. This standard behavior is ideal for loop progress indications, where a lot of redrawing is performed. The Force parameter disables this optimization, ensuring that for each call to Refresh method, a redrawn is performed. However, when using this option, the Refresh method cannot be called repeatedly, such as inside a loop. Example:

Sub CommandButton1_Click()
  ' Draws a progress bar for an operation
  While i < 31
    Screen.Item("Rectangle2")_
      .HorizontalPercentFill = (i / 30) * 100
    Frame.Refresh True
    ' <-- some lengthy operation -->
  Wend
End Sub