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 está vazio, mostra o valor informado no parâmetro TabName. Se a aba não existe é criada e, se já existe, 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á existe, aceita 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. Este método gera um erro de script se o nome da aba é uma String vazia ou um nome padrão, "Analogs" (aba Analógicas), "Discretes" (aba Discretas), "Commands" (aba Comandos) ou "Protections" (aba Proteções).

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. O script a seguir contém um exemplo de uso deste método.

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