Refresh([Force])

Este método permite forçar o redesenho do conteúdo de uma Tela ou Divisor. Este método deve ser usado em scripts do Elipse E3 Viewer com processamento massivo, como por exemplo em laços, ou em chamadas de métodos que demandem muito tempo e exijam indicações visuais ao usuário do progresso do processo.

Devido ao redesenho em geral ser uma operação pesada, a versão padrão deste método, sem o parâmetro Force, é otimizada de forma a ignorar pedidos de redesenho muito próximos, incluindo redesenho do próprio Elipse E3. Este comportamento padrão é ideal para indicações de progresso em laços, onde muitos redesenhos são realizados em sequência. O parâmetro Force desabilita esta otimização, garantindo que para cada chamada deste método seja realizado um redesenho. Porém, ao utilizar-se esta opção, este método não pode ser chamado repetidamente, como dentro de um laço, conforme o exemplo a seguir.

Sub CommandButton1_Click()
  ' Desenha uma barra de progresso de uma operação
  While i < 31
    Screen.Item("Retangulo2")_
      .HorizontalPercentFill = (i / 30) * 100
    Frame.Refresh True
    ' <-- alguma operação demorada -->
  Wend
End Sub