Refresh([Force])

O método Refresh permite forçar o redesenho do conteúdo de uma Tela ou Divisor. Este método deve ser usado em scripts do E3 Viewer com processamento massivo (por exemplo, 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 do método Refresh (sem o parâmetro Force) é otimizada de forma a ignorar pedidos de redesenho muito próximos, incluindo redesenho do próprio 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 do método Refresh seja realizado um redesenho. Porém, ao utilizar-se esta opção, o método Refresh não pode ser chamado repetidamente, como dentro de um laço. Exemplo:

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