GetFrame

<< Clique para Mostrar o Sumário >>

 

GetFrame

GetFrame([FrameName], [CreateNew])

Este método procura por um objeto Divisor que já esteja aberto no Elipse E3 Viewer atual. Este método possui os parâmetros FrameName, que é opcional e determina o nome do Quadro a ser buscado, e CreateNew, que também é opcional e determina se é necessário criar uma nova janela caso o Quadro não seja encontrado. Caso o valor especificado em FrameName seja omitido ou uma String vazia, retorna um Quadro que contém todos os Divisores ou a Tela ativa no momento. Caso o parâmetro CreateNew seja omitido ou configurado como Verdadeiro, uma nova janela é criada. Com o retorno deste método, utilize os métodos do Divisor, como por exemplo o método OpenScreen, para abrir uma outra Tela. O código a seguir contém um exemplo de uso deste método.

Sub Botao1_Click()
  ' Ao clicar neste Botão, recebe o Quadro 'Menu'
  ' e substitui a Tela atual deste Quadro pela Tela 'Opções'
  Set novoQuadro = Application.GetFrame("Menu")
  ' novoQuadro possui um objeto do tipo Divisor
  novoQuadro.OpenScreen "Opções", 0
End Sub

 

NOTA

Caso o nome passado no parâmetro FrameName se refira a um Quadro não existente e o parâmetro CreateNew seja configurado como Falso, este método retorna Nothing, ou seja, não retorna nenhum Quadro.

Esta página foi útil?