InsertScreenTab

<< Clique para Mostrar o Sumário >>

 

InsertScreenTab

InsertScreenTab(TabName, TabTitle, ScreenPath, [Arg])

Insere uma aba na janela do objeto PowerExplorer, com o nome indicado pelo parâmetro TabName, contendo uma Tela indicada pelo parâmetro ScreenPath. O título da aba é indicado no parâmetro TabTitle. Se este parâmetro estiver vazio, é mostrado o valor informado no parâmetro TabName. Se a aba não existir, ela é criada e, se já existir, altera a Tela. No caso de sobrescrever a Tela, caso o título seja informado, este é substituído. Se o valor passado neste parâmetro é uma String vazia, permanece o valor já configurado. Caso o usuário informe apenas o título e a aba já exista, é aceito apenas trocar o título da aba.

Este método retorna Verdadeiro se uma nova aba foi criada, ou Falso se uma aba existente foi sobrescrita. O método gera um erro de script se o nome da aba for uma String vazia ou um nome padrão (Analogs, Discretes, Commands ou Protections).

A aba é inserida sempre na última posição, e não é ativada no momento da inserção. Ao clicar na aba para ativá-la, o evento OnPreShow da Tela é executado, recebendo então o valor passado no parâmetro Arg. Se este parâmetro é omitido, nenhum valor é passado para a Tela. Exemplo:

Sub
  Set PE = Application.GetPowerExplorer("Sub1.Breaker1")
  PE.InsertScreenTab "AbaGrafico", "Gráfico", "TelaChart", 0
  PE.Show()
End Sub

Esta página foi útil?