Highperformancemanual PTB

Manual
HighPerformance
Manual do Usuário da
Biblioteca HighPerformance
Template
Copyright © 2014-2023 Elipse Software Ltda. Todos os direitos reservados.

Versão 2.5.74 (07/06/2023)
Sumário
1 Introdução ................................................................................................................................................... 1
2 Biblioteca HighPerformance Template ................................................................................................... 2
2.1 Arquivos da Biblioteca ......................................................................................................................... 2
2.2 Instalação da Biblioteca em uma Aplicação Nova ............................................................................ 4
2.3 Atualização da Biblioteca em uma Instalação Existente ................................................................. 6
2.4 Objetos Internos ................................................................................................................................... 6
2.5 Objetos com Temas Nativos ............................................................................................................... 6
2.6 Associação de Valores a Objetos de Dados ....................................................................................... 6
2.7 Execução de Scripts em Objetos Instanciados .................................................................................. 7
2.8 Acesso a Propriedades, Métodos ou Eventos Não Disponíveis nas Instâncias ............................ 7
2.9 Avisos na Execução de um Domínio .................................................................................................. 8
2.10 Valores Recomendados de Zoom e Barra de Rolagem ................................................................. 9
3 Guia Rápido de Configuração ................................................................................................................. 10
3.1 Navegação ........................................................................................................................................... 10
3.2 Menu Lyra ........................................................................................................................................... 10
3.3 Viewer .................................................................................................................................................. 11
4 Como Usar a Biblioteca HighPerformance Template .......................................................................... 13
4.1 Menus .................................................................................................................................................. 13
4.2 Temas .................................................................................................................................................. 15
4.3 Navegação ........................................................................................................................................... 24
4.4 Tradução .............................................................................................................................................. 48
4.5 Logs ...................................................................................................................................................... 56
5 Objetos ...................................................................................................................................................... 61
5.1 Alarmes ............................................................................................................................................... 61
5.2 Gráficos de Barras .............................................................................................................................. 72
5.3 Gráficos ............................................................................................................................................... 93
5.4 Indicadores ....................................................................................................................................... 109
5.5 Navegação e Abertura de Telas ..................................................................................................... 116
5.6 Formulários ....................................................................................................................................... 133
5.7 Ícones ................................................................................................................................................ 153
5.8 Menus ................................................................................................................................................ 155
5.9 Telas, Quadros e Monitores ............................................................................................................ 171
5.10 Temas .............................................................................................................................................. 172
5.11 Textos .............................................................................................................................................. 180
5.12 Tradução ......................................................................................................................................... 187
5.13 TreeView ......................................................................................................................................... 189
5.14 XML ................................................................................................................................................. 198
5.15 Logs ................................................................................................................................................. 209
6 Novidades de Versão ............................................................................................................................. 210
6.1 Pré-Requisitos .................................................................................................................................. 210
I
6.2 Versão 2.5 Build 74 .......................................................................................................................... 210
6.3 Versão 2.0 Build 88 .......................................................................................................................... 221
II
CAPÍTULO
Introdução
1
Este documento contém informações necessárias para entender o funcionamento da Biblioteca HighPerformance
Template e como utilizá-la em uma aplicação. Estas informações estão dispostas nos tópicos a seguir.
· Biblioteca HighPerformance Template: Contém os conceitos básicos e fundamentais para o entendimento da

Biblioteca HighPerformance Template
· Guia Rápido de Configuração: Contém roteiros simplificados de configuração de alguns recursos importantes da
Biblioteca HighPerformance Template, útil também para guiar revisões rápidas na configuração dos recursos em
uma aplicação existente
· Como Usar a Biblioteca HighPerformance Template: Contém roteiros detalhados de configuração dos recursos
da Biblioteca HighPerformance Template
· Objetos: Contém descrições detalhadas de cada objeto da Biblioteca HighPerformance Template
· Novidades de Versão: Contém todas as correções e novas implementações realizadas e a lista de pré-requisitos
para o funcionamento normal da Biblioteca HighPerformance Template
1 Introdução
CAPÍTULO
2
A Biblioteca HighPerformance Template para Elipse E3 ou Elipse Power é um modelo de aplicação que sintetiza os
resultados de diversos estudos realizados nas mais distintas áreas do conhecimento, aplicados no desenvolvimento
de interfaces industriais. Os objetos, recursos visuais e diretrizes de design que compõem a Biblioteca
HighPerformance Template possibilitam:
· Aumento da consciência situacional do usuário
· Maior efetividade na prevenção de falhas e redução de erros operativos
· Maior acessibilidade para os portadores de daltonismo
· Aprimoramento estético
· Melhor usabilidade
· Maior facilidade e velocidade de desenvolvimento
Para mais detalhes sobre os benefícios oferecidos pela Biblioteca HighPerformance Template, consulte o Elipse
Knowledgebase.
A solução completa de alto desempenho é um somatório de recursos cujo escopo vai além da criação de simples
objetos. Trabalha-se não apenas objetos isolados, mas o contexto das Telas e da aplicação como um todo. Por isto, a
Biblioteca HighPerformance Template contempla não apenas uma biblioteca de objetos para visualização de dados,
mas diversas bibliotecas integradas entre si e que contêm ícones, menus, Esquemas de cores, Temas, objetos de
formulários e categorias de textos, entre outros recursos.
2.1 Arquivos da Biblioteca

A Biblioteca HighPerformance Template está organizado nos grupos de arquivos descritos na tabela a seguir.
Grupos de arquivos disponíveis na Biblioteca HighPerformance Template
GRUPO ARQUIVOS DESCRIÇÃO

Alarmes hpE3Alarm.lib Contém objetos para serem
integrados ao E3Alarm
Imagens hpArchitecture2d.lib, Contém imagens, logotipos e ícones

hpArchitecture3d.lib, hpIcons.lib e adaptados à Biblioteca
hpLogos.lib HighPerformance Template
Menus e Navegação hpMenus.lib, hpNavigation.lib e Contém objetos para composição de

hpNavigationStruct.lib menus, abas e navegação
Projetos hpMain.prj Contém objetos necessários para o

funcionamento da Biblioteca
HighPerformance Template.
Recomenda-se usar o objeto Viewer
deste arquivo para toda a aplicação
Quadros hpFrames_Repository.prj Repositório de Quadros à parte do

Domínio da aplicação
Temas hpThemes.lib Temas de cores
Biblioteca HighPerformance Template 2

GRUPO ARQUIVOS DESCRIÇÃO
Tradutores hpTranslator.lib Contém recursos para tradução
automática
Utilidades hpUtilities.lib Contém objetos auxiliares que visam

dar suporte a tarefas diversas,
complementando e enriquecendo as
funcionalidades da Biblioteca
HighPerformance Template
Viewer hpViewer.lib Configuração de matrizes de

monitores e tamanho do Viewer
Visualização de Dados hpDisplayMedia.lib, hpTexts.lib, Contém objetos de visualização de

hpForms.lib e hpTreeview.lib dados, como bargraphs, displays,
charts, textos, objetos de formulários
e TreeViews, entre outros
XML hpXMLIndexer.lib Geração de conteúdo no formato

XML
A Biblioteca HighPerformance Template é distribuído com a estrutura de pastas e arquivos descrita na tabela a
seguir.
Estrutura de pastas e arquivos da Biblioteca HighPerformance Template
PASTA CONTEÚDO
Demo Aplicação de demonstração da Biblioteca
HighPerformance Template, com exemplos de objetos
e simulação de configurações
Dictionaries Arquivo no formato CSV (Comma-Separated Values) com

exemplo de dicionário em três idiomas
Extensions Arquivos de extensão da Biblioteca HighPerformance

Template que funcionam de forma integrada à
modelagem da Biblioteca PlantModel
Help Arquivos de ajuda da Biblioteca HighPerformance

Template
Libraries Arquivos de biblioteca (com a extensão .lib) com as

definições de objetos da Biblioteca HighPerformance
Template
Packages Pacote somente de leitura com as bibliotecas usadas na

versão atual
PlantModel Arquivos da Biblioteca PlantModel
Projects Arquivos de projeto, com a extensão .prj, com as

instâncias dos objetos definidos nas bibliotecas, além de
outros objetos necessários para o funcionamento da
3 Biblioteca HighPerformance Template

A aplicação de demonstração utiliza os arquivos de bibliotecas inseridos dentro de um pacote de bibliotecas do
Elipse E3 somente de leitura, denominado libraries.e3pkg. Este pacote é o mesmo que está disponível na pasta
Packages.
A Elipse Software recomenda o uso deste pacote de bibliotecas em qualquer aplicação. Caso seja necessário
personalizar algum de seus objetos, é recomendável criar uma cópia do objeto dentro de um novo arquivo de
biblioteca criado pelo usuário, mantendo sempre o pacote de bibliotecas em uso.
2.2 Instalação da Biblioteca em uma Aplicação Nova

Para instalar a Biblioteca HighPerformance Template em uma aplicação onde não há instalação prévia desta
biblioteca, proceda conforme os passos a seguir.
1. Copie a pasta raiz da Biblioteca HighPerformance Template, com todas as subpastas e arquivos, para a pasta
raiz da aplicação. A pasta HighPerformance/Demo pode ser excluída, pois não é necessária para o
funcionamento da Biblioteca HighPerformance Template.
2. Em seguida, no Studio, insira no Domínio o arquivo libraries.e3pkg da pasta HighPerformance/Packages e o

arquivo hpMain.prj da pasta HighPerformance/Projects.
3. Exclua o objeto Viewer da aplicação se este objeto não tem nenhum script, Associação ou objeto configurados.
Caso o objeto Viewer da aplicação tenha scripts, Associações ou objetos previamente configurados, estes devem
ser migrados para o objeto Viewer da Biblioteca HighPerformance Template, localizado no arquivo hpMain.prj,
antes de ser excluído.
4. Execute a aplicação, que deve exibir a Tela inicial do Assistente de Navegação, uma vez que nenhum Perfil de
Navegação foi criado.
Tela inicial do Assistente de Navegação
5. Clique na opção Criar perfil padrão para criar automaticamente um Perfil de Navegação padrão, ou clique na
opção Criar novo perfil para criar um novo Perfil. A janela de configuração do Assistente de Navegação é exibida,
conforme a figura a seguir.

Janela de configuração do Assistente de Navegação
6. Execute as alterações que julgar necessárias, salve-as e feche o Viewer.
7. No Studio, clique em Executar/Parar Domínio ou pressione a combinação de teclas SHIFT+F9 para parar a
execução do Domínio.
8. No Organizer, clique com o botão direito do mouse no projeto HPMAIN e selecione a opção Atualizar.
Até aqui a pasta hpObjects - Navigation - Profiles já contém o Perfil de Navegação corretamente configurado. Em
seguida é preciso atualizar a aplicação com os Quadros adaptativos.
9. Sem adicionar ao Domínio, abra o arquivo hpFrames_Repository.prj, da versão 2.5, e copie todo o conteúdo da
pasta hpFrames_v2.5_Adaptive para a pasta hpFrames da aplicação.
10. Certifique-se de deixar, na pasta hpFrames - MatrixTemplates, somente os objetos que correspondem às
matrizes de monitores configuradas na aplicação, excluindo os que não são utilizados.
11. Copie e cole o Quadro adaptativo hpNavTemplate01, renomeando as cópias com o mesmo nome dos Templates
configurados na aplicação.
12. Para cada monitor configurado na matriz de monitores, deve existir um Quadro adaptativo correspondente, tendo
no nome o sufixo com o número do monitor, como por exemplo "01", "02" ou "03".
13. Salve todas as alterações e inicie a aplicação, que deve exibir o Template de inicialização selecionado, conforme a
figura a seguir.

Tela de boas-vindas da Biblioteca HighPerformance Template
NOTAS
· O arquivo de projeto hpMain.prj vem com um objeto Viewer previamente configurado. Este objeto contém
objetos de controle do Template e, por este motivo, deve-se evitar sua substituição por outro objeto Viewer.
· As bibliotecas HighPerformance Template e a aplicação de demonstração, localizada na pasta
HighPerformance/Demo, foram projetadas para utilizar alguns dos recursos mais recentes desenvolvidos para o
Elipse E3 ou Elipse Power. Por este motivo, a execução em versões antigas não é recomendada, uma vez que
alguns dos recursos podem não ter sido desenvolvidos na versão usada, apresentando erros de execução.
Recomenda-se o uso sempre com a versão mais recente do Elipse E3 ou Elipse Power. Para mais detalhes,
consulte a lista de pré-requisitos das bibliotecas HighPerformance Template.
2.3 Atualização da Biblioteca em uma Instalação Existente

Para atualizar uma aplicação que já tenha a Biblioteca HighPerformance Template instalada, consulte o tópico
Roteiro para Atualização.
2.4 Objetos Internos

As bibliotecas que compõem a Biblioteca HighPerformance Template possuem objetos que têm seu uso restrito a
outros objetos da própria biblioteca, não devendo ser usados diretamente em uma aplicação. Estes objetos são
geralmente identificados pelo prefixo "~" (til) no nome e devem ser ignorados pelo usuário.
2.5 Objetos com Temas Nativos

Todos os objetos de Bibliotecas usam os Temas nativamente. Isto significa que ao instanciar um Display, um Texto, um
ícone ou qualquer outro objeto destas bibliotecas em uma Tela, o objeto instanciado vem com a funcionalidade de
alteração automática de cor com base no Tema selecionado.
2.6 Associação de Valores a Objetos de Dados

A Biblioteca hpDisplayMedia contém objetos muito semelhantes entre si, porém com a diferenciação do sufixo IO no
nome, como por exemplo hpDynamicValue e hpDynamicValueIO.
O sufixo IO em um objeto significa que este objeto pode receber uma Associação direta do Tag de Comunicação
(IOTag), por isto é mais indicado para uso com dados de processo, ao passo que o objeto sem o sufixo é indicado
para valores simulados ou calculados (DemoTag ou InternalTag).

NOTA
Os objetos hpBarGraphAlarmLimHorizontalIO, hpBarGraphAlarmLimVerticalIO,
hpBarGraphAlarmZoneHorizontalIO, hpBarGraphAlarmZoneVerticalIO, hpCombinedBarLineGraphIO,
hpDiffChartIO, hpDynamicValueIO, hpManualValueIO, hpRadarChart3VarIO, hpRadarChart4VarIO e
hpRadarChart5VarIO foram descontinuados, não recebem mais atualizações e vão ser removidos da Biblioteca
HighPerformance Template em uma versão futura. Recomenda-se o uso dos respectivos objetos sem o sufixo IO
no nome.
2.7 Execução de Scripts em Objetos Instanciados

Pode-se monitorar eventos de clique de mouse e escrever scripts personalizados diretamente no objeto instanciado,
sem a necessidade de editar o objeto original na Biblioteca.
Para isto, muitos dos objetos possuem a propriedade EventClick, que é um contador incrementado a cada clique do
mouse que o objeto recebe. Ao monitorar este valor, pode-se criar um evento personalizado OnEventClick, que é
disparado quando o valor desta propriedade muda, e escrever um script na janela de edição de scripts.
Janela de criação de eventos de usuário
2.8 Acesso a Propriedades, Métodos ou Eventos Não

Disponíveis nas Instâncias
Uma das grandes vantagens da Biblioteca HighPerformance Template é disponibilizar objetos previamente
configurados e com design padronizado, permitindo ao usuário concentrar seu tempo no desenvolvimento de novos
recursos e funcionalidades de maior valor para o processo. O usuário instancia o objeto e já pode usá-lo com
mínimas (ou nenhuma) alteração. Isto preserva as características principais da metodologia de alto desempenho
visual, ao mesmo tempo que garante a praticidade de uso.
Há casos, no entanto, em que alguns recursos importantes do objeto estão indisponíveis na instância. Um exemplo
são os métodos de objetos. No caso de Listas (List Box) ou Listas de Seleção (Combo Box), o funcionamento básico do
objeto depende de alguns destes métodos, como por exemplo o método AddItem.
Nestes casos específicos, a Biblioteca HighPerformance Template fornece acesso integral ao objeto através da
propriedade Object. Esta propriedade referencia o objeto original, tornando disponíveis todas as suas propriedades
e métodos. Por exemplo, o método AddItem é acessado na instância, por script, usando o código a seguir.
Object.AddItem "Item a ser adicionado"
Este recurso deve ser usado apenas para garantir o funcionamento básico do controle, e não para descaracterizá-lo,
alterando sua cor de fundo ou sua fonte, pois o controle já se encontra harmonizado com todos os demais objetos
da Biblioteca HighPerformance Template.
Já eventos como Click, Change, MouseMove e outros, ganham propriedades equivalentes com a adição do prefixo
Event em seu nome. Portanto, EventClick, EventChange e EventMouseMove são propriedades que sofrem alteração

em seu valor quando o evento original ocorre. O usuário deve criar um evento personalizado (Evento de Usuário)
para executar um script na ocorrência do evento original. A figura a seguir mostra a janela de criação de um Evento
de Usuário chamado OnEventClick.
Criação de um evento personalizado OnEventClick
No caso dos eventos, há ainda a particularidade de eventos que retornam valores e eventos que não retornam
valores. Por exemplo, o evento Click não retorna nenhum valor ao usuário.
Sub ComboBox1_Click()
Quando um evento não retorna valores, cada ocorrência incrementa o valor da propriedade correspondente. No
exemplo anterior, cada clique do mouse no objeto incrementa o valor da propriedade EventClick. Assim, pode-se
monitorar qualquer mudança de valor e executar um script ao clicar no objeto.
Já o evento KeyDown retorna o código das teclas pressionadas, KeyCode e Shift.

Sub ComboBox1_KeyDown(KeyCode, Shift)
Quando o evento retorna valores, estes são passados para a propriedade correspondente na forma de um vetor. No
exemplo anterior, a cada ocorrência do evento os parâmetros KeyCode e Shift são passados à propriedade
EventKeyDown como um vetor.
Array(KeyCode, Shift)
Assim é possível monitorar alterações no valor da propriedade e recuperar esta informação na instância do objeto,
por exemplo usando o código a seguir.
Sub hpComboBox1_OnEventKeyDown()
'Propriedade EventKeyDown é um vetor
vKeyCode = EventKeyDown(0)
vShift = EventKeyDown(1)
MsgBox "KeyCode = " & CStr(vKeyCode)
MsgBox "Shift = " & CStr(vShift)
End Sub
2.9 Avisos na Execução de um Domínio

As bibliotecas e projetos da Biblioteca HighPerformance Template podem apresentar alguns avisos de erros em
uma Verificação de Domínio, que contemplam os casos a seguir.
· Associação referenciando a propriedade de um objeto ElipseX criado pelo usuário: Estas propriedades
normalmente não são acessadas pelo AppBrowser
· Associação referenciando o caminho de um objeto interno a outro objeto ElipseX criado pelo usuário: Os
objetos internos às classes definidas pelo usuário não são acessados pelo AppBrowser
· Associação com propriedade privada: Dentro de um objeto ElipseX uma propriedade privada não é acessível ao
AppBrowser

· Propriedade multiplamente associada: Esta condição permite tanto alterar o valor de uma propriedade como
refletir as alterações em duas fontes simultaneamente
Estes avisos são, portanto, condições especiais decorrentes do desenvolvimento natural das bibliotecas, e podem ser
ignorados pelo usuário. A tabela a seguir contém os arquivos e objetos afetados por estes avisos.
Arquivos e objetos com avisos na execução do Domínio
ARQUIVO OBJETO
Boiler.lib XCValveB e XCPump
Building.lib Luminaria e Compressor
Dosage.lib XCValve, XCMotor, XCElevator e XCElevatorBase
hpForms.lib hpDateTimePicker
hpXControls.lib hpXCollapseExpand
Sanitation.lib XCBomb, XCMixer e XCValveS
hpXMain.prj Tela Faceplate e Pasta hpData.View
Root_View.prj Telas Alarms, AlarmsConfig, TreeView, Forms, WindRose

e Bargraph
2.10 Valores Recomendados de Zoom e Barra de Rolagem

Para garantir uma melhor visualização de Telas em diferentes configurações de monitores, recomenda-se utilizar os
valores dos parâmetros zoom e barra-de-rolagem da tabela a seguir nas Associações de abertura de Telas.
Valores dos parâmetros de zoom e barra de rolagem
TIPO DE TELA PARÂMETROS RECOMENDADOS

Pop-up, aberta usando o método DoModal ?100?0
Normal, aberta usando o método OpenScreen ?1?0
Exemplo de uso:
Application.DoModal "Faceplate?100?0", "Título", 200, 200, 420, 440, "Arg", 1+2+4+8
Application.GetFrame("FrameTeste").OpenScreen "TelaPrincipal?1?0", "Arg"
Estes valores asseguram que as Telas sejam exibidas mantendo a proporção e assegurando uma melhor legibilidade,
independente da resolução e formato de cada monitor.
NOTAS
· O uso de valores diferentes dos recomendados, em especial para o parâmetro zoom, pode provocar a perda de
legibilidade das Telas, prejudicando a utilização.
· Caso uma Tela desenvolvida para uma orientação Paisagem, como por exemplo um monitor widescreen, tenha que
ser visualizada na orientação Retrato, como por exemplo em uma tela de um celular na vertical, recomenda-se o
desenvolvimento de uma Tela específica para cada orientação.

CAPÍTULO
Guia Rápido de Configuração
3
Esta seção contém informações sobre a configuração rápida de Navegação, Menu Lyra e Viewer.
3.1 Navegação
Roteiro rápido para configurar uma estrutura de navegação usando a Biblioteca HighPerformance Template:
1. Crie uma estrutura de navegação utilizando o Assistente de Configuração de Navegação.
2. Copie o conjunto de Quadros correto do arquivo de repositório. Para mais informações, consulte o tópico
Quadros Adaptativos.
3. Certifique-se de que o conjunto de Quadros reflete a configuração realizada na estrutura de navegação.
4. Execute a aplicação.
3.2 Menu Lyra

Para configurar o menu Lyra para navegação, são necessários os procedimentos descritos a seguir.
1. Construa e configure a estrutura de navegação.
2. Gere o código XML desta estrutura de navegação.
3. Instancie e configure um objeto hpLyraMenu.
Gerando a Estrutura de Navegação
O primeiro passo da configuração do menu Lyra é criar e configurar a estrutura de navegação que é refletida no
menu Lyra, usando os objetos hpLyraData. Estes objetos devem inicialmente ter configuradas as seguintes
propriedades:
· Name: Nome do item
· Behaviour: Comportamento de cada item, onde
· 0: Para itens que tenham filhos
· 1: Abre uma Tela
· 2: Abre uma janela pop-up
· IconGallery e IconName: Exibição de ícone
· MenuDescription: Descrição do menu
· StartScreen: Configure em True para que o menu inicie exibindo a Tela correspondente ou em False caso
contrário
Caso a propriedade Behaviour seja configurada com o valor 1: Abertura de Tela, as propriedades a seguir devem
ser configuradas:
· scrAutoMonitor
· scrContent
· scrFooter
Guia Rápido de Configuração 10

· scrHeader
· scrLeft
· scrMaster
· scrMenu
· scrMonitorNumber
· scrRight
· scrTemplate
Caso a propriedade Behaviour seja configurada com o valor 2: Abertura de janela pop-up, as propriedades a seguir
devem ser configuradas:
· popArg
· popName
· popTitle
· popTemplate
Para mais informações sobre a configuração e as propriedades deste objeto, consulte o tópico hpLyraData.
Gerando o Código XML da Estrutura de Navegação
Uma vez que a estrutura esteja pronta, é preciso gerar o código XML correspondente e colocá-lo em um Tag Interno
do Viewer. Para isto, instancie um objeto hpXMLCatalog em um Servidor de Dados, preferencialmente em Objetos
de Servidor - Objetos de Dados - hpObjects - XML, e configure inicialmente as seguintes propriedades deste objeto:
· InitialPath: Informa o primeiro nível das pastas com o código XML gerado
· GetAllChildren: Define se o código XML contém todos os níveis ou somente o primeiro nível de objetos
· XMLTemplate: Defina esta propriedade com o valor 2 (dois)
Para mais informações sobre a configuração e as propriedades deste objeto, consulte o tópico hpXMLCatalog.
Configurando o Objeto hpLyraMenu
O próximo passo é instanciar o objeto hpLyraMenu na Tela e configurar inicialmente as propriedades DataFolder e
DocInput.
Para mais informações sobre a configuração e as propriedades deste objeto, consulte o tópico hpLyraMenu.
3.3 Viewer
Recomenda-se manter a configuração do objeto Viewer da aplicação de demonstração em outras aplicações, em
especial o valor das seguintes propriedades:
· CacheEnable: Deve ser configurada em Verdadeiro a fim de garantir o melhor desempenho na abertura de Telas,
assim como a correta indicação das severidades de alarmes
· InitialScreen: Deve ser configurada com o valor "hpFrames.hpInitialFrame", para que seja aberto o Quadro
correto na aplicação
11 Guia Rápido de Configuração

· WindowHeight: Deve ser mantido o valor de 1080 para melhor visualização
· WindowWidth: Deve ser mantido o valor de 1920 para melhor visualização
Guia Rápido de Configuração 12

CAPÍTULO
Como Usar a Biblioteca HighPerformance
4 Template
Esta seção contém informações de uso para os diversos recursos da Biblioteca HighPerformance Template. Os
recursos abordados estão descritos nos tópicos a seguir.
4.1 Menus
Esta seção contém informações sobre o uso de menus na Biblioteca HighPerformance Template.
4.1.1 Uso Individual

Para uso individual dos objetos de menu como Associações Simples, siga estes procedimentos:
1. Instancie o objeto na Tela.
2. Desabilite o recurso de seleção configurando a propriedade DisableSelection do objeto para True.
Desta forma o objeto passa a não mais apresentar o estado de seleção quando clicado, permitindo seu uso individual
como uma Associação Simples.
4.1.2 Barra de Menus

Para usar dois ou mais objetos em grupo como uma barra de menus, em que um dos objetos sempre está
selecionado, siga estes procedimentos:
1. Instancie os objetos diretamente na Tela ou em grupos.
2. Configure a propriedade GroupName dos objetos com o mesmo valor, para que todos pertençam ao mesmo
grupo lógico.
3. Configure a propriedade DisableSelection de todos os objetos do grupo para False e assim habilitar a seleção
de cada objeto.
4.1.3 Alinhamento Automático

Os objetos hpLinkMain, hpLinkDetail, hpLinkIcon e hpScreenNav contam com um recurso de alinhamento
automático, desde que pertençam ao mesmo grupo lógico configurado em suas propriedades GroupName. Com este
recurso é mais fácil posicionar os objetos com alinhamento e distribuição uniforme para que formem um menu.
Objetos sem alinhamento e com distribuição irregular
Objetos alinhados e distribuídos horizontalmente
Para aplicar este recurso, siga estes procedimentos:
1. Instancie cada objeto na Tela.
13 Como Usar a Biblioteca HighPerformance Template

2. Configure a propriedade GroupName de cada um dos objetos para um mesmo valor.
3. Configure a propriedade GroupOrientation de cada um dos objetos em 1 (um) para alinhamento horizontal ou
em 2 (dois) para alinhamento vertical.
4. Configure a propriedade Margin com o valor desejado para o espaçamento entre os objetos.
5. Configure a propriedade GroupElementID de cada objeto, iniciando pelo valor 1 (um) no objeto que inicia o
menu e aumentando sequencialmente para os demais objetos. É importante verificar que o objeto cuja
propriedade GroupElementID seja igual a 1 (um) deve estar na posição exata onde o menu inicia.
6. Clique com o botão direito do mouse no objeto cuja propriedade GroupElementID é igual a 2 (dois) e selecione
a opção Configurar. O objeto é então posicionado de forma a estar alinhado com o objeto anterior.
4.1.4 Propriedade Behaviour

A propriedade Behaviour permite alterar o comportamento padrão do objeto, de acordo com o valor configurado
pelo usuário.
Propriedade Behaviour igual a 0 (zero)
Neste caso, que é o padrão, a funcionalidade do objeto é configurada pelo usuário, incluindo a execução de scripts
quando a propriedade EventClick alterar o seu valor. As seguintes situações podem ser configuradas:
· Se a propriedade DisableSelection é igual a True, ou seja, o objeto não pode ser selecionado, um clique do
mouse apenas altera a propriedade EventClick
· Se a propriedade DisableSelection é igual a False, o objeto está selecionado e a propriedade

EnableClickWhenSelected é igual a True, um clique do mouse apenas altera a propriedade EventClick
· Se a propriedade DisableSelection é igual a False, o objeto está selecionado e a propriedade

EnableClickWhenSelected é igual a False, um clique do mouse não tem nenhum efeito
· Se a propriedade DisableSelection é igual a False e o objeto não está selecionado, desmarca a seleção de todos
os objetos que tenham o mesmo valor na propriedade GroupName, seleciona o objeto clicado, para assegurar o
funcionamento correto do recurso, e altera a propriedade EventClick
Propriedade Behaviour igual a 1 (um)
Neste caso, a funcionalidade do objeto é a de exibir um menu para a seleção do Tema.
Propriedade Behaviour igual a 2 (dois)
Neste caso, a funcionalidade do objeto é a de exibir um menu para a seleção do idioma, caso o módulo Translator
esteja em uso.
Propriedade Behaviour igual a 3 (três)
Neste caso, a funcionalidade do objeto é a de abrir as Telas da aplicação, com registro desta atividade no histórico
de navegação. Para mais detalhes, consulte o tópico Navegação.
Propriedade Behaviour igual a 4 (quatro)
Neste caso, a funcionalidade do objeto é a de abrir Telas pop-ups e modais. Para mais detalhes, consulte o tópico
Abrindo Telas Pop-ups e Modais.
Como Usar a Biblioteca HighPerformance Template 14

4.1.5 Exibindo Ícones
A Biblioteca hpIcons fornece os ícones para os objetos de menus e Associações. Os ícones estão disponíveis na
Galeria do Studio, conforme a figura a seguir.
Biblioteca hpIcons na Galeria
Estes ícones foram concebidos para serem usados com os menus. Para isto, selecione um objeto de menu e configure
suas propriedades IconGallery e IconName com o nome da Biblioteca e o nome do ícone, conforme a figura a
seguir.
Propriedades IconGallery e IconName
No ambiente do Studio o ícone não aparece no objeto, porém em tempo de execução o objeto carrega
automaticamente o ícone configurado.
4.2 Temas
No contexto da Biblioteca HighPerformance Template, um Tema é uma seleção funcional de cores e
comportamentos aplicados aos elementos da interface gráfica da aplicação durante a execução.

A função Temas organiza internamente as cores e os comportamentos de forma estruturada em um Tema. Primeiro
define os elementos básicos, depois organiza-os em grupos funcionais, estabelece regras para atribuição dos valores
e finalmente vincula-os com um Tema específico.
A estrutura interna dos elementos relacionados às cores é a seguinte:
· Cores Semânticas e Contextuais
· Paletas de Cores (Color Palettes)
· Regras de Atribuição de Cores (Color Rules)
· Esquemas de Cores (Color Schemes)
A estrutura interna dos elementos relacionados aos comportamentos é a seguinte:
· Comportamentos (Behaviors)
· Grupos de Comportamentos (Behavior Groups)
· Regras de Atribuição de Comportamentos (Behavior Rules)
· Esquemas de Comportamentos (Behavior Schemes)
4.2.1 Cores Semânticas e Contextuais

A função Temas realiza a interface entre sistemas muito distintos, criando definições em um contexto de design e
aplicando-as em um contexto de engenharia. Devido a isto, as cores são denominadas de acordo com uma
terminologia semântica e outra contextual.
A denominação Semântica é mais relevante no ambiente artístico de design. Nomes como A500, 950 ou X300 dão ao
designer informações sobre os canais Matiz (Hue), Saturação (Saturation) e Luminosidade (Lightness) de uma cor. Desta
forma, o profissional de design tem uma referência consistente para a configuração e aplicação.
Já a denominação Contextual faz mais sentido no ambiente técnico de engenharia. Nomes como ColorDeviceOn,
ColorAlarmActive ou ColorCommandDisabled dão ao técnico uma referência consistente dentro do contexto de
trabalho.
4.2.2 Paletas de Cores (Color Palettes)

Uma Paleta de Cor (Color Palette) é um grupo de cores que possuem uma característica funcional em comum. Nos
Temas da Biblioteca HighPerformance Template há Paletas do tipo System e Custom.
4.2.2.1 Paleta System

As Paletas System contêm Cores definidas no contexto da Biblioteca HighPerformance Template e não devem ser
alteradas. Os tipos existentes são Monocromáticas (Monochrome) e Policromáticas (Polychrome).
As Paletas Monocromáticas contêm Cores de mesmo matiz, variando apenas a saturação e luminosidade. Na
Biblioteca HighPerformance Template são denominadas Paletas Funcionais e são utilizadas com as seguintes
funções:
· Primary: Paleta primária que dá a coloração aos objetos de interface que não exijam uma atenção especial do
operador, ou seja, que demandem nível de neutralidade de atenção
· Accent: Paleta com Cores de destaque para objetos de interface que exijam um nível maior de atenção ou cuja
função se destaque dos demais elementos de interface
· Scada-Source: Paleta com Cores destinadas aos objetos que exibem valores ou estados provenientes de uma
fonte Scada

· Operator-Source: Paleta com Cores destinadas aos objetos que exibem valores ou estados provenientes de uma
fonte Operator
· Simulator-Source: Paleta com Cores destinadas aos objetos que exibem valores ou estados provenientes de uma
fonte Simulator
· Events: Paleta com Cores destinadas aos objetos que exibem valores ou estados classificados como Eventos
· Warn-Severity-0: Paleta com Cores destinadas aos objetos que exibem valores ou estados classificados como
Alarmes de Severidade 0 (zero, Crítica)
Alarmes de Severidade 1 (um, Alta)
Alarmes de Severidade 2 (dois, Média)
Alarmes de Severidade 3 (três, Baixa)
· Grayscale: Paleta composta por tons de cinza, variando entre o preto como a menor intensidade e o branco
como maior intensidade
A estrutura das Paletas Monocromáticas é definida da seguinte forma:
· Cores Dark e Light: São as Cores de maior contraste na Paleta
· Cores 950 a 050: São as Cores intermediárias entre Dark (Escuro) e Light (Claro), variando da mais escura (950)
até a mais clara (050), em que a Cor 500 é a cor de referência da Paleta
· Cores A500 a A100: São Cores de destaque, normalmente mais saturadas do que as correspondentes na Paleta
Já as Paletas Policromáticas podem conter Cores de diferentes matizes. A princípio são usadas para colorir a
representação das linhas de processo ou as Penas de um gráfico. A estrutura das Paletas Policromáticas é definida da
seguinte forma:
· Cores X000, X020, X040 até X340: O prefixo X indica uma Cor do tipo System Polychrome, enquanto o sufixo
numérico indica o valor do matiz dentro do círculo cromático entre 0 (zero) e 360°
4.2.2.2 Paleta Custom

As Paletas Custom contêm Cores definidas no contexto de uma aplicação e podem ser configuradas pelo usuário.
Estas Cores não possuem nenhuma restrição quanto aos valores de matiz, saturação ou luminosidade. A estrutura das
Paletas Custom é definida da seguinte forma:
· Cores C001, C002 até C020: O prefixo C indica uma Cor do tipo Custom, enquanto o sufixo numérico é serial e
serve apenas para diferenciar cada Cor
4.2.2.3 Repositório
Todas as Paletas de Cores devem ser armazenadas na pasta hpObjects - Themes - Repository, na respectiva sub-
pasta, e denominadas conforme os tópicos a seguir. As Paletas devem ser objetos do tipo ~hpColorPalette e as
Cores instanciadas devem ser do tipo ~hpColor.
4.2.2.3.1 Paleta System Monochrome
As Paletas System Monochrome devem ser armazenadas na pasta hpObjects - Themes - Repository - Palettes -
System - Monochrome. O formato de nome deve ser HnnnSnnn, em que Hnnn indica o valor do canal Hue (Matiz),
que varia entre 0 (zero) e 360°, e Snnn indica o valor do canal Saturation (Saturação), que varia entre 0 (zero) e 100%.

Por exemplo, o valor "H060S040" refere-se a uma Paleta em que a Cor 500 de referência possui o canal Hue (Matiz)
igual a 60° e o canal Saturation (Saturação) igual a 40%.
4.2.2.3.2 Paleta System Polychrome
As Paletas System Polychrome devem ser armazenadas na pasta hpObjects - Themes - Repository - Palettes -
System - Polychrome. O formato de nome deve ser PolyNNN, em que NNN indica um sufixo numérico serial
identificador da Paleta. Por exemplo, o valor "Poly003" refere-se a uma Paleta Policromática com identificador igual a
"003".
4.2.2.3.3 Paleta Custom
As Paletas Custom devem ser armazenadas na pasta hpObjects - Themes - Repository - Palettes - Custom. O
formato de nome deve ser CustomNNN, em que NNN indica um sufixo numérico serial identificador da Paleta. Por
exemplo, o valor "Custom003" refere-se a uma Paleta personalizada com identificador igual a "003".
4.2.2.3.4 Paleta Funcional
As Paletas Funcionais são armazenadas no objeto hpTheme e não devem ser alteradas. As Paletas disponíveis são
Primary, Accent, Scada-Source, Operator-Source, Simulator-Source, Events, Warn-Severity-0, Warn-Severity-1,
Warn-Severity-2, Warn-Severity-3 e Grayscale.
4.2.3 Regras de Atribuição de Cores (Color Rules)

Uma Regra de Atribuição de Cores (Color Rule) é uma regra que associa uma Paleta Funcional a uma Cor, e é definida
da seguinte forma:
· Nome da regra: [Cor contextual]
· Formato: [Paleta funcional]/[Cor semântica]
Por exemplo, para colorir um objeto com o estado LIGADO vindo de uma fonte SCADA e usando a Cor 500, pode ser
criada a seguinte regra:
· Nome da regra: ColorStatusOn
· Regra: Scada-Source/500
Isto significa que um objeto exibe a Cor 500 da Paleta Funcional Scada-Source para representar o estado LIGADO. Em
seguida aplica-se a regra por associação ou script a uma propriedade do objeto que seja do tipo Cor, como por
exemplo ForegroundColor. O objeto configurado desta forma é automaticamente sensível aos Temas.
As Regras de Atribuição de Cores estão disponíveis para uso na pasta Viewer - hpControls - Template.
4.2.3.1 Escopo de Aplicação

As Regras de Atribuição de Cores são nativamente válidas para todos os Temas cadastrados na função, ou seja, o
escopo nativo é global. No entanto, pode-se aplicar um valor diferenciado de uma Regra em um Tema específico,
configurando assim um escopo local para aquela Regra. Isto é particularmente útil para condições muito específicas
de um determinado Tema, ou para a realização de testes antes de validar globalmente uma nova configuração.
4.2.4 Esquemas de Cores (Color Schemes)

Um Esquema de Cores (Color Scheme) é um grupo de Paletas de Cor selecionadas do repositório de Paletas e
engloba as Paletas Funcionais, Policromáticas e Personalizadas.

4.2.5 Comportamentos (Behaviors)
Um Comportamento (Behavior) é uma entidade que descreve um comportamento desejado na interface vinculada ao
Tema selecionado e o valor é do tipo de dados Boolean. Exemplos de Comportamentos que podem ser
implementados são os seguintes:
· Piscar o texto de alarme ativo no objeto E3Alarm
· Destacar a cor de um equipamento ao passar o mouse
· Exibir menus de seleção no formato de menu contextual
· Exibir a foto do usuário autenticado em uma aplicação
· Exibir data e hora no cabeçalho
· Usar cor negativa para logotipos em Temas escuros
· Posicionar um logotipo do lado direito
· Exibir cantos arredondados
· Destacar linhas de processo
· Exibir contornos de equipamentos
Desta forma, pode-se configurar Temas que afetem não apenas as Cores, mas também a exibição das formas e
comportamentos dos diversos elementos de interface.
4.2.5.1 Denominação
Recomenda-se adotar um padrão de denominação para os Comportamentos no formato [Ação a ser executada]
[Propriedade afetada][Objeto afetado][Contexto ou Gatilho da ação]. Um exemplo de denominação de
Comportamento para exibir o contorno de equipamentos é o seguinte:
· [Ação]: Show
· [Propriedade afetada]: Border
· [Objeto afetado]: All Devices, em que All pode ser omitido
· [Contexto]: Always, que pode ser omitido
Este padrão resulta no nome de Comportamento ShowBorderDevice.
Outro exemplo, agora de um Comportamento para destacar a Cor de preenchimento de um objeto Bomba ao passar
o mouse:
· [Ação]: Accent
· [Propriedade afetada]: ForegroundColor
· [Objeto afetado]: Pump
· [Contexto]: Mouse Over
Este padrão resulta no nome de Comportamento AccentFgColorPumpMouseOver.
Este modelo de denominação não é obrigatório, mas visa facilitar a identificação de um Comportamento através de
um padrão consistente.

4.2.6 Grupos de Comportamentos (Behavior Groups)
Um Grupo de Comportamentos (Behavior Groups) é um agrupamento de todos os Comportamentos cadastrados na
função Temas.
4.2.6.1 Repositório
Todos os Comportamentos devem ser objetos do tipo ~hpBehavior e instanciados na pasta hpObjects - Themes -
Repository - Behaviors dentro de Grupos com objetos do tipo ~hpBehaviorGroup. Todos os Grupos devem ter os
mesmos Comportamentos, em nome e número de objetos, variando apenas o valor de cada um.
4.2.7 Regras de Atribuição de Comportamentos (Behavior Rules)

Uma Regra de Atribuição de Comportamentos (Behavior Rule) é uma regra que armazena em si um valor com o tipo
de dados Boolean. O nome da Regra de Atribuição tem o mesmo nome do Comportamento.
Por exemplo, o Comportamento AccentFgColorPumpMouseOver, descrito anteriormente, que regula o destaque da

Cor de preenchimento do objeto Bomba quando o mouse passa sobre este objeto, é vinculado à Regra de mesmo
nome e pode ter um valor Verdadeiro em um Grupo de Comportamentos e Falso em outro Grupo.
Como cada Grupo de Comportamentos é vinculado a um Tema diferente, um Tema exibe a Cor de destaque ao
passar o mouse sobre uma Bomba, enquanto outro Tema exibe a Cor padrão do objeto sob o mesmo evento.
Em uma aplicação, esta funcionalidade deve ser configurada no nível de objeto, e o Comportamento tem o simples
papel de uma variável, que pode ser aplicado ao objeto através de uma Associação ou um script.
As Regras de Atribuição estão disponíveis para uso na pasta Viewer - hpControls - Template.
4.2.8 Esquemas de Comportamentos (Behavior Schemes)

Um Esquema de Comportamento (Behavior Scheme) é usado para associar um Grupo de Comportamentos a um
determinado Tema. A função é análoga à função dos Esquemas de Cores, mas ao invés de associar diversos
elementos a um Tema, associa apenas o Grupo de Comportamentos selecionado.
4.2.9 Editando Temas com o Theme Factory

O Theme Factory é a interface para edição de temas da Biblioteca HighPerformance Template e pode ser
acessado através do objeto hpThemePicker, conforme os passos a seguir:
1. Em tempo de execução, abra a Tela onde está instanciado o objeto hpThemePicker.
2. Clique na seta seletora ao lado deste controle.
3. Selecione a opção Theme Factory.
NOTA
Caso a opção Theme Factory não esteja visível, certifique-se de que o valor da propriedade
ShowThemeFactoryLink está configurado para Verdadeiro.
4.2.9.1 Publicando Alterações

Após editar um Tema e salvar as alterações usando o Theme Factory, é necessário atualizar as definições no Studio e
publicá-las no Viewer para que sejam visíveis. Para isto, execute os procedimentos a seguir.
Atualização das Definições no Projeto
1. Pare a execução do Viewer.

2. Acesse a aplicação pelo Studio.
3. No Organizer, localize o arquivo de projeto hpMain.prj.
4. Clique com o botão direito do mouse no projeto e selecione a opção Atualizar.
Publicação no Viewer
1. Selecione o objeto ~hpThemePublisher na pasta hpObjects - Themes.
2. Clique com o botão direito do mouse no objeto e selecione a opção Configurar.
3. Após a publicação é exibida uma mensagem de confirmação.
4. Execute novamente o Viewer para visualizar as alterações.
4.2.10 Alterando o Tema ou Modo Corrente

Para alterar o Tema ou Modo corrente, escreva o comando no Tag loadTheme no item Viewer - hpControls -
Template. Este Tag aceita comandos do tipo String no formato [ThemeName]/[Mode]. Sempre que o valor é
alterado ocorre a troca do Tema e do Modo selecionado. Um exemplo de comando para carregar o Tema Grayscale
no Modo Dark é "Grayscale/Dark". Um exemplo de comando para carregar o Tema Iris no Modo Light é "Iris/Light".
4.2.11 Identificando o Tema ou Modo Corrente

Para identificar o Tema ou Modo selecionados durante a execução de uma aplicação, leia o valor do Tag loadTheme
no item Viewer - hpControls - Template.
4.2.12 Obtendo Resultados Melhores na Aplicação de um Tema

Os tópicos a seguir contêm informações sobre Cor de Tela e Contraste com Objetos, Botões de Comando e
Lógicos e Consistência entre Cor e Função.
4.2.12.1 Cor da Tela e Contraste com Objetos

Para configurar a cor de fundo de uma Tela, prefira as Regras de Atribuição de Cores (Color Rules) descritas nos
tópicos a seguir.
4.2.12.1.1 ColorScreenBackground
Deve ser a Cor de fundo da Tela. A luminosidade a deixa mais clara em Temas claros e mais escura em Temas
escuros, proporcionando um contraste ideal com os elementos instanciados na Tela. Indicada para ser usada sob
objetos de menus, tais como os objetos hpLyraMenu, hpLinkMain, hpLinkDetail e hpLinkIcon, e objetos do tipo
hpCard.
A figura a seguir mostra um exemplo de uso da Regra ColorScreenBackground como Cor de fundo com objetos de
menu ao lado.
ColorScreenBackground com objetos de menu
A figura a seguir mostra um exemplo de uso da Regra ColorScreenBackground como Cor de fundo com um objeto
hpCard ao lado.

ColorScreenBackground com objetos hpCard
4.2.12.1.2 ColorScreenMiddleground
Deve ser a Cor intermediária entre a Regra ColorScreenBackground e os elementos instanciados na Tela. Ideal para
ser usada sob objetos que usem Cores da Paleta Funcional Scada-Source.
O objeto hpCard utiliza esta Cor para criar uma área de agrupamento de objetos funcionalmente correlacionados.
A figura a seguir mostra um exemplo de uso de um objeto hpCard sobre Tela usando a Regra
ColorScreenBackground em fundo claro.
ColorScreenBackground em fundo claro
A figura a seguir mostra um exemplo de uso de um objeto hpCard sobre Tela usando a Regra
ColorScreenBackground em fundo escuro.
ColorScreenBackground em fundo escuro
4.2.12.1.3 Otimização de Contraste com Objetos que Exibem Estados
Um exemplo de contraste insuficiente pode ser visto na figura a seguir com um objeto exibindo o estado LIGADO e
instanciado diretamente sobre a Tela com a Regra ColorScreenBackground.

Contraste insuficiente
Se este mesmo objeto é instanciado sobre um objeto hpCard, observa-se uma pequena melhora no contraste com o
fundo, conforme a figura a seguir.
Contraste entre objeto e fundo
O ganho de contraste proporcionado pelo uso do objeto hpCard neste caso é apenas uma consequência bem-vinda
do real propósito, que é ressaltar uma área que contenha um objeto sensível ao processo ou mais relevante na
interface, e indicar visualmente um grupo de objetos que guardem uma relação entre si.
Para melhorar o contraste ainda mais, sugere-se a adoção de algum elemento que destaque o objeto do fundo, como
por exemplo um contorno, mostrado na figura a seguir.
Contraste otimizado com o uso de

contorno
4.2.12.1.4 Otimização de Contraste com Objetos Ilustrativos
Uma das principais premissas das interfaces de alto desempenho visual é reduzir o destaque de elementos
secundários ou menos importantes e aumentar o destaque de elementos primários ou mais importantes.
Os objetos ilustrativos devem ser representados sempre com o menor contraste possível em relação ao fundo,

Ilustração 2D com baixo contraste
Ilustração 3D com baixo contraste
A aplicação de demonstração da Biblioteca HighPerformance Template contém alguns exemplos deste tipo de
ilustração.
4.2.12.2 Botões de Comando e Lógicos

Os objetos do tipo hpCommandButton foram desenhados para uso exclusivo de comandos de processo. Para uso
de lógicas de interface, scripts ou atribuições de valores em nível de interface, prefira o objeto hpLogicButton.
4.2.12.3 Consistência entre Cor e Função

A Cor exibida por um objeto deve indicar a função ou escopo de ação deste objeto. É uma forma eficiente de indicar
ao usuário o contexto do objeto com baixíssimo custo cognitivo, sem a necessidade de acessar menus ou qualquer
conteúdo de ajuda.
Assim, sempre que um objeto personalizado use dados de um processo, indique ao menos uma Cor da Paleta Scada-
Source em algum elemento neste objeto.
Da mesma forma, no caso de uso de dados digitados por um operador do sistema, indique ao menos uma Cor da
Paleta Operator-Source em algum elemento neste objeto.
Caso o objeto trate dados de simulação, indique ao menos uma Cor da Paleta Simulator-Source em algum elemento
neste objeto.
A mesma lógica serve para as Paletas de alarme, Warn-Severity-0, Warn-Severity-1, Warn-Severity-2 e Warn-
Severity-3, e para a Paleta Events.
4.3 Navegação
Diversos objetos da Biblioteca HighPerformance Template possuem a funcionalidade de abertura de Telas ou
janelas pop-ups. Alguns objetos são exclusivos para estas funcionalidades, tais como hpPopupOpen e hpScreenOpen,

enquanto outros acumulam outras funções além destas, selecionáveis através de sua propriedade Behaviour. Neste
caso, para efeito de navegação e abertura de Telas, deve-se optar pelo valor adequado nesta propriedade.
4.3.1 Principais Recursos

A função de navegação da Biblioteca HighPerformance Template oferece os seguintes recursos:
· Abertura simultânea de um conjunto de Telas e Monitores com um único comando
· Criação de Perfis de Navegação para múltiplas estações, com base no cenário de execução de cada estação
· Configuração intuitiva de matrizes de Monitores com até 99 Monitores
· Configuração hierárquica de navegação, em forma de árvore, simples e intuitiva
· Quadros adaptáveis a diferentes configurações
4.3.2 Entidades de Navegação

Uma Entidade de Navegação é um objeto que pode ser aberto através de um comando de navegação. As Entidades
de Navegação definidas na Biblioteca HighPerformance Template são Tela, Template e Perfil.
Tela
A Tela é uma Entidade de Navegação mais elementar, visualizada dentro de objetos FrameSet do Elipse E3 ou Elipse
Power.
Template
Um Template de navegação é um arranjo ou conjunto de objetos do tipo FrameSet contendo Telas que compõem a
visualização completa de um único Monitor.
Um Monitor pode ter vários Templates diferentes configurados, porém só pode exibir um Template de cada vez. Por
exemplo, pode exibir um Template de uma única Tela como Tela inicial da aplicação, e em seguida exibir outro
Template contendo Telas operativas em um arranjo de cabeçalho, menu de navegação ou rodapé, entre outros. A
imagem a seguir contém um exemplo de um Template contendo quatro Telas dispostas em um cabeçalho, menu
lateral, rodapé e Tela principal.
Exemplo de Template
Perfil
Um Perfil é uma Entidade de Navegação mais completa, abrangendo todos os Monitores definidos na matriz de
Monitores, os Templates de cada Monitor e as Telas de cada Template. A figura a seguir contém um exemplo de um
Perfil definido por 3 (três) Monitores de uma matriz 1x3, e cada monitor contém um Template diferente com as
respectivas Telas.

Exemplo de Perfil
4.3.3 Exemplo de Configuração

A função de navegação disponibilizada pela Biblioteca HighPerformance Template pode ser configurada com base
tanto nos cenários onde uma aplicação é executada em diferentes estações quanto em tarefas pré-definidas na
mesma estação. Este exemplo ilustra uma configuração baseada em diferentes cenários, por ser mais abrangente.
Considere uma aplicação executada em 3 (três) ambientes distintos, Sala de Operação, Centro de Controle e Estação
de Manutenção (notebook). Cada cenário destes é representado, na estrutura de navegação, por um Perfil, ou Profile,
exclusivo que possui o próprio arranjo de Monitores:
· Perfil da Sala de Operação: Matriz 1x2 de Monitores
· Perfil do Centro de Controle: Matriz 2x3 de Monitores
· Perfil da Estação de Manutenção: Matriz 1x1 de Monitores
Cada Monitor em um Perfil de Navegação exibe os próprios Templates de Quadros, ou arranjos de Quadros. Neste
exemplo são considerados 3 (três) modelos:
· Template "Home" para a Tela inicial da aplicação, contendo um cabeçalho e uma Tela principal
· Template "Operation" para Telas operativas, contendo cabeçalho, rodapé, menu de navegação lateral e Tela
principal
· Template "Reports" para exibição de relatórios, contendo cabeçalho, menu de navegação lateral e Tela principal
Quadro resumo do exemplo
CENÁRIO SALA DE OPERAÇÃO CENTRO DE CONTROLE ESTAÇÃO DE

MANUTENÇÃO
Nome do Perfil OperationRoom ControlCenter Maintenance
Matriz de monitores
Templates
Home Home Operation
Operation Reports Reports

CENÁRIO SALA DE OPERAÇÃO CENTRO DE CONTROLE ESTAÇÃO DE
MANUTENÇÃO
Reports
Estrutura de Navegação
Os Perfis de Navegação, junto com a correspondente estrutura, devem ser criados na pasta hpObjects - Navigation -
Profiles usando a classe hpNavProfile, conforme a figura a seguir.
Objetos hpNavProfile
Na classe hpNavProfile, configure as seguintes propriedades:
· AuthorizedComputers: Lista de computadores autorizados a acessar o Perfil
· MonitorsMatrix: Matriz de Monitores do Perfil
· ViewerHeight e ViewerWidth: Altura e largura que o Viewer assume no Perfil
O primeiro nível hierárquico a ser criado abaixo de um Perfil é composto por cada um dos Monitores, usando a
classe hpNavMonitor, conforme a figura a seguir.

Objetos hpNavMonitor
Neste exemplo, a matriz de Monitores do Perfil ControlCenter é 2x3 e, portanto, requer 6 (seis) Monitores. Para o
Perfil OperationRoom são necessários 2 (dois) Monitores, ou seja, uma matriz 1x2, enquanto o Perfil Maintenance
requer somente 1 (um) Monitor, ou seja, uma matriz 1x1.
A numeração dos monitores cresce da esquerda para a direita e de cima para baixo na matriz de monitores,
Ordem da numeração de monitores
Na classe hpNavMonitor deve ser configurada a propriedade StartupTemplateName, que é o nome do Template
exibido ao iniciar a exibição, e que pode ser também uma String vazia para considerar o primeiro filho deste objeto
como Template de inicialização.
O nível seguinte aos Monitores é composto por cada um dos arranjos de Quadros que são usados no respectivo
Monitor, usando a classe hpNavTemplate, conforme a figura a seguir.

Objetos hpNavTemplate
Na classe hpNavTemplate deve ser configurada a propriedade PanelsConfig, de forma automática, através da
execução do Assistente de Configuração de Navegação.
O último nível é composto pela classe hpNavFrameSet, que representa um Quadro dentro de cada Template,
Objetos hpNavFrameSet
Na classe hpNavFrameSet devem ser configuradas as propriedades SplitLink, um link para abertura de Tela e
SplitValue, o valor do Divisor. Com isto, a hierarquia completa de classes da estrutura de navegação é a seguinte:
· Classe hpNavProfile, Perfil de Navegação
· Classe hpNavMonitor, Monitor

· Classe hpNavTemplate, Modelo de Quadros
· Classe hpNavFrameSet, Quadro
Quadros em hpFrames
A estrutura de navegação deve ser suportada pelos Quadros na pasta hpFrames. Os Templates deste exemplo,
Home e Reports, são usados em uma matriz 2x3, exigindo assim 6 (seis) Quadros. Já o Template Operation é usado
em uma matriz 1x2, portanto deve ter 2 (dois) Quadros. Com isto, a estrutura de Quadros na pasta hpFrames é
mostrada na figura a seguir.
Pasta hpFrames
Os nomes dos Quadros na pasta hpFrames devem sempre terminar com um sufixo numérico de 2 (dois) dígitos, um
indicador do respectivo Monitor. Estes objetos devem ser copiados do arquivo hpFrames_Repository.prj, que está
disponível na distribuição da Biblioteca HighPerformance Template.

Arquivo hpFrames_Repository.prj
Neste arquivo, copie o Quadro hpNavTemplate01 do repositório para a pasta hpFrames na aplicação, renomeie e
copie o número necessário de Quadros para cobrir o número de Monitores onde o Template é usado.
4.3.4 Abrindo uma Entidade de Navegação

Os seguintes objetos da Biblioteca HighPerformance Template podem ser usados para abrir uma Entidade de
Navegação:
· hpLyraData
· hpLinkDetail
· hpLinkIcon
· hpLinkMain
· hpPageReference
· hpScreenOpen
As propriedades de navegação destes objetos são as seguintes:
· OpenScreenCode: Código para abertura de Tela
· scrMonitorSelection: Indicação do Monitor para abertura de Tela ou Template
· scrProfile: Indicação do Perfil a ser aberto
· scrTemplate: Indicação do Template a ser aberto
Abrindo um Perfil
Para abrir um Perfil, configure a propriedade scrProfile com o nome de um objeto hpNavProfile. Neste caso, as
demais propriedades não são consideradas e o Perfil é aberto a partir da última configuração. Um exemplo de
configuração de propriedades para abrir um Perfil chamado "OperationRoom" seria o seguinte:
· scrMonitorSelection: -1 (menos um)
· scrProfile: OperationRoom

Abrindo um Template
Para abrir um Template, configure a propriedade scrTemplate com o nome de um objeto hpNavTemplate. Um
exemplo de configuração de propriedades para abrir um Template chamado "Operation" no Monitor onde ocorreu o
clique do mouse seria o seguinte:
· scrMonitorSelection: 0 (zero)
· scrTemplate: Operation
Um exemplo de configuração de propriedades para abrir um Template chamado "Reports" no Monitor 2 (dois) seria
o seguinte:
· scrMonitorSelection: 2 (dois)
· scrTemplate: Reports
Abrindo uma Tela
Para abrir uma Tela, configure a propriedade OpenScreenCode no formato a seguir.

Frame1{Tela?N?N?N,Arg};Frame2{Tela?N?N?N,Arg};...;FrameN{Tela?N?N?N,Arg}
O parâmetro Arg é opcional. Um exemplo de configuração de propriedades para abrir uma Tela chamada
"Arquitetura" em um Quadro chamado "hpFSMain" no Monitor onde ocorreu o clique do mouse seria o seguinte:
· scrMonitorSelection: 0 (zero)
· OpenScreenCode: hpFSMain{Arquitetura?1?0}
Para abrir esta mesma Tela, porém no Monitor 1 (um), a configuração das propriedades seria a seguinte:
· scrMonitorSelection: 1 (um)
· OpenScreenCode: hpFSMain{Arquitetura?1?0}
Para abrir uma Tela por script, configure um array com 5 (cinco) elementos, conforme o código a seguir.
Dim cmd(4)
cmd(0) = "" 'OpenScreenCode
cmd(1) = "" 'scrProfile
cmd(2) = "" 'scrTemplate
cmd(3) = 0 'scrMonitorSelection
cmd(4) = Frame.PathName
O elemento 0 (zero) é reservado para o valor da propriedade OpenScreenCode, o elemento 1 (um) é reservado para
o nome do Perfil de Navegação, o elemento 2 (dois) é reservado para o nome do Template, o elemento 3 (três) é
reservado para o valor da propriedade scrMonitorSelection e o elemento 4 (quatro) deve ser sempre igual a
Frame.PathName.
Em seguida, atribua este array ao Tag OpenEntity no Viewer, conforme o código a seguir.
Set openEntity = Application.Item("hpControls").Item("Navigation").Item("OpenEntity")
openEntity.Value = cmd
Este mesmo procedimento pode ser escrito de forma reduzida conforme o código a seguir.
Set openEntity = Application.Item("hpControls").Item("Navigation").Item("OpenEntity")
openEntity.Value = Array("","","",0,Frame.PathName)

Exemplo de array de comando para abrir o Perfil Perfil1:
Array("","Perfil1","",0,Frame.PathName)
Exemplo de array de comando para abrir o Template hpFrameHeader:

Array("","","hpFrameHeader",0,Frame.PathName)
Exemplo de array de comando para abrir a Tela "Telas.Arquitetura?1?0" no FrameSet hpFSMain do Monitor 03:
Array("hpFSMain{Telas.Arquitetura?1?0}","","",3,Frame.PathName)
4.3.5 Quadros Adaptativos

O Quadro adaptativo hpNavTemplate01 está disponível no arquivo de projeto hpFrames_Repository, na pasta
hpFrames_v2.5_Adaptive, conforme a figura a seguir.
Quadro adaptativo no repositório de Quadros
Este Quadro possui uma estrutura de Divisores pré-definida, que permite configurar diferentes Templates usando um
mesmo objeto, sem a necessidade de alterar a estrutura interna.
Estrutura Interna
O Quadro adaptativo oferece uma hierarquia bem estabelecida de objetos FrameSet, organizada em 4 (quatro) níveis
ou camadas de navegação, que variam do contexto mais abrangente no nível 0 (zero) ao contexto mais específico, no
nível 3 (três).
Cada nível, por sua vez, é uma célula formada por 4 (quatro) objetos FrameSet dispostos em forma de moldura ao
redor do Quadro principal, onde são exibidas as Telas do processo:
· Quadro lateral esquerdo, hpFSLevel-N-Left, para menus de navegação
· Quadro superior, hpFSLevel-N-Top, para cabeçalhos com títulos ou submenus
· Quadro inferior, hpFSLevel-N-Bottom, para rodapés
· Quadro lateral direito, hpFSLevel-N-Right, para painéis de detalhes, informações complementares e configuração
de parâmetros

Objetos FrameSet compondo um nível ou camada de navegação
Os níveis 1 (um), 2 (dois) e 3 (três) apresentam esta mesma estrutura em forma de moldura e se sobrepõem,
Estrutura de objetos FrameSet em formato de moldura
Cada cor indica a área de propagação da informação. Por exemplo, no Quadro hpFSLevel-1-Left, o usuário realiza
uma seleção no menu e esta seleção deve ser propagada para os demais Quadros da mesma cor ou nível, que são
hpFSLevel-1-Top, hpFSLevel-1-Bottom e hpFSLevel-1-Right.
Neste exemplo, se o usuário seleciona a Área 5 (cinco) no menu do Quadro hpFSLevel-1-Left, então:
· O Quadro hpFSLevel-1-Top deve exibir o cabeçalho com título ou submenu relativo à Área 5 (cinco)
· O Quadro hpFSLevel-1-Bottom deve exibir o rodapé relativo à Área 5 (cinco)
· O Quadro hpFSLevel-1-Right deve exibir o painel de detalhes ou configuração relacionados à Área 5 (cinco)
Se a Área 5 (cinco) é composta por regiões menores, cabe ao Quadro hpFSLevel-2-Left exibir o menu destas regiões,
ao Quadro hpFSLevel-2-Top o cabeçalho da região selecionada, ao Quadro hpFSLevel-2-Bottom o rodapé, e assim
sucessivamente.
O nível 0 (zero) de navegação é o mais abrangente de todos e é composto pelos seguintes Quadros:
· Quadros superiores, hpFSMaster e hpFSLevel-0-Top
· Quadro inferior, hpFSLevel-0-Bottom

· Quadro lateral direito, hpFSLevel-0-Right
· Quadro central, hpFSMain
Nível zero de navegação
Os objetos hpFSMaster e hpFSMain são sempre visíveis em todas as camadas. O objeto hpFSMaster é um cabeçalho
geral, e a função é exibir informações que tenham contexto válido por toda a aplicação, tais como o logotipo da
empresa ou o usuário autenticado. Já o objeto hpFSMain deve exibir as Telas principais de uma aplicação. A
integração de todos os níveis é mostrada na figura a seguir.
Visão integral de um Quadro adaptativo
Estrutura Hierárquica
A estrutura hierárquica de um Quadro adaptativo é construída de forma que a visualização de um nível inferior
sempre dependa da visualização prévia dos níveis superiores correspondentes. Assim, ao selecionar um Quadro para
que este seja visível no Viewer, obrigatoriamente os Quadros do tipo hpFSLevel-N-Left, correspondentes aos menus
de navegação nos níveis superiores, também passam a ser visíveis.

Estrutura interna simplificada
de um Quadro adaptativo
Por exemplo, a seleção do rodapé do nível 1 (um), hpFSLevel-1-Bottom, automaticamente seleciona o Quadro
hpFSLevel-1-Left com o menu de navegação do nível 1 (um) mais o Quadro hpFSMaster, que é sempre visível.
A visibilidade de um FrameSet
depende da visibilidade dos níveis
superiores
Este recurso favorece a construção de uma navegação estruturada por níveis hierárquicos de forma consistente.
4.3.6 Quadros Pré-Definidos

A seguir são mostrados os Templates de Quadros do tipo Preset (Pré-Definidos) disponíveis na Biblioteca
HighPerformance Template. As figuras estão organizadas por Quadro dominante, isto é, pelo Quadro que atravessa
a Tela de uma extremidade a outra.

Conteúdo dominante

Quadros superiores e inferiores dominantes

Somente o Quadro superior dominante

Somente o Quadro inferior dominante

Quadro lateral dominante
No Studio, abra o repositório de Templates de Quadros hpframes_repository.prj, situado na pasta

HighPerformance/Projects, sem adicioná-lo ao Domínio, conforme a figura a seguir.

Template hpframes_repository.prj
Na pasta hpFrames_v2.5_Preset, copie os Templates que vão ser usados pela aplicação para a pasta Visualização -
Viewer e Quadros - hpFrames, lembrando que o sufixo numérico de cada Template relaciona-se com o número de
monitores usados na aplicação. Assim, se houver um cenário em que são usados 8 (oito) monitores, como por
exemplo uma matriz 2x4, devem ser copiados os Templates ou Quadros numerados de 01 até 08.
Algumas considerações sobre os Quadros existentes em cada Template:
· hpFrameSetContent: Presente em todos os Templates, representa a área de conteúdo ou a área que recebe a
Tela principal da aplicação. O nome da Tela a ser aberta neste Quadro deve ser configurado na propriedade
scrContent, disponível nos objetos de navegação
· hpFrameSetMaster: Usado em diversos Templates, tanto como cabeçalho ou rodapé. Pode ser usado para
acomodar um menu ou um objeto de alarme, por exemplo. O nome da Tela a ser aberta neste Quadro deve ser
configurado na propriedade scrMaster, disponível nos objetos de navegação
· hpFrameSetMenu: Concebido para acomodar menus ou árvores de navegação (TreeViews). O nome da Tela a ser
aberta neste Quadro deve ser configurado na propriedade scrMenu, disponível nos objetos de navegação
· hpFrameSetHeader e hpFrameSetFooter: Função idêntica ao Quadro hpFrameSetMaster. A diferença aqui é que

ambos existem no mesmo Template, ao contrário de hpFrameSetMaster, que assume o papel de cabeçalho ou
rodapé separadamente em cada Template. O nome da Tela a ser aberta nestes Quadros deve ser configurado
nas propriedades scrHeader e scrFooter, respectivamente, disponíveis nos objetos de navegação
· hpFrameSetLeft e hpFrameSetRight: Função idêntica ao Quadro hpFrameSetMenu. A diferença aqui é que

ambos existem no mesmo Template, ao contrário de hpFrameSetMenu, que assumia o papel de menu esquerdo
ou menu direito separadamente em cada Template. O nome da Tela a ser aberta nestes Quadros deve ser
configurado nas propriedades scrLeft e scrRight, respectivamente, disponíveis nos objetos de navegação

4.3.7 Migração da Navegação Preset para a Adaptive
Este roteiro visa auxiliar a migração da estrutura de navegação que utiliza Quadros do tipo Preset para Quadros do
tipo Adaptive.
Os Quadros do tipo Preset são aqueles usados pela Biblioteca HighPerformance Template nas versões anteriores à
versão 2.5, como por exemplo os Templates hpFrameHeader e hpFrameHeaderMenuLeft.
1. Na pasta hpFrames, copie os Quadros adaptativos do arquivo repositório para o projeto hpMain.prj. Para
navegação com Quadros adaptativos, estes devem ser selecionados da pasta hpFrames_v2.5_Adaptive e
renomeados na aplicação para o mesmo nome usado nos respectivos objetos hpNavTemplate do servidor.
2. Na pasta Profiles, em hpObjects - Navigation, construa a estrutura de navegação utilizando o Assistente de

Configuração de Navegação.
3. Os objetos hpLabel0, hpLabel1 e hpLabel2 que usem a propriedade FrameSetToGetTitle para títulos
automáticos devem ser reconfigurados para refletir o nome correto do FrameSet. Para Quadros adaptativos, o
nome padrão é "hpFSMain".
4. Caso utilize um objeto hpLyraMenu, a estrutura de dados deve ser convertida para usar a propriedade
OpenScreenCode. Para isto, pode-se usar o objeto ~hpLyraDataConfig da biblioteca hpUtilities. Instancie este
objeto na raiz da estrutura de dados do menu, clique com o botão direito do mouse no objeto e selecione a
opção Configurar. Este objeto lê a propriedade scrContent de cada objeto hpLyraData e cria o link
correspondente na propriedade OpenScreenCode de cada objeto. Ao término da conversão, o objeto
~hpLyraDataConfig pode ser removido.
5. Os demais objetos que contêm links para abertura de Telas devem usar a propriedade OpenScreenCode para a
navegação de Quadros adaptativos. Consulte a lista de objetos e as respectivas propriedades afetadas no tópico
Abrindo uma Entidade de Navegação.
4.3.8 Assistente de Configuração de Navegação

O Assistente de Configuração de Navegação é um recurso da Biblioteca HighPerformance Template que visa
facilitar a configuração da estrutura de navegação de uma aplicação. Esta Tela pode ser acessada a partir de qualquer
ponto de uma aplicação, conforme implementado na aplicação de demonstração da Biblioteca HighPerformance
Template.
Com relação às alterações realizadas na estrutura de navegação através da janela do Assistente de Configuração de
Navegação:
· Somente são aplicadas em tempo de execução após parar e reiniciar o Domínio
· Somente são visíveis no Studio após atualizar a visualização do respectivo arquivo de projeto no Organizer,
clicando com o botão direito do mouse no arquivo de projeto e selecionando a opção Atualizar
Executando o Assistente pela Primeira Vez
Ao iniciar o Viewer de uma aplicação onde não exista nenhum Perfil de Navegação em hpObjects - Navigation -
Profiles, é exibida a Tela do Assistente de Configuração de Navegação, com as seguintes opções:
· Criar perfil padrão: Cria uma cópia do Perfil de Navegação usado na aplicação de demonstração da Biblioteca
· Criar novo perfil: Cria um Perfil mínimo a partir do qual pode ser configurado um Perfil de maior complexidade
· Sair do assistente: Fecha a janela do Assistente
Ao criar um Perfil padrão ou um novo Perfil, o Assistente passa a exibir um menu do tipo Accordion com as opções
descritas a seguir.

Perfil de Navegação
Permite selecionar ou editar os Perfis de Navegação existentes em uma aplicação. Para criar um novo Perfil, siga estes
procedimentos:
1. Clique em Novo.
2. Na caixa de diálogo Novo Perfil, digite o nome do novo Perfil e clique em Salvar.
Para renomear um Perfil existente, siga estes procedimentos:
1. Selecione um Perfil na caixa de seleção.
2. Clique em Renomear.
3. Na caixa de diálogo Renomear Perfil, digite o novo nome do Perfil selecionado e clique em Salvar.
Para excluir um Perfil existente, siga estes procedimentos:
1. Selecione um Perfil na caixa de seleção.
2. Clique em Apagar.
Para alterar as configurações de um Perfil existente, selecione o Perfil na caixa de seleção e altere as configurações. As
opções de configuração são as seguintes:
· Computadores autorizados: Lista dos computadores autorizados a executar o Perfil selecionado, ou "*" para
autorizar qualquer computador
· Matriz de monitores: Arranjo de monitores selecionado pelo Seletor de Matriz de Monitores
· Viewer Height: Altura da janela do Viewer, em pixels
· Viewer Width: Largura da janela do Viewer, em pixels
Ao realizar qualquer alteração no Perfil selecionado, clique em Salvar no menu Perfil de Navegação para salvar as
alterações no arquivo de projeto da aplicação.
Monitor
Permite selecionar e configurar cada Monitor definido na Matriz de Monitores de um Perfil de Navegação. A opção de
configuração é a seguinte:
· Template de inicialização: Template inicial do Monitor selecionado
Ao realizar qualquer alteração no Monitor selecionado, clique em Salvar no menu Monitor para salvar as alterações
no arquivo de projeto da aplicação.
Template
Permite selecionar e editar os Templates de navegação existentes no Monitor selecionado no menu Monitor. Para criar
um Template, siga estes procedimentos:
1. Certifique-se de selecionar corretamente o Perfil de Navegação e o respectivo Monitor no menu do Assistente.
2. No menu Template, selecione um Template existente na caixa de seleção.

3. Execute as alterações no Editor de Templates.
4. Clique em Salvar como novo.
5. Na caixa de diálogo Novo template, digite o nome do novo Template e clique em Salvar.
Para renomear um Template existente, siga estes procedimentos:
1. Selecione um Template na caixa de seleção.
2. Clique em Renomear.
3. Na caixa de diálogo Renomear Template, digite o novo nome do Template selecionado e clique em Salvar.
Para excluir um Template existente, siga estes procedimentos:
2. Clique em Apagar.
Para habilitar a exibição de um Quadro, siga estes procedimentos:
2. No Editor de Templates, selecione o Quadro a ser exibido para criar um objeto hpNavFrameSet invisível (hidden)
na estrutura de navegação.
3. Clique no ícone ao lado da caixa de seleção do Quadro selecionado.
4. Configure a propriedade SplitValue para um valor diferente de 0 (zero) para tornar o Quadro visível.
5. Configure as demais propriedades, se necessário.
6. Clique em Aplicar para aplicar as alterações ao Quadro.
7. No item Template do menu, clique em Salvar para salvar as alterações no projeto.
Para desabilitar a exibição de um Quadro, siga estes procedimentos:
2. No Editor de Templates, desmarque a caixa de seleção do Quadro a ser ocultado.
Para editar a configuração de um Quadro, siga estes procedimentos:
2. No Editor de Templates, certifique-se de que o Quadro esteja habilitado para exibição.
3. Clique no ícone ao lado da caixa de seleção do Quadro para abrir a janela de configuração.
4. Para alterar o nome padrão do Quadro, clique no ícone ao lado da caixa de texto do nome e digite o novo nome.
Em seguida, clique no ícone ao lado do nome para validar a alteração, ou clique em Carregar padrão para
retornar ao valor padrão.
5. Para alterar as demais propriedades, digite o valor desejado nas caixas de texto correspondentes e clique em
Aplicar.

4.3.9 Usando os Recursos de Voltar e Avançar

Utilizando os objetos mencionados anteriormente para abertura de Telas, automaticamente a ação é registrada em
um histórico de Telas visitadas. Isto torna possível usar o recurso de voltar ou avançar pelos perfis registrados neste
histórico. Para isto, proceda da seguinte forma:
1. Crie uma instância do objeto hpScreenNav na Tela.
3. Navegue por algumas Telas para gerar um histórico de navegação.
4. Clique em um dos botões do tipo hpScreenNav para acessar o perfil registrado no histórico.
4.3.10 Abrindo Telas Pop-ups e Modais

Telas Pop-ups permitem interagir com a Tela de fundo. Já as Telas Modais não permitem interação com outras Telas
da aplicação.
A abertura de Telas pop-ups e modais na Biblioteca HighPerformance Template é realizada através de Templates de
pop-ups. Os Templates são alocados no item Objetos de Servidor - Objetos de Dados - hpObjects -
ScreenTemplates. Nestes objetos é possível configurar diversas propriedades, como sua largura e altura e se a janela
é do tipo Modal ou Pop-up, entre outras configurações.
Para mais detalhes sobre como configurar um Template de pop-up, consulte o tópico hpPopupTemplate.
A configuração de objetos para abertura de Telas pop-ups e modais deve ser executada da seguinte forma:
1. Crie e configure um Template de pop-up para cada tipo de janela a ser usada.
2. Instancie o objeto que executa a Associação de abertura da janela, como por exemplo o objeto hpPopupOpen,
em Tela
3. Configure a propriedade Behaviour para o valor correspondente à função de abertura de Tela, quando aplicável.
4. Configure as demais propriedades específicas para esta função:
· popArg: Argumento a ser passado à janela
· popName: Nome da Tela, como por exemplo "PopupDemo?100?0" (sem aspas)
· popTemplate: Associação para o respectivo objeto hpPopupTemplate
· popTitle: Título da janela
Para abrir uma janela pop-up ou modal por script, pode-se usar o Tag OpenPopup em Viewer - hpControls -
Navigation, que recebe como valor um array com 6 (seis) elementos:
· Elemento 0: MonitorID, uma String com o ID do Monitor, como por exemplo "01" ou "02", a ser concatenado ao
final do nome do Quadro onde é aberta a janela. Uma String vazia não adiciona nenhum sufixo ao nome do
Quadro
· Elemento 1: popArg, uma String com o argumento a ser passado à Tela. Uma String vazia não passa nenhum
argumento
· Elemento 2: popFrame, uma String com o nome do Quadro onde a Tela é aberta. Uma String vazia habilita a
denominação automática numérica do Quadro
· Elemento 3: popName, uma String com o caminho da Tela a ser aberta
· Elemento 4: popTitle, uma String com o título a ser exibido na janela

· Elemento 5: popTemplate, um objeto do tipo hpPopupTemplate que referencia o Template da Tela, localizado
em hpObjects - ScreenTemplates
Um exemplo de comando para abrir a janela pop-up "Telas.Pop1" em um Quadro denominado “meuQuadro02” em
que o sufixo "02" é o ID do Monitor seria o seguinte:
MonitorID = "02"
popArg = ""
popFrame = "meuQuadro"
popName = "Telas.Pop1"
popTitle = ""
set popTemplate = Application.GetObject("hpObjects.ScreenTemplates.PopTemplate1")
set openPopup = Application.Item("hpControls").Item("Navigation").Item("OpenPopup")
openPopup.Value = Array(MonitorID, popArg, popFrame, popName, popTitle, popTemplate)
O comando por script possui algumas limitações naturais em relação ao mesmo comando através do objeto de Tela
hpPopupOpen. Estas limitações são referentes a eventos de mouse que não existem na chamada por script. Neste
caso, a recomendação é realizar toda a configuração da janela pop-up no respectivo objeto hpPopupTemplate.
4.3.11 Menu Lyra

Para o funcionamento do objeto hpLyraMenu é necessário seguir estes procedimentos:
Construção e Configuração de uma Estrutura de Navegação
O menu Lyra utiliza uma estrutura de objetos de dados para compor os elementos e as funcionalidades. Ao ser
iniciado, o menu Lyra monta e configura automaticamente os elementos com base nesta estrutura. A criação desta
estrutura, bem como a configuração dos elementos, está descrita com detalhes no tópico hpLyraData.
Geração do Código XML da Estrutura de Navegação
Uma vez construída a estrutura de dados, é preciso gerar o código XML. O menu Lyra usa este código sempre que
precisa atualizar a exibição.
É o objeto hpXMLCatalog que tem a função de varrer a estrutura de dados e gerar o código XML correspondente.
No caso do menu Lyra, este código precisa ter alguns parâmetros específicos para o funcionamento. Por isto o objeto
hpXMLCatalog tem que ser configurado especialmente para este fim.
Para mais detalhes sobre a geração de código XML e a configuração específica para o menu Lyra, consulte o tópico
hpXMLCatalog.
Configuração do Objeto hpLyraMenu em Tela
O último passo da configuração do menu Lyra é instanciá-lo em Tela e ajustar as Associações, conforme a figura a
seguir.

Propriedades do objeto hpLyraMenu
As propriedades para a configuração básica do objeto hpLyraMenu estão descritas na tabela a seguir.
Propriedades para configuração do objeto hpLyraMenu
PROPRIEDADE DESCRIÇÃO
DataFolder Propriedade PathName da pasta que contém a estrutura
de navegação
DocInput Associação com o Tag Interno que contém a estrutura de

navegação no formato XML DOM
RedrawTrigger Uso reservado da Biblioteca HighPerformance

Template. NOTA: Recomenda-se não alterar esta
Associação
4.4 Tradução
A Biblioteca Translator permite configurar o recurso de tradução tanto para aplicações que usem a Biblioteca
HighPerformance Template quanto para aquelas que não o utilizam. Em ambos os casos, os passos para
implementar o recurso são os mesmos e estão descritos a seguir.
1. Defina um idioma principal, usado para configurar toda a aplicação no Studio.
2. Crie um dicionário com as definições do idioma principal e dos idiomas secundários e de seus termos.
3. Importe o dicionário para a aplicação.
4. Configure as regras para aplicar as Associações de tradução.
5. Crie as Associações de tradução no Viewer.
Cada Viewer de um mesmo Domínio pode exibir um idioma diferente, e é possível trocar este idioma em tempo de
execução com um simples clique do mouse.

4.4.1 Criando um Dicionário
O dicionário de termos é um arquivo CSV (Comma-Separated Values) localizado na pasta Dictionaries e deve ser
gerado pelo usuário com os idiomas e termos a traduzir.
4.4.1.1 Formato
Este arquivo deve ter o formato indicado na figura a seguir.
Arquivo CSV
A primeira linha do arquivo deve conter um nome único para cada idioma. Estes nomes são exibidos na aplicação, em
tempo de execução, quando o usuário acessa o menu para trocar o idioma.
O idioma especificado na primeira coluna (A) é considerado o idioma principal, a partir do qual todos os objetos da
aplicação devem estar configurados. Desta forma, os objetos devem ser configurados no idioma principal no Studio,
a fim de que o módulo de tradução possa endereçar corretamente os termos dos demais idiomas.
A segunda linha deve conter os Indicadores Únicos de Idioma, ou SLI (Single Language Indicator). Estes indicadores são
códigos exclusivos de cada idioma para a identificação pela Biblioteca HighPerformance Template.
Estes indicadores devem ser definidos pelo usuário e não obedecem a um formato obrigatório. A recomendação, no
entanto, é para que sejam padronizados segundo a norma ISO 639-1 para o idioma e a norma ISO 3166-1 para a
localidade, no formato [Idioma]-[Localidade], conforme os exemplos a seguir.
· pt-BR: Português do Brasil
· pt-PT: Português de Portugal
· en-US: Inglês dos Estados Unidos
· es-ES: Espanhol da Espanha
As demais linhas devem conter os termos do dicionário. Não é permitida a ocorrência de termos repetidos na coluna
do idioma principal (A), pois todos os termos dos demais idiomas são endereçados pelos termos do idioma principal.

NOTAS
· O número de idiomas ou colunas, bem como seus nomes, é livre, assim como o número de termos cadastrados.
· Nenhum SLI é sensível a maiúsculas ou minúsculas. Assim, "pt-BR" e "PT-BR" são considerados os mesmos
indicadores.
· Todos os termos cadastrados no dicionário são sensíveis a maiúsculas ou minúsculas. Assim, "Alarme" e "ALARME"
são considerados termos distintos.
· Os termos cadastrados podem conter aspas simples (') mas não podem conter aspas duplas (").
· Caso o SLI não corresponda a nenhuma entrada no dicionário, todos os objetos passíveis de tradução exibem
uma mensagem de erro "#Language not defined#".
4.4.2 Importando um Dicionário

Para importar um dicionário, siga estes procedimentos:
1. Acesse a instância do objeto hpTranslatorController localizada no item Objetos de Servidor - Objetos de Dados
- hpObjects - Translator.
2. Verifique se o valor da propriedade EnableGlobalTranslation é igual a True. Caso o valor esteja configurado em
False, o recurso de tradução está desabilitado para toda a aplicação.
3. Especifique o nome do arquivo CSV na propriedade Dictionary deste objeto.
Propriedade Dictionary
4. Clique com o botão direito do mouse na instância e selecione a opção Configurar para importar o dicionário.
Caso a importação seja bem-sucedida, a propriedade ImportStatus exibe o valor 2 (dois).

Opção Configurar
5. Salve a Pasta hpObjects para concluir a importação.
4.4.3 Configurando o Processo de Tradução

Antes de criar as Associações de tradução é necessário definir alguns parâmetros para que o recurso funcione
corretamente.
· Defina quais objetos e propriedades vão ser traduzidos.
· Defina quais ações são tomadas quando uma propriedade já possui uma Associação.
· Defina a influência da propriedade EnableTranslation no processo de configuração.
4.4.3.1 Declaração de Objetos e Propriedades

Esta seção contém informações sobre Associações no processo de tradução em objetos nativos da Biblioteca
HighPerformance Template e nos demais objetos e propriedades.
4.4.3.1.1 Objetos Nativos
Por definição, todos os objetos nativos da Biblioteca HighPerformance Template recebem automaticamente as
Associações de tradução em uma propriedade pré-definida.
Assim, por exemplo, quando o objeto hpTranslatorAddLinkXM analisa um objeto do tipo hpLabel0,
automaticamente cria a Associação de tradução em sua propriedade TextValue.
Os objetos contemplados por este recurso e suas respectivas propriedades afetadas estão descritos na tabela a
seguir.

Objetos nativos e propriedades
OBJETO PROPRIEDADE
hpCheckBox Label
hpCommandButton Label
hpDateTimePicker ListMonths, ListWeekDays, MenuParameter
hpLabel0 TextValue
hpLabel1 TextValue
hpLabel2 TextValue
hpLabel3 TextValue
hpLabel3Highlight TextValue
hpLabel4 TextValue
hpLabel4Highlight TextValue
hpLabel5 TextValue
hpLabel6 TextValue
hpLabelGeneric TextValue
hpLinkDetail MenuDescription
hpLinkMain MenuDescription
hpOptionButton Caption
hpPageReference TextValue
hpTabBarHorizontal Tab1Text, Tab2Text, Tab3Text, Tab4Text, Tab5Text,

Tab6Text, Tab7Text, Tab8Text, Tab9Text, Tab10Text,
Tab11Text, Tab12Text
hpTabBarVertical Tab1Text, Tab2Text, Tab3Text, Tab4Text, Tab5Text,

Tab6Text, Tab7Text, Tab8Text, Tab9Text, Tab10Text,
Tab11Text, Tab12Text
hpToggleButton LabelOn, LabelOff
Para desativar este recurso, altere o valor da propriedade AutoCreateHPLinks para False. Assim, nenhum objeto
nativo da Biblioteca HighPerformance Template recebe Associações de tradução.
Caso seja necessário criar uma Associação de tradução em outra propriedade que não seja a padrão, declare o
objeto na propriedade PropertiesList, conforme o tópico a seguir.
4.4.3.1.2 Demais Objetos ou Propriedades
Para criar uma Associação de tradução em um objeto que não seja nativo da Biblioteca HighPerformance Template
é necessário declará-lo na propriedade PropertiesList como no exemplo a seguir.
CommandButton:Caption

Neste exemplo é criada uma única Associação de tradução na propriedade Caption de um objeto Botão de Comando
(CommandButton). Para traduzir mais propriedades, liste-as separadas por vírgula, como no exemplo a seguir.
CommandButton:Caption,Tip,DocString
Para declarar dois ou mais objetos, separe-os por ponto e vírgula, como no exemplo a seguir.
CommandButton:Caption,Tip,DocString;Checkbox:Caption
Objetos nativos da Biblioteca HighPerformance Template podem ser declarados na propriedade PropertiesList,
porém neste caso são traduzidas apenas as propriedades declaradas pelo usuário.
4.4.3.2 Associações Existentes

A propriedade KeepsExistingLinks permite preservar Associações já existentes durante o processo de criação de
Associações. Se o seu valor é configurado em False, as Associações pré-existentes são sobrescritas.
4.4.3.3 Propriedade EnableTranslation

Alguns objetos nativos da Biblioteca HighPerformance Template possuem a propriedade EnableTranslation que
informa se um objeto deve ser traduzido ou não.
A função que cria as Associações de tradução pode ignorar objetos nativos em que a propriedade EnableTranslation
esteja configurada para False, ou seja, têm a tradução desabilitada. Para traduzir apenas os casos em que a
propriedade EnableTranslation seja igual a True, altere o valor da propriedade LinkEnabledTranslationOnly para
True.
Objetos que não possuam a propriedade EnableTranslation e que são declarados na propriedade PropertiesList
sempre são traduzidos.
4.4.4 Criando as Associações de Tradução

Após configurar a função de tradução, o próximo passo é criar as Associações nos objetos de Tela.
1. Abra uma Tela no Studio.
2. Instancie nesta Tela o objeto hpTranslatorAddLinkXM.
3. Configure a propriedade DefaultSLI do objeto hpTranslatorController para o Indicador Único de Linguagem

(SLI) de referência da aplicação.
4. Clique com o botão direito neste objeto e selecione a opção Configurar para iniciar o processo de criação de
Associações em todos os objetos da Tela.
5. Ao final do processo é exibida uma janela que informa quantos objetos foram afetados e o número de
Associações criadas.
6. Repita este processo para cada uma das Telas da aplicação.
Esta função lê o valor configurado no objeto e busca no dicionário quais os idiomas disponíveis e quais as traduções
para aquele termo específico. O resultado é uma Associação Múltipla onde o índice 0 (zero) é o termo no idioma
principal no Studio e os demais índices são os termos traduzidos para os idiomas disponíveis, conforme a figura a
seguir.

Associação Múltipla com traduções
Caso o termo digitado no objeto de Tela não exista no dicionário, a função retorna uma mensagem de erro na
própria Associação, conforme a figura a seguir.
Associação Múltipla com erro na tradução
4.4.5 Idioma Padrão do Viewer

O idioma padrão do Viewer é o idioma carregado pela Biblioteca HighPerformance Template durante a
inicialização do Viewer, e este idioma pode ser definido no Tag ActiveLanguageXM, localizado em Viewer -
hpControls - Translator.
A definição é automática quando o valor do Tag ActiveLanguageXM é igual a uma String vazia. Neste caso, a
definição é baseada no idioma de instalação do Viewer, indicado na propriedade ViewerLanguageID. Neste modo,
para cada valor desta propriedade o módulo Translator carrega o respectivo SLI na propriedade Value do Tag
ActiveLanguageXM, conforme indicado na tabela a seguir.
Valores da propriedade ViewerLanguageID
VIEWERLANGUAGEID ACTIVELANGUAGEXM IDIOMA

4 zh-CN Chinês Simplificado

VIEWERLANGUAGEID ACTIVELANGUAGEXM IDIOMA
1031 de-DE Alemão
1033 en-US Inglês Americano
1046 pt-BR Português do Brasil
11274 es-ES Espanhol Moderno
Nos casos em que é necessário selecionar um outro idioma, diferente do padrão do Viewer, indique o código SLI do
idioma na propriedade Value do Tag ActiveLanguageXM.
NOTA
Em ambos os casos, o dicionário da aplicação precisa ter o idioma configurado e os termos traduzidos. Se o idioma
não existir no dicionário, os objetos traduzidos exibem a mensagem de erro #Language not defined#.
4.4.6 Visualizando o Resultado

Ao executar a aplicação em um Viewer, deve ser possível ao usuário selecionar um idioma em uma lista e aplicá-lo
neste Viewer. Há duas formas de gerar a lista de idiomas disponíveis, através de objetos nativos da Biblioteca
HighPerformance Template ou manualmente caso a aplicação não utilize a Biblioteca HighPerformance Template.
4.4.6.1 Selecionando o Idioma na Biblioteca HighPerformance Template

Para visualizar a tradução em tempo de execução com objetos nativos da Biblioteca HighPerformance Template,
siga estes procedimentos:
1. No Studio, instancie em uma Tela um objeto hpLinkDetail, hpLinkIcon ou hpLinkMain.
2. Selecione a opção Language Selector na propriedade Behaviour do objeto instanciado, para que se comporte
como um menu de seleção de idiomas.
4. Abra a Tela e clique no objeto seletor de idiomas.
5. Selecione um dos idiomas listados para que todos os textos configurados sejam traduzidos para o idioma
selecionado.
4.4.6.2 Selecionando o Idioma Fora da Biblioteca HighPerformance Template

Para selecionar um idioma sem usar os objetos nativos descritos no tópico anterior, altere o valor do Tag
ActiveLanguage do Viewer, localizado em Visualização - Viewer e Quadros - Viewer - hpControls - Translator. Os
valores válidos são inteiros que iniciam em 0 (zero) para o idioma principal e são incrementados para os demais
idiomas.
4.4.7 Compatibilidade entre Dicionários

Para preservar a funcionalidade de tradução de uma biblioteca ou projeto já traduzidos e que sejam movidos para
outra aplicação, os códigos dos Indicadores Únicos de Linguagem (SLI) dos idiomas devem ser idênticos tanto no
dicionário original quanto no dicionário de destino, mesmo que a ordem em que os idiomas aparecem nos
dicionários seja diferente.
Neste processo, caso seja necessário copiar um idioma secundário na origem para outro dicionário onde este é o
idioma de referência, é preciso garantir que não existam termos repetidos.

4.5 Logs
A Biblioteca HighPerformance Template permite registrar mensagens em arquivo e exibir sinalizações em tela de
modo consistente e padronizado. Esta função é usada internamente pelos objetos da própria Biblioteca
HighPerformance Template, e pode também ser estendida a qualquer aplicação que utilize este Template.
4.5.1 Níveis de Registro ou Sinalização

A Biblioteca HighPerformance Template define os seguintes níveis ou camadas de registro e sinalização de
mensagens:
· Nível 0 (Trace): Registro de valores de variáveis e estados de processos dentro de uma função
· Nível 1 (Debug): Informações para investigação de falhas e outros comportamentos
· Nível 2 (Info): Fluxo geral da aplicação e eventos regulares do sistema
· Nível 3 (Warn): Eventos inesperados, mas que não causam interrupção no fluxo da aplicação. São informações
que podem influenciar de forma significativa a análise de um suporte
· Nível 4 (Error): Ocorrência de condições não esperadas ou não permitidas e que causam a interrupção do fluxo
da aplicação
· Nível 5 (Fatal): Erros ou condições que comprometem o funcionamento geral da aplicação
Cada mensagem deve ser registrada dentro do nível que condiz com a natureza do evento, conforme os exemplos a
seguir.
· Registro de autenticação de usuário: trata-se de informação de um evento regular do sistema, portanto o nível é
2 (dois, Info)
· Parâmetro não preenchido pelo usuário, mas que é automaticamente detectado e corrigido pela aplicação: trata-
se de um evento inesperado, mas que foi corrigido automaticamente e não interrompeu o fluxo da aplicação,
portanto o nível é 3 (três, Warn)
· Tela não é aberta devido a um erro no endereço: aqui há interrupção do fluxo normal da aplicação, pois a Tela
não foi aberta e, portanto, o nível é 4 (quatro, Error)
· Falha de leitura de parâmetros armazenados em banco de dados que provoca erros em diversas Telas e
módulos da aplicação: a falha é generalizada, pois várias Telas e módulos são afetados e deixam de funcionar,
comprometendo uma grande parte da aplicação. Neste caso o nível é 5 (cinco, Fatal)
4.5.2 Cenários de Ocorrência de Eventos

Os registros de eventos ou sinalização em Tela podem ser originados em diferentes contextos, definindo os cenários
descritos a seguir.
Primeiro Cenário
Mensagem gerada em tempo de execução por objeto de Servidor. Neste cenário todos os níveis de mensagem são
registrados em arquivo de log do Elipse E3 ou Elipse Power e nenhum é sinalizado em Tela. O processamento é
realizado pelo objeto hpLogEvent.
Na propriedade RegisterLevel deste objeto é realizada a configuração de quais níveis de mensagem são
processados. Esta propriedade configura o nível mais baixo que se deseja processar, ignorando os níveis abaixo
desta configuração. O valor padrão desta propriedade é 3 (três), indicando que são ignorados os níveis 0: Trace, 1:
Debug e 2: Info, e processados apenas os eventos de níveis 3: Warn, 4: Error e 5: Fatal. A propriedade RegisterLevel
tem escopo global na aplicação, servindo de configuração para todos os cenários descritos neste tópico.

Segundo Cenário
Mensagem gerada em tempo de execução por objeto do Viewer. Neste cenário todos os níveis de mensagem são
registrados em arquivo de log do Elipse E3 ou Elipse Power e os níveis 4: Error e 5: Fatal são sinalizados em Tela. O
processamento é realizado pelo Tag hpLogEvent, localizado em Viewer - hpControls - Log.
Terceiro Cenário
Mensagem gerada em tempo de edição no Studio (CustomConfig), tanto por objetos de servidor como por objetos
do Viewer. Neste cenário todos os níveis de mensagem são sinalizados em Tela e nenhum é registrado em arquivo. O
processamento é realizado pelo método hpLogEvent, que deve ser copiado para o objeto que solicita a sinalização
em tempo de edição. Para copiá-lo, acesse o Tag hpLogEvent, localizado em Viewer - hpControls - Log. O código
encontra-se no evento OnValueChange.
4.5.2.1 Resumo
A tabela a seguir resume os estados possíveis assumidos pela função de log nos cenários descritos anteriormente.
Estados possíveis
ORIGEM CONTEXTO CENÁRIO EVENTO NÍVEIS PROCESSADOS

Objeto de servidor Tempo de execução Primeiro Registro em arquivo Todos, desde que
configurados na
propriedade
RegisterLevel
Studio Terceiro Sinalização em Tela Todos, desde que

configurados na
propriedade
RegisterLevel
Objeto do Viewer Tempo de execução Segundo Registro em arquivo Todos, desde que
configurados na
propriedade
RegisterLevel
Sinalização em Tela 4: Error e 5: Fatal
Studio Terceiro Sinalização em Tela Todos, desde que

configurados na
propriedade
RegisterLevel
4.5.3 Cadastro de Mensagens

O cadastro das mensagens a serem registradas em arquivo ou sinalizadas em Tela deve ser realizado exclusivamente
por script. Para isto, deve-se copiar e colar o bloco de código da função de log no método desejado e configurá-lo
manualmente.
4.5.3.1 Bloco de Código

O bloco de código a seguir recebe as configurações da mensagem a ser processada e executa o objeto processador
com base no cenário no qual a mensagem é gerada. Este código deve ser colado no script exatamente no ponto em
que a mensagem deve ser processada.
'Define parameters
hpLogSource = "SERVER"
hpLogLevel = "INFO"
hpLogMsg = "Message to print to log file"
hpLogModal_Texts = Array()

hpLogModal_Link = ""
'Print or display the message

hpLogParam = Array(Now, hpLogLevel, PathVolume, PathName,
hpLogMsg, Array(hpLogModal_Texts,hpLogModal_Link), hpLogSource)
Select Case True
Case LCase(hpLogSource) = "viewer"
Application.Item("hpControls").Item("Log").Item("hpLogEvent").Value = hpLogParam
Case LCase(hpLogSource) = "server"
Application.GetObject("hpObjects.Log.hpLogEvent").hpLogParams = hpLogParam
Case LCase(hpLogSource) = "customconfig"
Call hpLogEvent(hpLogParam)
End Select
O código após o comentário Define parameters contém todos os parâmetros que devem ser configurados pelo
usuário. Já o código após o comentário Print or display the message aciona o objeto processador conforme o
contexto.
4.5.3.2 Configuração de Parâmetros

A tabela a seguir contém as configurações possíveis para cada parâmetro do bloco de código.
Configurações de parâmetros
PARÂMETRO DESCRIÇÃO TIPO DE DADOS VALORES POSSÍVEIS

hpLogSource Fonte disparadora do String SERVER, VIEWER ou
evento CUSTOMCONFIG
hpLogLevel Nível de registro ou String TRACE, DEBUG, INFO,

sinalização WARN, ERROR ou FATAL
hpLogMsg Mensagem de registro em String Definido pelo usuário

arquivo de log do Elipse E3
ou Elipse Power
hpLogModal_Texts Lista de mensagens que Array de Strings Definido pelo usuário

compõem a sinalização em
Tela
hpLogModal_Link URL da documentação String Definido pelo usuário

associada ao evento
4.5.3.3 Sinalização com Múltiplas Linhas

Para sinalização em Tela, não há um limite estipulado para o número de linhas de texto a serem exibidas. Basta
configurar o Array da variável hpLogModal_Texts com a quantidade de texto desejada, conforme o exemplo a seguir.
hpLogModal_Texts = Array("Line 1", "Line 2", "Line 3", "etc")
4.5.3.4 Documentação Online

Pode-se disponibilizar ao usuário o acesso a uma documentação online relacionada com a sinalização. Para ativar este
recurso, declare uma URL válida na variável hpLogModal_Link, conforme o exemplo a seguir.
hpLogModal_Link = "https://docs.elipse.com.br/documents/pt-br/hp/latest/manual/extensions/"
Ao cadastrar uma URL, a caixa de mensagens exibe automaticamente o texto de direcionamento para a documentação
online, conforme a figura a seguir. Este recurso é disponibilizado para todos os níveis de mensagem.

Mensagem para documentação online
4.5.3.5 Desativando a Sinalização em Tela

Caso nenhuma sinalização seja exibida em Tela, os parâmetros devem ser declarados com uma String vazia,
conforme o exemplo a seguir.
hpLogModal_Texts = Array()
hpLogModal_Link = ""
A sinalização deve ser desativada somente para o primeiro cenário descrito anteriormente.
4.5.4 Exemplos de Sinalizações

Os tópicos a seguir listam os formatos pré-definidos pela função de registro e sinalização de mensagens.
4.5.4.1 Registro em Arquivo

As mensagens registradas em arquivo de log do Elipse E3 ou Elipse Power têm a formatação mostrada no exemplo a
seguir para cada nível.
EVENT: hp_TRACE - Message server [Folder.Object.CommandButton1] (02/01/2021 14:50:00)
EVENT: hp_DEBUG - Message server [Folder.Object.CommandButton1] (02/01/2021 14:50:00)
EVENT: hp_INFO - Message server [Folder.Object.CommandButton1] (02/01/2021 14:50:00)
EVENT: hp_WARN - Message server [Folder.Object.CommandButton1] (02/01/2021 14:50:00)
EVENT: hp_ERROR - Message server [Folder.Object.CommandButton1] (02/01/2021 14:50:00)
EVENT: hp_ERROR - Message server [Folder.Object.CommandButton1] (02/01/2021 14:50:00)
EVENT: hp_FATAL - Message server [Folder.Object.CommandButton1] (02/01/2021 14:50:00)
EVENT: hp_FATAL - Message server [Folder.Object.CommandButton1] (02/01/2021 14:50:00)
4.5.4.2 Sinalização em Tela

Mensagens sinalizadas em Tela têm a formatação mostrada nas imagens a seguir para cada nível.
Nível Trace

Nível Debug
Nível Info
Nível Warn
Nível Error
Nível Fatal

CAPÍTULO
Objetos
5
Esta seção contém informações sobre os objetos disponíveis na Biblioteca HighPerformance Template.
5.1 Alarmes
Esta seção contém informações sobre os objetos do tipo Alarme na Biblioteca HighPerformance Template.
NOTA
Os objetos do tipo Alarme são totalmente integrados à Biblioteca HighPerformance Template, com suporte nativo
a Temas.
Em aplicações criadas com versões da Biblioteca HighPerformance Template anteriores à versão 2.0.76 e abertas
em versões mais recentes, é preciso configurar a propriedade AlarmServer em todas as instâncias em Tela dos
objetos descritos nesta seção. Além disto, é preciso configurar cada XControl desenvolvido pelo usuário que contenha
um ou mais destes objetos indicadores de alarmes. Esta configuração deve ser realizada conforme os passos a
seguir.
1. Crie uma propriedade AlarmServer em cada XControl, idêntica à propriedade AlarmServer usada nos objetos
indicadores de alarmes.
2. Internamente, associe a propriedade AlarmServer do indicador de alarme à propriedade AlarmServer do

XControl.
3. Configure a propriedade AlarmServer de cada instância de XControl afetado por esta configuração com o
caminho do Servidor de Alarmes usado pela instância.
Um exemplo desta configuração pode ser visualizada no objeto hpDigitalDisplay usado na aplicação de
demonstração da Biblioteca HighPerformance Template.
5.1.1 hpAlarmIndicatorAnalog
Indica o estado de um Alarme Analógico, conforme a tabela a seguir.
Estados de Alarmes Analógicos
ESTADO INDICAÇÃO SEVERIDADE ALTA SEVERIDADE MÉDIA SEVERIDADE BAIXA SEVERIDADE CRÍTICA
Normalizado Indicador
e não piscando e
reconhecido borda
indicadora
de alarme
atuado oculta
Atuado e Indicador
não piscando e
reconhecido borda
indicadora
de alarme
atuado visível
61 Objetos
Atuado e Indicador fixo
reconhecido e borda
indicadora
de alarme
atuado visível
A indicação para alarme normalizado e reconhecido varia conforme o valor definido para a propriedade
ShowIconWhenNormal, conforme a tabela a seguir.
Estados de Alarmes variando com a propriedade ShowIconWhenNormal
ESTADO VALOR SEVERIDADE ALTA SEVERIDADE SEVERIDADE SEVERIDADE

MÉDIA BAIXA CRÍTICA
Normalizado e True
reconhecido
False Sem indicação Sem indicação Sem indicação Sem indicação
Se a propriedade Behaviour é configurada para o valor 1 (um), o indicador permite que o usuário reconheça o
alarme associado com um clique do mouse.
5.1.1.1 Propriedades
A tabela a seguir contém as propriedades do objeto hpAlarmIndicatorAnalog.
Propriedades do objeto hpAlarmIndicatorAnalog
AlarmServer Associação para um objeto Servidor de Alarmes
AlarmSourceAnalog Associação para um objeto Fonte de Alarme Analógico
Behaviour Altera o comportamento do objeto. Os valores possíveis

são 0: Definido pelo usuário ou 1: Reconhecimento de
alarme
EnableClick Permite que este objeto responda ao evento de clique

do mouse, incrementando o valor da propriedade
EventClick. Este comportamento só é válido quando o
valor da propriedade Behaviour é igual a 0 (zero)
EventClick Altera o valor de 1 (um) para 9 (nove) quando ocorre um

evento de clique do mouse. Este comportamento só é
válido quando o valor da propriedade Behaviour é igual
a 0 (zero) e o valor da propriedade EnableClick é igual a
True
RetSeverity Retorna o estado corrente do Alarme
ShowIconWhenNormal Exibe o ícone para alarme normalizado e reconhecido
Objetos 62
5.1.2 hpAlarmIndicatorDeadBand
Indica o estado de um Alarme Banda Morta, conforme a tabela a seguir.
Estados de Alarmes Banda Morta
e não piscando e
reconhecido borda
indicadora
de alarme
atuado oculta
Atuado e Indicador
não piscando e
reconhecido borda
indicadora
de alarme
atuado visível

reconhecido e borda
indicadora
de alarme
atuado visível

Normalizado e True
reconhecido
A tabela a seguir contém as propriedades do objeto hpAlarmIndicatorDeadBand.
Propriedades do objeto hpAlarmIndicatorDeadBand
AlarmSourceDeadBand Associação para um objeto Fonte de Alarme de Banda

Morta
63 Objetos
Behaviour Altera o comportamento deste objeto. Os valores
possíveis são 0: Definido pelo usuário ou 1:
Reconhecimento de alarme


True
RetSeverity Retorna o estado corrente do alarme
5.1.3 hpAlarmIndicatorDigital
Indica o estado de um Alarme Digital conforme a tabela a seguir.
Estados de Alarmes Digitais
e não piscando e
reconhecido borda
indicadora
de alarme
atuado oculta
Atuado e Indicador
não piscando e
reconhecido borda
indicadora
de alarme
atuado visível

reconhecido e borda
indicadora
de alarme
atuado visível

Normalizado e True
reconhecido
Objetos 64
A tabela a seguir contém as propriedades do objeto hpAlarmIndicatorDigital.
Propriedades do objeto hpAlarmIndicatorDigital
AlarmSourceDigital Associação para um objeto Fonte de Alarme Digital



True
5.1.4 hpAlarmIndicatorDiscrete
Indica o estado de um Alarme Discreto, conforme a tabela a seguir.
Estados de Alarmes Discretos
e não piscando e
reconhecido borda
indicadora
de alarme
atuado oculta
65 Objetos
Atuado e Indicador
não piscando e
reconhecido borda
indicadora
de alarme
atuado visível

reconhecido e borda
indicadora
de alarme
atuado visível

Normalizado e True
reconhecido
A tabela a seguir contém as propriedades do objeto hpAlarmIndicatorDiscrete.
Propriedades do objeto hpAlarmIndicatorDiscrete
AlarmSourceDiscrete Associação para um objeto Fonte de Alarme Discreto



True
Objetos 66
5.1.5 hpAlarmIndicatorGeneric
Indica o estado de um Alarme genérico (Analógico, Banda Morta, Digital, Discreto ou Taxa de Variação), conforme a
tabela a seguir.
Estados de Alarmes genéricos
e não piscando e
reconhecido borda
indicadora
de alarme
atuado oculta
Atuado e Indicador
não piscando e
reconhecido borda
indicadora
de alarme
atuado visível

reconhecido e borda
indicadora
de alarme
atuado visível

Normalizado e True
reconhecido
A tabela a seguir contém as propriedades do objeto hpAlarmIndicatorGeneric.
67 Objetos
Propriedades do objeto hpAlarmIndicatorGeneric
AlarmSource Associação para um objeto Fonte de Alarme (Analógico,

Banda Morta, Digital, Discreto ou Taxa de Variação)



True
5.1.6 hpAlarmIndicatorROC
Indica o estado de um Alarme Taxa de Variação, conforme a tabela a seguir.
Estados de Alarmes Taxa de Variação
e não piscando e
reconhecido borda
indicadora
de alarme
atuado oculta
Atuado e Indicador
não piscando e
reconhecido borda
indicadora
de alarme
atuado visível

reconhecido e borda
indicadora
de alarme
atuado visível
Objetos 68

Normalizado e True
reconhecido
A tabela a seguir contém as propriedades do objeto hpAlarmIndicatorROC.
Propriedades do objeto hpAlarmIndicatorROC
AlarmSourceROC Associação para um objeto Fonte de Alarme Taxa de

Variação



True
5.1.7 E3AlarmToolbar
O objeto E3AlarmToolbar foi descontinuado. Este objeto não recebe mais atualizações e vai ser removido da
Biblioteca HighPerformance Template em uma versão futura. Recomenda-se o uso do objeto E3AlarmToolbarV2
no lugar deste objeto.
5.1.8 E3AlarmToolbarV2
Barra de ferramentas para alarmes e eventos com filtro por severidades, associada ao objeto E3Alarm. Contém
comandos de reconhecimento, controles de ordenação, contagem de alarmes e eventos, informações sobre a
sinalização selecionada e opções de filtros.
O objeto E3Alarm associado ao E3AlarmToolbarV2 deve exibir as sinalizações de todas as severidades. Para o caso
em que há um objeto E3Alarm para cada severidade, use o objeto E3AlarmToolbarMultipleView.
69 Objetos
Comandos do objeto E3AlarmToolbarV2
COMANDO DESCRIÇÃO
Exibir alarmes Exibe apenas sinalizações de alarmes
Exibir shelved Altera o valor da propriedade RetShowAlarmsShelved

para True. A lógica para a exibição dos alarmes shelved
deve ser implementada por script nesta propriedade
Exibir suprimidos Altera o valor da propriedade

RetShowAlarmsSupressed para True. A lógica para a
exibição dos alarmes suprimidos deve ser
implementada por script nesta propriedade
Exibir alarmes e eventos Exibe sinalizações de alarmes e de eventos
Exibir eventos Exibe apenas sinalizações de eventos
Exibir severidade alta Exibe sinalizações com severidade alta
Exibir severidade média Exibe sinalizações com severidade média
Exibir severidade baixa Exibe sinalizações com severidade baixa
Reconhecer todos Reconhece globalmente todos os alarmes
Reconhecer seleção Reconhece apenas os alarmes selecionados
Reconhecer exibição atual Reconhece apenas os alarmes sinalizados no objeto

E3Alarm
Silenciar buzina Altera o valor da propriedade RetSoundOff para True.

A lógica para silenciar o alarme sonoro deve ser
Aplicar filtro Aplica o filtro personalizado no E3Alarm
Editar filtro Edita o filtro personalizado do E3Alarm
Ordenação do campo primário Ordena as sinalizações pelo campo primário do

E3Alarm
Ordenação do campo secundário Ordena as sinalizações pelo campo secundário do

E3Alarm
Ordenação do campo terciário Ordena as sinalizações pelo campo terciário do E3Alarm
Ordenação do campo quaternário Ordena as sinalizações pelo campo quaternário do

E3Alarm
Informação Exibe informações relacionadas ao alarme ou evento

selecionado
Contagem Exibe a contagem de alarmes
Imprimir Altera o valor da propriedade RetPrint para True. A

lógica para imprimir a lista de sinalizações deve ser
Objetos 70
A tabela a seguir contém as propriedades do objeto E3AlarmToolbarV2. Após configurar as propriedades, clique
com o botão direito do mouse no objeto e selecione a opção Configurar para visualizar a configuração final no
Studio sem afetar o funcionamento.
Propriedades do objeto E3AlarmToolbarV2
E3Alarm Associação para um objeto E3Alarm
Filter String de configuração do filtro personalizado do

E3Alarm
MarginButton Quantidade de espaço usado entre dois botões na barra

de ferramentas, em Himetric
MarginDivider Quantidade de espaço usado ao redor das divisórias na

barra de ferramentas, em Himetric
MarginToolbar Quantidade de espaço usado entre os objetos e os limites

da barra de ferramentas, em Himetric
Orientation Orientação da barra de ferramentas. Os valores possíveis

são 1: Horizontal ou 2: Vertical
RetPrint Retorna True quando o usuário clica em Print
RetShowAlarmsShelved Retorna True quando o usuário clica em

ShowAlarmsShelved
RetShowAlarmsSupressed Retorna True quando o usuário clica em

ShowAlarmsSupressed
RetSoundOff Retorna True quando o usuário clica em SilenceHorn
SeverityIconsSelection Seleção do conjunto de ícones de severidade. Os valores

possíveis são 1: Ícones padrão da barra de ferramentas
ou 2: Ícones baseados nos indicadores
de alarme
5.1.9 E3AlarmToolbarMultipleView
Barra de ferramentas para alarmes e eventos sem filtro por severidades, associada a quatro objetos E3Alarm, um
para severidade crítica, um para severidade alta, um para severidade média e outro para severidade baixa. Contém
comandos de reconhecimento e opções de filtros.
Para o caso em que há um único objeto E3Alarm para todas as severidades, use o objeto E3AlarmToolbarV2.
Comandos do objeto E3AlarmToolbarMultipleView
COMANDO DESCRIÇÃO
Exibir alarmes Exibe apenas sinalizações de alarmes
Exibir shelved Altera o valor da propriedade ShowAlarmsShelved

para True. A lógica para a exibição dos alarmes shelved
deve ser implementada por script nesta propriedade
71 Objetos
COMANDO DESCRIÇÃO
Exibir suprimidos Altera o valor da propriedade ShowAlarmsSupressed
para True. A lógica para a exibição dos alarmes
suprimidos deve ser implementada por script nesta
propriedade
Exibir alarmes e eventos Exibe sinalizações de alarmes e de eventos
Exibir eventos Exibe apenas sinalizações de eventos
Reconhecer todos Reconhece globalmente todos os alarmes
Reconhecer seleção Reconhece apenas os alarmes selecionados
Reconhecer exibição atual Reconhece apenas os alarmes sinalizados no objeto

E3Alarms
Silenciar buzina Altera o valor da propriedade SoundOff para True. A

lógica para silenciar o alarme sonoro deve ser
Aplicar filtro Aplica o filtro personalizado no E3Alarm
Editar filtro Edita o filtro personalizado do E3Alarm
A tabela a seguir contém as propriedades do objeto E3AlarmToolbarMultipleView.
Propriedades do objeto E3AlarmToolbarMultipleView
E3AlarmView1 Associação para o primeiro objeto E3Alarm
E3AlarmView2 Associação para o segundo objeto E3Alarm
E3AlarmView3 Associação para o terceiro objeto E3Alarm
Filter String de configuração do filtro personalizado do

E3Alarm
HorizontalOrientation Orientação do menu. Os valores possíveis para esta

propriedade são True: Horizontal ou False: Vertical
Print Retorna True quando o usuário clica em Print
ShowAlarmsShelved Retorna True quando o usuário clica em

ShowAlarmsShelved
ShowAlarmsSupressed Retorna True quando o usuário clica em

ShowAlarmsSupressed
SoundOff Retorna True quando o usuário clica em SilenceHorn
5.2 Gráficos de Barras

Esta seção contém informações sobre os objetos do tipo Gráfico de Barras na Biblioteca HighPerformance
Template.
Objetos 72
NOTA
Os objetos do tipo Gráfico de Barras são totalmente integrados à Biblioteca HighPerformance Template, com
suporte nativo a Temas.
5.2.1 hpBarGraphAlarmLimHorizontal
O objeto hpBargraphAlarmLimHorizontal é um gráfico de barras horizontal que apresenta os limites de alarmes na
forma de bandeiras ou flags sobrepostos à barra indicadora de valor.
Objeto hpBargraphAlarmLimHorizontal
5.2.1.1 Indicações
Esta seção contém informações sobre a indicação do objeto hpBarGraphAlarmLimHorizontal em Setpoints e
Alarmes.
5.2.1.1.1 Setpoint
O Setpoint é indicado através de uma bandeira verde sobre a barra, conforme a figura a seguir.
Setpoint
5.2.1.1.2 Alarmes
O objeto hpBargraphAlarmLimHorizontal indica quatro níveis de alarmes, dois para alarme alto e dois para alarme
baixo, em quatro severidades. Se um alarme da variável monitorada pelo objeto hpBargraphAlarmLimHorizontal
estiver atuado, a respectiva bandeira é colorida de acordo com a severidade.
Severidade crítica
73 Objetos
Severidade alta
Severidade média
Severidade baixa
Objetos 74
A tabela a seguir contém as propriedades do objeto hpBarGraphAlarmLimHorizontal.
Propriedades do objeto hpBarGraphAlarmLimHorizontal
AlarmSource Associação para o objeto Fonte de Alarme Analógico
CurrentValue Valor a ser exibido
CustomColor Cor usada pela barra quando a propriedade

UseCustomColor está configurada com o valor True
DisplayFormat Formatação do Display
DisplayUnit Unidade de engenharia
EditMode Modo de edição da variável. Os valores possíveis são

True: Edição ativada ou False: Edição desativada
EnableClick Permite que este objeto responda a um evento de clique

EventClick

evento de clique do mouse. Válido somente quando o
valor da propriedade EnableClick é igual a True
HideSPLegend Visualização da legenda do Setpoint. Os valores

possíveis são True: Legenda oculta ou False: Legenda
visível
Label Descrição da variável
MaximumValue Valor máximo
MinimumValue Valor mínimo
QualityValue Valor da qualidade da variável
ShowFrame Exibe uma moldura ao redor do objeto. Os valores

possíveis são True: Visível ou False: Oculta
ShowSPIndicator Exibe o indicador de Setpoint. Os valores possíveis são

True: Visível ou False: Oculto
Size Largura do objeto. Os valores possíveis variam entre 0

(zero) e 100%
SPValue Valor do Setpoint
UseCustomColor Habilita a configuração manual da cor da barra,

independente do Tema, definida na propriedade
CustomColor. Os valores possíveis são True: Habilitada
ou False: Desabilitada
75 Objetos
UseXChartColor Habilita a configuração manual da cor da barra,
independente do tema, definida na propriedade
XChartColor. Os valores possíveis são True: Habilitada
ou False: Desabilitada. Esta propriedade foi
descontinuada e vai ser removida da Biblioteca
HighPerformance Template em uma versão futura
XChartColor Cor usada pela barra quando a propriedade

UseXChartColor está configurada com o valor True. Esta
propriedade foi descontinuada e vai ser removida da
Biblioteca HighPerformance Template em uma versão
futura
5.2.2 hpBarGraphAlarmLimVertical
O objeto hpBargraphAlarmLimVertical é um gráfico de barras vertical que apresenta os limites de alarmes na forma
de bandeiras ou flags sobrepostos à barra indicadora de valor.
Objeto
hpBargraphAlarmLimVertical
Esta seção contém informações sobre a indicação do objeto hpBarGraphAlarmLimVertical em Setpoints e Alarmes.
5.2.2.1.1 Setpoint
O Setpoint é indicado através de uma bandeira verde sobre a barra, conforme a figura a seguir.
Objetos 76
Setpoint
5.2.2.1.2 Alarmes
O objeto hpBargraphAlarmLimVertical indica quatro níveis de alarmes, dois para alarme alto e dois para alarme
baixo, em quatro severidades. Se um alarme da variável monitorada pelo objeto hpBargraphAlarmLimVertical estiver
atuado, a respectiva bandeira é colorida de acordo com a severidade.
Severidade crítica
77 Objetos
Severidade alta
Severidade média
Severidade baixa
Objetos 78
A tabela a seguir contém as propriedades do objeto hpBarGraphAlarmLimVertical.
Propriedades do objeto hpBarGraphAlarmLimVertical
CustomColor Cor usada pela barra quando a propriedade

UseCustomColor está configurada com o valor True


EventClick

HideSPLegend Visualização da legenda do Setpoint. Os valores

possíveis são True: Legenda oculta ou False: Legenda
visível
LegendBackgroundMode Visualização da cor de fundo da legenda. Os valores

possíveis são 0: Fundo transparente ou 1: Cor sólida
(ScreenBackground)

ShowSPIndicator Exibe o indicador de Setpoint. Os valores possíveis são

True: Visível ou False: Oculto

(zero) e 100%
SPValue Valor do Setpoint
79 Objetos
UseCustomColor Habilita a configuração manual da cor da barra,
independente do Tema, definida na propriedade
CustomColor. Os valores possíveis são True: Habilitada
ou False: Desabilitada
UseXChartColor Habilita a configuração manual da cor da barra,

independente do tema, definida na propriedade
XChartColor. Os valores possíveis são True: Habilitada
ou False: Desabilitada. Esta propriedade foi
XChartColor Cor usada pela barra quando a propriedade

UseXChartColor está configurada com o valor True. Esta
futura
5.2.3 hpBarGraphAlarmZoneHorizontal
O objeto hpBargraphAlarmZoneHorizontal é um gráfico de barras horizontal que apresenta os limites de alarmes na
forma de áreas situadas ao fundo da barra indicadora de valor.
Objeto
hpBargraphAlarmZoneHorizontal
Esta seção contém informações sobre a indicação do objeto hpBarGraphAlarmZoneHorizontal em Alarmes.
5.2.3.1.1 Alarmes
O objeto hpBargraphAlarmZoneHorizontal indica quatro níveis de alarmes, dois para alarme alto e dois para alarme
baixo, em quatro severidades, conforme indicado nas figuras a seguir.
Níveis de alarme são definidos pela

posição
Severidades de alarme são definidas pela

cor
Se um alarme da variável monitorada pelo objeto hpBargraphAlarmZoneHorizontal estiver atuado, a respectiva

bandeira é colorida de acordo com a severidade, conforme indicado nas figuras a seguir.
Objetos 80
Alarme de nível HiHi e severidade crítica
atuado
Alarme de nível Hi e severidade alta

atuado
Alarme de nível Lo e severidade média

atuado
Alarme de nível LoLo e severidade baixa

atuado
A tabela a seguir contém as propriedades do objeto hpBarGraphAlarmZoneHorizontal.
Propriedades do objeto hpBarGraphAlarmZoneHorizontal


EventClick

81 Objetos

(zero) e 100%
5.2.4 hpBarGraphAlarmZoneVertical
O objeto hpBargraphAlarmZoneVertical é um gráfico de barras vertical que apresenta os limites de alarmes na
forma de áreas situadas ao fundo da barra indicadora de valor.
Objeto
hpBargraphAlarmZoneVertical
Esta seção contém informações sobre a indicação do objeto hpBarGraphAlarmZoneVertical em Alarmes.
5.2.4.1.1 Alarmes
O objeto hpBargraphAlarmZoneVertical indica quatro níveis de alarmes, dois para alarme alto e dois para alarme
baixo, em quatro severidades, conforme indicado nas figuras a seguir.
Níveis de alarme
são definidos
pela posição
Objetos 82
Severidades de
alarme são
definidas pela
cor
Se um alarme da variável monitorada pelo objeto hpBargraphAlarmZoneVertical estiver atuado, a respectiva

bandeira é colorida de acordo com a severidade, conforme as figuras a seguir.
Alarme de
nível HiHi e
severidade
crítica atuado
Alarme de
nível Hi e
severidade
alta atuado
83 Objetos
Alarme de
nível Lo e
severidade
média atuado
Alarme de
nível LoLo e
severidade
baixa atuado
A tabela a seguir contém as propriedades do objeto hpBarGraphAlarmZoneVertical.
Propriedades do objeto hpBarGraphAlarmZoneVertical


EventClick
Objetos 84

(zero) e 100%
5.2.5 hpCombinedBarLineGraph
O objeto hpCombinedBarLineGraph suporta a visualização de até 12 (doze) gráficos de barras verticais combinados,
que apresentam os limites de alarmes na forma de áreas situadas ao fundo das respectivas barras indicadoras de
valor.
Modos de visualização
Este objeto possui três modos de visualizar o valor corrente, descritos a seguir.
Conectores
Objeto hpCombinedBarLineGraph no modo Conectores
85 Objetos
Bullets
Objeto hpCombinedBarLineGraph no modo Bullets
Barras
Objeto hpCombinedBarLineGraph no modo Barras
Esta seção contém informações sobre a indicação do objeto hpCombinedBarLineGraph em Alarmes.
5.2.5.1.1 Alarmes
O objeto hpCombinedBarLineGraph indica, em cada gráfico de barras, quatro níveis de alarmes, dois para alarme
alto e dois para alarme baixo, em quatro severidades, conforme indicado nas figuras a seguir.
Objetos 86
Níveis de alarme
são definidos
pela posição
Severidades de
alarme são
definidas por
sua cor
Se um alarme da variável monitorada pelo objeto hpCombinedBarLineGraph estiver atuado, a respectiva bandeira é
colorida de acordo com a severidade, conforme as figuras a seguir.
Alarme de
nível HiHi e
severidade
crítica atuado
87 Objetos
Alarme de
nível Hi e
severidade
alta atuado
Alarme de
nível Lo e
severidade
média atuado
Alarme de
nível LoLo e
severidade
baixa atuado
A tabela a seguir contém as propriedades do objeto hpCombinedBarLineGraph.
Objetos 88
Propriedades do objeto hpCombinedBarLineGraph
DisplayMode Ajusta o tipo do gráfico. Os valores possíveis são 0:

Bargraph, 1: Bullets ou 2: Conectores


EventClick

NumberOfGraphs Número de gráficos exibidos. Os valores possíveis

variam entre 1 (um) e 12
Var1AlarmSource Associação para o objeto Fonte de Alarme Analógico da

variável 1 (um)
Var1CurrentValue Valor da variável 1 (um)
Var1Label Descrição da variável 1 (um)

variável 2 (dois)
Var2CurrentValue Valor da variável 2 (dois)
Var2Label Descrição da variável 2 (dois)

variável 3 (três)
Var3CurrentValue Valor da variável 3 (três)
Var3Label Descrição da variável 3 (três)

variável 4 (quatro)
Var4CurrentValue Valor da variável 4 (quatro)
Var4Label Descrição da variável 4 (quatro)
89 Objetos
variável 5 (cinco)
Var5CurrentValue Valor da variável 5 (cinco)
Var5Label Descrição da variável 5 (cinco)

variável 6 (seis)
Var6CurrentValue Valor da variável 6 (seis)
Var6Label Descrição da variável 6 (seis)

variável 7 (sete)
Var7CurrentValue Valor da variável 7 (sete)
Var7Label Descrição da variável 7 (sete)

variável 8 (oito)
Var8CurrentValue Valor da variável 8 (oito)
Var8Label Descrição da variável 8 (oito)

variável 9 (nove)
Var9CurrentValue Valor da variável 9 (nove)
Var9Label Descrição da variável 9 (nove)

variável 10
Var10CurrentValue Valor da variável 10
Var10Label Descrição da variável 10

variável 11

variável 12
Objetos 90
5.2.6 hpDiffChart
O objeto hpDiffChart exibe a diferença entre duas faixas de valores, uma acima e outra abaixo do eixo das abscissas.
Objeto hpDiffChart
Este tipo de gráfico é indicado para dois grupos de variáveis que operem na mesma faixa de operação, em que a
diferença de valor entre dois pontos indique uma situação especial do processo.
A tabela a seguir contém as propriedades do objeto hpDiffChart.
Propriedades do objeto hpDiffChart
EventClick

NumberOfGraphs Número de gráficos exibidos. Os valores possíveis

variam entre 1 (um) e 12
Var1TopCurrentValue Valor da variável 1 (um) superior
Var1TopLabel Descrição da variável 1 (um) superior
Var2TopCurrentValue Valor da variável 2 (dois) superior
Var2TopLabel Descrição da variável 2 (dois) superior
Var3TopCurrentValue Valor da variável 3 (três) superior
Var3TopLabel Descrição da variável 3 (três) superior
Var4TopCurrentValue Valor da variável 4 (quatro) superior
Var4TopLabel Descrição da variável 4 (quatro) superior
Var5TopCurrentValue Valor da variável 5 (cinco) superior
Var5TopLabel Descrição da variável 5 (cinco) superior
Var6TopCurrentValue Valor da variável 6 (seis) superior
91 Objetos
Var6TopLabel Descrição da variável 6 (seis) superior
Var7TopCurrentValue Valor da variável 7 (sete) superior
Var7TopLabel Descrição da variável 7 (sete) superior
Var8TopCurrentValue Valor da variável 8 (oito) superior
Var8TopLabel Descrição da variável 8 (oito) superior
Var9TopCurrentValue Valor da variável 9 (nove) superior
Var9TopLabel Descrição da variável 9 (nove) superior
Var10TopCurrentValue Valor da variável 10 superior
Var10TopLabel Descrição da variável 10 superior
Var1BottomCurrentValue Valor da variável 1 (um) inferior
Var1BottomLabel Descrição da variável 1 (um) inferior
Var2BottomCurrentValue Valor da variável 2 (dois) inferior
Var2BottomLabel Descrição da variável 2 (dois) inferior
Var3BottomCurrentValue Valor da variável 3 (três) inferior
Var3BottomLabel Descrição da variável 3 (três) inferior
Var4BottomCurrentValue Valor da variável 4 (quatro) inferior
Var4BottomLabel Descrição da variável 4 (quatro) inferior
Var5BottomCurrentValue Valor da variável 5 (cinco) inferior
Var5BottomLabel Descrição da variável 5 (cinco) inferior
Var6BottomCurrentValue Valor da variável 6 (seis) inferior
Var6BottomLabel Descrição da variável 6 (seis) inferior
Var7BottomCurrentValue Valor da variável 7 (sete) inferior
Var7BottomLabel Descrição da variável 7 (sete) inferior
Var8BottomCurrentValue Valor da variável 8 (oito) inferior
Var8BottomLabel Descrição da variável 8 (oito) inferior
Objetos 92
Var9BottomCurrentValue Valor da variável 9 (nove) inferior
Var9BottomLabel Descrição da variável 9 (nove) inferior
Var10BottomCurrentValue Valor da variável 10 inferior
Var10BottomLabel Descrição da variável 10 inferior
VarMaximumValue Valor máximo
VarMinimumValue Valor mínimo
5.3 Gráficos
Esta seção contém informações sobre os objetos do tipo Gráfico na Biblioteca HighPerformance Template.
NOTA
Os objetos do tipo Gráfico são totalmente integrados à Biblioteca HighPerformance Template, com suporte nativo
a Temas.
5.3.1 hpLineChart
O objeto hpLineChart é um gráfico de tendência que exibe em tempo real o valor de até 3 (três) Penas
simultaneamente, bem como o seu histórico em um intervalo de tempo pré-definido.
Conhecer a tendência da variável pode ajudar a prevenir situações de anormalidade no processo. Para tornar mais
completa a percepção do operador, recomenda-se usar o objeto hpLineChart em conjunto com até 3 (três) gráficos
de barras, conforme a figura a seguir.
93 Objetos
Objeto hpLineChart associado a um gráfico de barras
Desta forma, as variáveis são monitoradas nos seguintes campos:
· Percepção do valor real
· Contexto de normalidade ou anormalidade
· Projeção da tendência ao longo do tempo, se está subindo, descendo ou mantendo-se estável
O objeto hpLineChart deve ser associado a 3 (três) objetos hpLineChartData, onde são realizadas as configurações
da Pena, do intervalo de tempo e do intervalo de valores.
NOTA
O objeto hpLineChart utiliza o valor da propriedade TimeInterval apenas do objeto hpLineChartData indicado na
propriedade VerticalLinkObj1, ignorando as propriedades TimeInterval dos objetos indicados nas propriedades
VerticalLinkObj2 e VerticalLinkObj3. Recomenda-se configurar a propriedade TimeInterval de todos os objetos
hpLineChartData associados às propriedades VerticalLinkObj1, VerticalLinkObj2 e VerticalLinkObj3 com o
mesmo valor, de forma a evitar que o gráfico desenhe as Penas com intervalos diferentes.
A tabela a seguir contém as propriedades do objeto hpLineChart.
Propriedades do objeto hpLineChart
StartRunning Sinaliza a ocorrência de uma atualização de valores no
objeto hpLineChartData ou a ocorrência do evento
OnStartRunning do objeto E3Chart. Os valores possíveis
são True: Sinalização ativa ou False: Sinalização inativa
VerticalLinkObj1 Associação para o objeto hpLineChartData referente à

Pena 1 (um)

Pena 2 (dois)

Pena 3 (três)
Objetos 94
5.3.2 hpLineChartData
O objeto hpLineChartData recebe o valor da variável que é representada em cada Pena no objeto hpLineChart e
armazena seu histórico recente pelo intervalo de tempo definido pelo usuário através da propriedade TimeInterval.
Estes objetos de dados estão situados no item Objetos de Servidor - Objetos de Dados - hpObjects -
DisplayMedia, conforme a figura a seguir.
Item DisplayMedia
O Tag a ser monitorado deve ser associado à propriedade Value do objeto de dados.
Associação na propriedade Value
A seguir este objeto deve ser associado ao correspondente objeto hpLineChart.
A tabela a seguir contém as propriedades do objeto hpLineChartData.
95 Objetos
Propriedades do objeto hpLineChartData
ArrayList Vetor de dados onde cada elemento é uma lista
contendo Valor, Qualidade e Timestamp
EnableLog Habilita mensagens de log usando o método Trace do

Elipse E3 sempre que o valor da propriedade Value
muda
Quality Qualidade da variável
Reset Redefine este objeto para o estado inicial
TimeInterval Intervalo de tempo, em segundos, usado para

visualização e armazenamento dos dados
Value Valor corrente da variável
VerticalMaximum Limite máximo do eixo Y do gráfico
VerticalMinimum Limite mínimo do eixo Y do gráfico
5.3.3 hpRadarChart3Var
O objeto hpRadarChart3Var é um gráfico do tipo Radar para 3 (três) variáveis.
Objeto hpRadarChart3Var
Esta seção contém informações sobre a indicação do objeto hpRadarChart3Var em Setpoints.
5.3.3.1.1 Setpoint
O Setpoint é indicado através de uma linha pontilhada na cor verde disposta sobre os eixos dos gráficos.
A tabela a seguir contém as propriedades do objeto hpRadarChart3Var.
Propriedades do objeto hpRadarChart3Var
EventClick
Objetos 96
ShowLabels Exibe os descritivos das variáveis. Os valores possíveis

são True: Visíveis ou False: Ocultos
SP1 Valor do Setpoint para a variável no eixo 1 (um)
SP2 Valor do Setpoint para a variável no eixo 2 (dois)
SP3 Valor do Setpoint para a variável no eixo 3 (três)
Var1CurrentValue Valor a ser exibido no eixo 1 (um)
Var1Label Descrição da variável no eixo 1 (um)
Var1LimMax Valor máximo da variável no eixo 1 (um)
Var1LimMin Valor mínimo da variável no eixo 1 (um)
Var2CurrentValue Valor a ser exibido no eixo 2 (dois)
Var2Label Descrição da variável no eixo 2 (dois)
Var2LimMax Valor máximo da variável no eixo 2 (dois)
Var2LimMin Valor mínimo da variável no eixo 2 (dois)
Var3CurrentValue Valor a ser exibido no eixo 3 (três)
Var3Label Descrição da variável no eixo 3 (três)
Var3LimMax Valor máximo da variável no eixo 3 (três)
Var3LimMin Valor mínimo da variável no eixo 3 (três)
O objeto hpRadarChart4Var é um gráfico do tipo Radar para 4 (quatro) variáveis.
97 Objetos
5.3.4.1.1 Setpoint
EventClick


SP4 Valor do Setpoint para a variável no eixo 4 (quatro)
Var4CurrentValue Valor a ser exibido no eixo 4 (quatro)
Var4Label Descrição da variável no eixo 4 (quatro)
Objetos 98
Var4LimMax Valor máximo da variável no eixo 4 (quatro)
Var4LimMin Valor mínimo da variável no eixo 4 (quatro)
O objeto hpRadarChart5Var é um gráfico do tipo Radar para 5 (cinco) variáveis.
5.3.5.1.1 Setpoint
EventClick


SP5 Valor do Setpoint para a variável no eixo 5 (cinco)
99 Objetos
Var5CurrentValue Valor a ser exibido no eixo 5 (cinco)
Var5Label Descrição da variável no eixo 5 (cinco)
Var5LimMax Valor máximo da variável no eixo 5 (cinco)
Var5LimMin Valor mínimo da variável no eixo 5 (cinco)
O objeto hpRadarChart9Var é um gráfico do tipo Radar para 9 (nove) variáveis.
Objetos 100
5.3.6.1.1 Setpoint
EventClick


SP5 Valor do Setpoint para a variável no eixo 5 (cinco)
SP6 Valor do Setpoint para a variável no eixo 6 (seis)
SP7 Valor do Setpoint para a variável no eixo 7 (sete)
SP8 Valor do Setpoint para a variável no eixo 8 (oito)
SP9 Valor do Setpoint para a variável no eixo 9 (nove)
101 Objetos
Var5CurrentValue Valor a ser exibido no eixo 5 (cinco)
Var6CurrentValue Valor a ser exibido no eixo 6 (seis)
Var6Label Descrição da variável no eixo 6 (seis)
Var6LimMax Valor máximo da variável no eixo 6 (seis)
Var6LimMin Valor mínimo da variável no eixo 6 (seis)
Var7CurrentValue Valor a ser exibido no eixo 7 (sete)
Var7Label Descrição da variável no eixo 7 (sete)
Var7LimMax Valor máximo da variável no eixo 7 (sete)
Var7LimMin Valor mínimo da variável no eixo 7 (sete)
Var8CurrentValue Valor a ser exibido no eixo 8 (oito)
Var8Label Descrição da variável no eixo 8 (oito)
Var8LimMax Valor máximo da variável no eixo 8 (oito)
Var8LimMin Valor mínimo da variável no eixo 8 (oito)
Var9CurrentValue Valor a ser exibido no eixo 9 (nove)
Var9Label Descrição da variável no eixo 9 (nove)
Var9LimMax Valor máximo da variável no eixo 9 (nove)
Var9LimMin Valor mínimo da variável no eixo 9 (nove)
Objetos 102
O objeto hpRadarChart10Var é um gráfico do tipo Radar de 3 (três) níveis com 10 variáveis em cada nível.
5.3.7.1.1 Setpoint
EventClick

Level1Var1CurrentValue Valor a ser exibido no nível 1 (um), eixo 1 (um)
Level1Var2CurrentValue Valor a ser exibido no nível 1 (um), eixo 2 (dois)
Level1Var3CurrentValue Valor a ser exibido no nível 1 (um), eixo 3 (três)
Level1Var4CurrentValue Valor a ser exibido no nível 1 (um), eixo 4 (quatro)
Level1Var5CurrentValue Valor a ser exibido no nível 1 (um), eixo 5 (cinco)
Level1Var6CurrentValue Valor a ser exibido no nível 1 (um), eixo 6 (seis)
103 Objetos
Level1Var7CurrentValue Valor a ser exibido no nível 1 (um), eixo 7 (sete)
Level1Var8CurrentValue Valor a ser exibido no nível 1 (um), eixo 8 (oito)
Level1Var9CurrentValue Valor a ser exibido no nível 1 (um), eixo 9 (nove)
Level1Var10CurrentValue Valor a ser exibido no nível 1 (um), eixo 10
Level2Var1CurrentValue Valor a ser exibido no nível 2 (dois), eixo 1 (um)
Level2Var2CurrentValue Valor a ser exibido no nível 2 (dois), eixo 2 (dois)
Level2Var3CurrentValue Valor a ser exibido no nível 2 (dois), eixo 3 (três)
Level2Var4CurrentValue Valor a ser exibido no nível 2 (dois), eixo 4 (quatro)
Level2Var5CurrentValue Valor a ser exibido no nível 2 (dois), eixo 5 (cinco)
Level2Var6CurrentValue Valor a ser exibido no nível 2 (dois), eixo 6 (seis)
Level2Var7CurrentValue Valor a ser exibido no nível 2 (dois), eixo 7 (sete)
Level2Var8CurrentValue Valor a ser exibido no nível 2 (dois), eixo 8 (oito)
Level2Var9CurrentValue Valor a ser exibido no nível 2 (dois), eixo 9 (nove)
Level2Var10CurrentValue Valor a ser exibido no nível 2 (dois), eixo 10
Level3Var1CurrentValue Valor a ser exibido no nível 3 (três), eixo 1 (um)
Level3Var2CurrentValue Valor a ser exibido no nível 3 (três), eixo 2 (dois)
Level3Var3CurrentValue Valor a ser exibido no nível 3 (três), eixo 3 (três)
Level3Var4CurrentValue Valor a ser exibido no nível 3 (três), eixo 4 (quatro)
Level3Var5CurrentValue Valor a ser exibido no nível 3 (três), eixo 5 (cinco)
Level3Var6CurrentValue Valor a ser exibido no nível 3 (três), eixo 6 (seis)
Level3Var7CurrentValue Valor a ser exibido no nível 3 (três), eixo 7 (sete)
Level3Var8CurrentValue Valor a ser exibido no nível 3 (três), eixo 8 (oito)
Level3Var9CurrentValue Valor a ser exibido no nível 3 (três), eixo 9 (nove)
Level3Var10CurrentValue Valor a ser exibido no nível 3 (três), eixo 10

SP1 Valor do set-point para a variável no eixo 1 (um)
SP2 Valor do set-point para a variável no eixo 2 (dois)
SP3 Valor do set-point para a variável no eixo 3 (três)
Objetos 104
SP4 Valor do set-point para a variável no eixo 4 (quatro)
SP5 Valor do set-point para a variável no eixo 5 (cinco)
SP6 Valor do set-point para a variável no eixo 6 (seis)
SP7 Valor do set-point para a variável no eixo 7 (sete)
SP8 Valor do set-point para a variável no eixo 8 (oito)
SP9 Valor do set-point para a variável no eixo 9 (nove)
SP10 Valor do set-point para a variável no eixo 10
Var6Label Descrição da variável no eixo 6 (seis)
Var6LimMax Valor máximo da variável no eixo 6 (seis)
Var6LimMin Valor mínimo da variável no eixo 6 (seis)
Var7Label Descrição da variável no eixo 7 (sete)
Var7LimMax Valor máximo da variável no eixo 7 (sete)
Var7LimMin Valor mínimo da variável no eixo 7 (sete)
Var8Label Descrição da variável no eixo 8 (oito)
105 Objetos
Var8LimMax Valor máximo da variável no eixo 8 (oito)
Var8LimMin Valor mínimo da variável no eixo 8 (oito)
Var9Label Descrição da variável no eixo 9 (nove)
Var9LimMax Valor máximo da variável no eixo 9 (nove)
Var9LimMin Valor mínimo da variável no eixo 9 (nove)
Var10Label Descrição da variável no eixo 10
Var10LimMax Valor máximo da variável no eixo 10
Var10LimMin Valor mínimo da variável no eixo 10
Zone2Limit Tamanho da área 2 (dois). Os valores possíveis variam

entre 0 (zero) e 100%
Zone3Limit Tamanho da área 3 (três). Os valores possíveis variam

entre 0 (zero) e 100%
5.3.8 hpScatterGraph
Gráfico que relaciona duas grandezas, uma representada no eixo X e outra no eixo Y, permitindo a visualização
simultânea de até 3 (três) pontos.
Objeto hpScatterGraph
A tabela a seguir contém as propriedades do objeto hpScatterGraph.
Propriedades do objeto hpScatterGraph
NumberOfElements Número de elementos visíveis. Os valores possíveis são
inteiros entre 1 (um) e 3 (três)
Objetos 106
ScaleXMaximum Valor máximo da escala do eixo X
ScaleXMinimum Valor mínimo da escala do eixo X
ScaleYMaximum Valor máximo da escala do eixo Y
ScaleYMinimum Valor mínimo da escala do eixo Y
ShowBottomScale Visualização da escala inferior. Os valores possíveis são

True: Visível ou False: Oculta
ShowLeftScale Visualização da escala esquerda. Os valores possíveis

são True: Visível ou False: Oculta
ShowRightScale Visualização da escala direita. Os valores possíveis são

ShowTopScale Visualização da escala superior. Os valores possíveis são

ShowUnit Visualização do indicador de unidade. Os valores

possíveis são True: Visível ou False: Oculto
Var1XCurrentValue Valor da variável 1 (um) para o eixo X. Os valores

possíveis variam entre -100% e +100%
Var1YCurrentValue Valor da variável 1 (um) para o eixo Y. Os valores

Var2XCurrentValue Valor da variável 2 (dois) para o eixo X. Os valores

Var2YCurrentValue Valor da variável 2 (dois) para o eixo Y. Os valores

Var3XCurrentValue Valor da variável 3 (três) para o eixo X. Os valores

Var3YCurrentValue Valor da variável 3 (três) para o eixo Y. Os valores

XAxisUnit Unidade de engenharia da escala no eixo X
YAxisUnit Unidade de engenharia da escala no eixo Y
5.3.9 hpWindRose
O objeto hpWindRose é um gráfico do tipo Rosa dos Ventos que disponibiliza a visualização de até 16 (dezesseis)
variáveis simultâneas.
107 Objetos
Objeto hpWindRose
Requisitos
Para o funcionamento do objeto hpWindRose, é necessário instanciar e configurar um objeto hpWindRoseData em

uma Pasta de Servidor. Para mais informações sobre esta configuração, consulte o tópico hpWindRoseData.
A tabela a seguir contém as propriedades do objeto hpWindRose.
Propriedades do objeto hpWindRose
DataObject Associação para um objeto hpWindRoseData
GridDivisions Número de divisões radiais
LegendList Lista com os valores de legenda separados por ponto e

vírgula. Estes valores são ordenados no sentido anti-
horário, iniciando pelo Norte, como por exemplo
"N;W;S;E"
Ratio Raio do gráfico, em unidades Himetric
Refresh Atualiza a visualização corrente
ShowAxis Visibilidade dos eixos. Os valores possíveis são True:

Torna os eixos visíveis ou False: Oculta os eixos
SpokePadding Espaçamento, em graus, entre os raios do gráfico
5.3.10 hpWindRoseData
Objeto base para a configuração do objeto hpWindRose.
Objetos 108
A tabela a seguir contém as propriedades do objeto hpWindRoseData.
Propriedades do objeto hpWindRoseData
ErrCode Exibe o código de erro gerado caso um valor inválido
tenha sido configurado na propriedade SpokeNum. Os
valores possíveis para esta propriedade são 0: O valor
digitado é válido, 1: A propriedade SpokeNum foi
corrigida pois o valor digitado é menor que o valor
mínimo, 2: A propriedade SpokeNum foi corrigida pois o
valor digitado é maior que o valor máximo ou 3: A
propriedade SpokeNum foi corrigida pois o valor
digitado é um número ímpar
RadialMin Valor mínimo da escala radial
RadialMax Valor máximo da escala radial
SpokeData01 Valor para o raio 1 (um)
SpokeData02 Valor para o raio 2 (dois)
SpokeData03 Valor para o raio 3 (três)
SpokeData04 Valor para o raio 4 (quatro)
SpokeData05 Valor para o raio 5 (cinco)
SpokeData06 Valor para o raio 6 (seis)
SpokeData07 Valor para o raio 7 (sete)
SpokeData08 Valor para o raio 8 (oito)
SpokeData09 Valor para o raio 9 (nove)
SpokeData10 Valor para o raio 10
SpokeNum Número de eixos radiais. Apenas números pares maiores

ou iguais a 4 (quatro) são permitidos
5.4 Indicadores
Esta seção contém informações sobre os objetos do tipo Indicador na Biblioteca HighPerformance Template.
109 Objetos
NOTAS
· Os objetos do tipo Indicador são totalmente integrados à Biblioteca HighPerformance Template, com suporte
nativo a Temas.
· O objeto hpDigitalDisplay também tem suporte à indicação nativa de alarmes.
5.4.1 hpDigitalDisplay
O objeto hpDigitalDisplay é um indicador para variáveis digitais, exibindo os estados Ligado (On), Desligado (Off),
Qualidade ruim (Bad quality) e Alarme, conforme a figura a seguir.
Objeto
hpDigitalDisplay
A tabela a seguir contém as propriedades do objeto hpDigitalDisplay.
Propriedades do objeto hpDigitalDisplay
AlarmSourceDigital Associação para um objeto Fonte de Alarme Digital
Description Texto descritivo deste objeto
Status Valor corrente da variável. Os valores possíveis são True:

Ligado ou False: Desligado
5.4.2 hpDynamicText
O objeto hpDynamicText é um indicador de texto dinâmico, ou seja, exibe o texto de uma variável lida de campo ou
sua representação, conforme a figura a seguir.
Objeto hpDynamicText
Caso a qualidade da variável seja ruim, este objeto exibe a indicação mostrada na figura a seguir.
Objeto hpDynamicText
com qualidade ruim
A tabela a seguir contém as propriedades do objeto hpDynamicText.
Objetos 110
Propriedades do objeto hpDynamicText
DisplayText Texto a ser exibido

EventClick

5.4.3 hpDynamicValue
O objeto hpDynamicValue é um indicador de valor dinâmico, ou seja, exibe o valor e a unidade de uma variável de
campo, conforme a figura a seguir.
Objeto
hpDynamicValue
Este objeto pode ser exibido na sua configuração padrão ou com o valor e a unidade dispostos verticalmente e
centralizados, conforme a figura a seguir.
Objeto
hpDynamicValue
com valor
centralizado
Caso a qualidade da variável seja ruim, este objeto exibe a indicação conforme a figura a seguir.
Objeto
hpDynamicValue
com qualidade
ruim
A tabela a seguir contém as propriedades do objeto hpDynamicValue.
Propriedades do objeto hpDynamicValue
DisplayValue Valor corrente a ser exibido
111 Objetos
EditMode Sinalização para modo de edição. Os valores possíveis
são True: Edição ativada ou False: Edição desativada

EventClick

UnitPosition Posição da unidade de engenharia. Os valores possíveis

são 0: Direita ou 1: Inferior
5.4.4 hpManualValue
O objeto hpManualValue é um indicador para uma entrada manual de valor, conforme a figura a seguir.
Objeto
hpManualValue
Esta indicação de valor manual difere visualmente da indicação de valor dinâmico do objeto hpDynamicValue
basicamente por sua cor. No entanto, para alguns tipos de deficiências visuais, as duas cores podem ser muito
parecidas, dificultando sua diferenciação. Por este motivo foi acrescentado o ponto entre o valor e sua unidade.
Este objeto pode ser exibido na sua configuração padrão ou com o valor e a unidade dispostos verticalmente e
centralizados, conforme a figura a seguir.
Objeto
hpManualValue
com valor
centralizado
Caso a qualidade da variável seja ruim, o objeto exibe a indicação mostrada na figura a seguir.
Objeto
hpManualValue
com qualidade
ruim
Para o funcionamento correto, o objeto hpManualValue deve ser configurado com Associações nas propriedades
DisplayValue e NewValue, como indicado na figura a seguir.
Objetos 112
Associações no objeto hpManualValue
O valor exibido pelo objeto hpManualValue vem através de uma Associação Simples na propriedade DisplayValue.
Já o valor digitado pelo usuário atualiza a propriedade NewValue, que envia o novo valor para o Tag especificado na
Associação Bidirecional. Isto é particularmente útil em sistemas onde a escrita do valor manual ocorre em um
endereço diferente do valor lido pelo mesmo objeto.
A tabela a seguir contém as propriedades do objeto hpManualValue.
Propriedades do objeto hpManualValue
DisplayValue Valor corrente a ser exibido


do mouse
EnableLimits Habilita a verificação de limites do valor. O valor padrão

desta propriedade é Falso
EventValidate Incrementa seu valor de 1 (um) a 9 (nove) quando este

objeto recebe um evento de clique com o botão
esquerdo do mouse
MaxLimit Configura o limite máximo do valor
MinLimit Configura o limite mínimo do valor
NewValue Novo valor validado
113 Objetos
SetPointDataType Tipo de dados para o Setpoint

5.4.5 hpManualValueIO
O objeto hpManualValueIO funciona da mesma forma que o objeto hpManualValue, exceto que recebe o valor de
um Tag de Comunicação através da propriedade IOData. A tabela a seguir contém as propriedades deste objeto.
Propriedades do objeto hpManualValueIO

EnableClick Habilita este objeto a responder ao clique do mouse
EnableLimits Habilita a verificação de limites do valor. O valor padrão

desta propriedade é Falso
IOData Associação para o objeto de dados com o valor
NewValue Novo valor validado

5.4.6 hpRadialBar
O objeto hpRadialBar é um indicador que representa um dado graficamente através de um círculo preenchido
dinamicamente. Existe a opção de se exibir a representação numérica de um dado em conjunto com a representação
gráfica, conforme a figura a seguir.
Objeto hpRadialBar
Este objeto possui 4 (quatro) diferentes posicionamentos para o indicador numérico, com possibilidade de ajuste da
margem entre ambos indicadores, conforme a figura a seguir.
Objeto hpRadialBar com ajustes de margem
É possível configurar valores máximos e mínimos de forma a plotar o gráfico dentro do intervalo fornecido.
Objetos 114
A tabela a seguir contém as propriedades do objeto hpRadialBar.
Propriedades do objeto hpRadialBar
CurrentValue Valor corrente a ser exibido
DisplayHorizShift Distância entre o Display e o gráfico. Os valores possíveis

variam entre 0 (zero) e 100%
DisplayPosition Posição do Display. Os valores possíveis são 0: Superior,

1: Direita, 2: Inferior ou 3: Esquerda
ShowDisplay Visibilidade do Display. Os valores possíveis são True:

Visível ou False: Oculto
5.4.7 hpRadialBarPerc
O objeto hpRadialBarPerc é um indicador que representa um valor percentual de forma gráfica através de um círculo
preenchido dinamicamente, em conjunto com a representação numérica correspondente, conforme a figura a seguir.
Objeto
hpRadialBarPerc
Este objeto possui somente a propriedade CurrentValue, que é o valor a ser exibido.
5.4.8 hpRadialBarPercIcon
O objeto hpRadialBarPercIcon é um indicador que representa um valor percentual de forma gráfica através de um
círculo preenchido dinamicamente, em conjunto com a exibição de um ícone, conforme a figura a seguir.
Objeto
hpRadialBarPercIcon
A tabela a seguir contém as propriedades do objeto hpRadialBarPercIcon.
115 Objetos
Propriedades do objeto hpRadialBarPercIcon
IconGallery Nome do arquivo de biblioteca que contém os ícones da

Biblioteca HighPerformance Template. Esta
propriedade é válida somente se o valor da propriedade
IconName é diferente de vazio
IconName Nome do ícone a ser exibido. Se esta propriedade está

configurada com um valor vazio, o ícone permanece
oculto
5.5 Navegação e Abertura de Telas

Esta seção contém informações sobre os objetos do tipo Navegação e Abertura de Telas na Biblioteca
NOTAS
· Os objetos do tipo Navegação e Abertura de Telas são totalmente integrados à Biblioteca HighPerformance
Template, com suporte nativo a Temas.
· Os objetos hpPageReference, hpScreenOpen e hpLyraMenu também têm suporte à tradução automática
mediante configuração prévia e ao registro automático da Tela aberta no histórico de navegação.
· O objeto hpPopupOpen também tem suporte à configuração através de Templates pré-definidos. Para mais
informações, consulte o objeto hpPopupTemplate.
· O objeto hpScreenNav também tem acesso nativo ao histórico de navegação e alinhamento automático entre
objetos de um menu.
5.5.1 hpDotPagination
Este objeto implementa um controle para navegação entre múltiplas páginas. Este controle é útil para dispositivos
móveis ou telas críticas de processos e o número de páginas varia entre 2 (duas) e 6 (seis). O nome do objeto a ser
incluído em Tela varia conforme o número de páginas desejadas. Por exemplo, para incluir um controle com 2 (duas)
páginas, use um objeto hpDotPagination2Pages. A figura a seguir mostra um exemplo de um objeto com 3 (três)
páginas, ou seja, um objeto hpDotPagination3Pages.
Objeto hpDotPagination3Pages
A tabela a seguir contém as propriedades aplicáveis aos objetos hpDotPagination2Pages até
hpDotPagination6Pages.
Objetos 116
Propriedades dos objetos do tipo hpDotPagination
NumberOfPages Indica o número de páginas que este controle gerencia.
Esta propriedade é somente de leitura
SelectedPage Indica a página selecionada neste controle. O valor desta

propriedade deve ser um número maior ou igual a 1
(um) e menor ou igual ao valor da propriedade
NumberOfPages
5.5.2 hpLyraData
O objeto hpLyraData permite construir e configurar a estrutura de dados de um menu de navegação, a fim de que a
estrutura possa ser lida e renderizada por outro objeto do tipo menu, como por exemplo o objeto hpLyraMenu. Para
utilizá-lo, siga estes procedimentos:
1. Crie uma estrutura de objetos que reflita a estrutura de navegação do menu. A estrutura dever ter como pai um
único objeto hpLyraData, que não é mostrado no menu, e como filhos os itens que são efetivamente exibidos no
menu.
Objeto
hpLyraData
2. Renomeie cada item com o descritivo que deve aparecer no menu.
3. Em seguida, configure a propriedade Behaviour de cada item filho com os valores 0 (zero) se o item possui filhos
(função de expandir ou recolher itens) ou outra função definida pelo usuário em um script, 1 (um) se o item não
possui filhos e sua função é abrir uma Tela ou 2 (dois) se o item não possui filhos e sua função é abrir uma janela
pop-up.
4. Configure qual item deve aparecer selecionado ao iniciar o menu definindo o valor True à propriedade
StartScreen do item correspondente
5. Configure as outras propriedades de cada item, como por exemplo o controle de autenticação, tradução, ícone a
ser exibido e endereços das Telas ou janelas a serem abertas.
Após configurada a estrutura de dados, o próximo passo é gerar o código XML desta estrutura para que possa ser
lido pelo objeto renderizador do menu de navegação. Para mais detalhes sobre a geração de código XML, consulte o
tópico hpXMLCatalog. Para uma visão geral sobre a configuração completa de um menu de navegação, consulte o
tópico Guia Rápido de Configuração.
A tabela a seguir contém as propriedades do objeto hpLyraData.
Propriedades do objeto hpLyraData
AuthorizedGroups Lista dos grupos de usuários que têm permissão para
operar o comando. Os grupos devem estar separados
por ponto e vírgula
117 Objetos
AutoScale Ajusta o tamanho do ícone automaticamente ao objeto

são 0: Definido pelo usuário, 1: Abre uma Tela ou 2: Abre
uma janela pop-up. Os valores 1 (um) e 2 (dois) são
aplicáveis somente no caso em que não existam objetos
filhos do item em questão na estrutura de dados. Caso o
item possua filhos, o comportamento do objeto é o de
expandir o menu para exibi-los
EnableAuthControl Habilita o controle de autenticação. Os valores possíveis

são True: Controle habilitado ou False: Controle
desabilitado
EnableClickWhenSelected Configura o comportamento deste objeto quando estiver

selecionado. Os valores possíveis são True: Habilita o
evento OnClick ou False: Desabilita o evento OnClick
EnableTranslation Habilita a tradução automática. Esta propriedade foi

EventClick Incrementa seu valor de 1 (um) a 9 (nove) quando este

esquerdo do mouse
GroupName A propriedade GroupName foi descontinuada. Esta

propriedade vai ser removida da Biblioteca

propriedade só é válida se o valor da propriedade
IconName Nome do ícone a ser exibido. Se esta propriedade é

configurada com o valor vazio, o ícone permanece oculto
MenuDescription Dica (tip) exibida no menu
OpenScreenCode Código para abrir uma Tela, no formato Frame{Screen?

n?n?n,Arg}. O parâmetro Arg é opcional. Para declarar
dois ou mais Quadros, estes devem ser separados por
ponto e vírgula. Esta propriedade é usada somente
quando a propriedade Behaviour é igual a 1 (um)
popArg Parâmetro Arg da Tela. Esta propriedade é usada

somente quando a propriedade Behaviour é igual a 2
(dois)
popName Caminho da Tela. Esta propriedade é usada somente

quando a propriedade Behaviour é igual a 2 (dois)
popTemplate Associação para um objeto hpPopupTemplate que

contém as configurações para a abertura da janela
popTitle Título da janela. Esta propriedade é usada somente

quando a propriedade Behaviour é igual a 2 (dois)
Objetos 118
scrArg Parâmetro Arg da Tela. Esta propriedade é usada
(um). Esta propriedade foi descontinuada e vai ser
removida da Biblioteca HighPerformance Template em
uma versão futura
scrArgContent Argumento da Tela a ser aberta no Quadro

hpFrameSetContent. Esta propriedade é usada somente
scrArgFooter Argumento da Tela a ser aberta no Quadro

hpFrameSetFooter. Esta propriedade é usada somente
scrArgHeader Argumento da Tela a ser aberta no Quadro

hpFrameSetHeader. Esta propriedade é usada somente
scrArgLeft Argumento da Tela a ser aberta no Quadro

hpFrameSetLeft. Esta propriedade é usada somente
scrArgMaster Argumento da Tela a ser aberta no Quadro

hpFrameSetMaster. Esta propriedade é usada somente
scrArgMenu Argumento da Tela a ser aberta no Quadro

hpFrameSetMenu. Esta propriedade é usada somente
scrArgRight Argumento da Tela a ser aberta no Quadro

hpFrameSetRight. Esta propriedade é usada somente
scrAutoMonitor Detecta automaticamente o número do monitor e abre a

Tela neste monitor. Esta propriedade é usada somente
quando a propriedade Behaviour é igual a 1 (um). Esta
futura
scrContent Caminho da Tela a ser aberta no Quadro

scrFooter Caminho da Tela a ser aberta no Quadro

scrHeader Caminho da Tela a ser aberta no Quadro

scrLeft Caminho da Tela a ser aberta no Quadro

119 Objetos
scrMaster Caminho da Tela a ser aberta no Quadro
scrMenu Caminho da Tela a ser aberta no Quadro

scrMonitorNumber Número do monitor onde a Tela é aberta. Esta

propriedade é usada somente quando a propriedade
Behaviour é igual a 1 (um). Esta propriedade foi
scrMonitorSelection Seleciona o monitor onde ocorre a abertura de Tela. Os

valores possíveis são -1: Seleciona todos os monitores
de um perfil ignorando templates ou declarações de
Telas, 0: Seleciona o monitor onde ocorreu o clique do
mouse, 1 ou superior: Número identificador do monitor
onde a Tela é aberta. Esta propriedade é usada somente
scrProfile Perfil de navegação a ser aberto. Esta propriedade é

usada somente quando a propriedade Behaviour é igual
a 1 (um)
scrRight Caminho da Tela a ser aberta no Quadro

scrTemplate Nome do Template de Quadro sem o sufixo numérico

que identifica o monitor, como por exemplo
hpFrameHeader. Deve ser configurado nos casos em
que um novo Template de Quadro é carregado ou caso
mais de uma Tela deva ser aberta simultaneamente no
Template de Quadro corrente. Esta propriedade é usada
(um)
ShiftL2 Deslocamento vertical do bloco de objetos L2 em

relação ao seu objeto pai L1. Os valores possíveis são 0:
Bloco de objetos L2 posicionado na mesma coordenada
Y do objeto L1 ou Maior que zero: Bloco de objetos L2
sobe o número de posições especificado em relação ao
objeto L1, limitado à posição do primeiro objeto L1 do
menu
StartScreen Configura a Tela que aparece selecionada ao iniciar o

menu. Os valores possíveis são True: Tela selecionada ou
False: Tela não selecionada
5.5.2.2 Migrando uma Estrutura de Dados para o Objeto hpLyraData

Para migrar uma estrutura de objetos hpNavData para o novo objeto hpLyraData, preservando as configurações
realizadas nas propriedades, deve-se utilizar um objeto ~hpConvertDataStruct da biblioteca hpUtilities, conforme o
roteiro a seguir.
Objetos 120
1. Instancie um objeto ~hpConvertDataStruct na mesma pasta onde se encontra o objeto raiz da estrutura de
objetos hpNavData.
2. Configure a propriedade OriginPathName deste objeto com o valor da propriedade PathName do objeto
hpNavData raiz.
3. Configure a propriedade DestinationName deste objeto com o nome do novo objeto raiz hpLyraData.
Certifique-se de usar um nome diferente do que já existe para o objeto raiz hpNavData.
4. Clique com o botão direito do mouse no objeto ~hpConvertDataStruct e selecione a opção Configurar para
criar a mesma pasta da estrutura original com uma nova estrutura de objetos hpLyraData.
IMPORTANTE
· Antes de excluir a estrutura antiga, certifique-se de copiar corretamente todos os objetos e as respectivas
configurações.
· Qualquer aplicação que use objetos hpNavData pode conter códigos em XML que referenciam o objeto
hpNavData. Estes códigos em XML devem ser gerados novamente com o novo objeto hpLyraData implementado
no lugar do antigo, para que sejam atualizados com o valor correto.
5.5.3 hpLyraMenu
O menu de navegação Lyra é um menu vertical composto por objetos dispostos em dois níveis hierárquicos, L1 e L2,
que possibilitam tanto a navegação entre Telas quanto a abertura de caixas de diálogos.
Objeto hpLyraMenu
Requisitos
Para o funcionamento do objeto hpLyraMenu, são necessários os seguintes requisitos:
· Construção e configuração de uma estrutura de navegação utilizando objetos hpLyraData
· Geração de código XML desta estrutura de navegação. Para mais detalhes sobre a geração de código XML para
o objeto hpLyraMenu, consulte o tópico hpXMLCatalog
· Instanciação e configuração do objeto hpLyraMenu para ler o código XML e exibir a estrutura de navegação.
Para mais detalhes sobre a configuração da navegação do objeto hpLyraMenu, consulte o tópico Guia Rápido
de Configuração
A tabela a seguir contém as propriedades do objeto hpLyraMenu.
121 Objetos
Propriedades do objeto hpLyraMenu
AuthDeniedMsg Mensagem que deve ser exibida em uma janela pop-up
sinalizando ao usuário que este não tem privilégios para
operar este menu. Deixe esta propriedade vazia para
desabilitar esta sinalização
AuthDeniedCode Retorna o resultado da função que verifica os privilégios

de acesso. Os valores possíveis para esta propriedade
são 0: Acesso autorizado, 1: Acesso negado a usuário
sem privilégios ou 2: Acesso negado por herança
DataFolder Associação para um objeto hpLyraData que contém a

estrutura de navegação
DefaultSLI Especifica o Indicador Único de Linguagem (SLI) do

idioma principal para as Associações de tradução. O
valor padrão desta propriedade é "pt-BR" (português do
Brasil)
DocInput Associação com um Tag Interno que contém a estrutura

de navegação no formato XML DOM
EnableTranslation Habilita a tradução automática
ForceReset Modo de seleção ao iniciar este menu. Configure esta

propriedade em True para apagar a seleção e em False
para manter a seleção existente antes da inicialização
Margin Espaço, em unidades Himetric, entre os controles do

menu
RedrawTrigger Tag Interno do Viewer que controla a renderização deste

menu. Ao variar o valor do Tag para 1 (um), o processo
de redesenho do menu é disparado. Este procedimento
não zera o valor do Tag
5.5.4 hpNavData
O objeto hpNavData foi descontinuado. Este objeto não recebe mais atualizações e vai ser removido da Biblioteca
HighPerformance Template em uma versão futura. Recomenda-se o uso do objeto hpLyraData no lugar deste
objeto.
NOTA
Para migrar uma estrutura de objetos hpNavData para o novo objeto hpLyraData, preservando as configurações
realizadas nas propriedades, consulte o tópico Migrando uma Estrutura de Dados para o objeto hpLyraData.
5.5.5 hpNavFrameSet
O objeto hpNavFrameSet é um componente da estrutura de navegação e representa o Divisor de navegação. Para
mais informações, consulte o tópico Exemplo de Configuração.
A tabela a seguir contém as propriedades do objeto hpNavFrameSet.
Objetos 122
Propriedades do objeto hpNavFrameSet
RawFrame Retorna o nome do Quadro adaptativo que referencia
este objeto
SplitLink String de abertura da Tela
SplitValue Define o valor da propriedade SplitValue do Quadro,

em unidades Himetric
5.5.6 hpNavMonitor
O objeto hpNavMonitor é um componente da estrutura de navegação e representa um Monitor da matriz de
Monitores definida no objeto hpNavProfile. Para mais informações, consulte o tópico Exemplo de Configuração.
A tabela a seguir contém as propriedades do objeto hpNavMonitor.
Propriedades do objeto hpNavMonitor
StartupTemplateName Nome do objeto hpNavTemplate usado na inicialização
do Viewer. Uma String vazia força o carregamento do
primeiro objeto filho declarado
5.5.7 hpNavProfile
O objeto hpNavProfile é um componente da estrutura de navegação e representa um Perfil de Navegação. Para mais
informações, consulte o tópico Exemplo de Configuração.
A tabela a seguir contém as propriedades do objeto hpNavProfile.
Propriedades do objeto hpNavProfile
AuthorizedComputers Lista contendo os nomes dos computadores, separados
por ponto e vírgula, que podem acessar este Perfil de
Navegação. Um asterisco (*) nesta propriedade indica
que este Perfil é acessível a partir de qualquer estação
MonitorsMatrix Define a matriz de Monitores utilizada por este Perfil de

Navegação, no formato LxC, ou seja, linha versus coluna
StoreXML Habilita o armazenamento de código XML na

propriedade xmlData
ViewerWidth Define a largura do Viewer, em pixels
ViewerHeight Define a altura do Viewer, em pixels
xmlData Conteúdo do objeto, no formato XML
123 Objetos
5.5.8 hpNavTemplate
O objeto hpNavTemplate é um componente da estrutura de navegação e representa o Template de navegação, ou
Quadro. Para mais informações, consulte o tópico Exemplo de Configuração.
A tabela a seguir contém as propriedades do objeto hpNavTemplate.
Propriedades do objeto hpNavTemplate
PanelsConfig Código de configuração de painéis, de uso interno pelo
Assistente de Configuração de Navegação
XMLFramesHierarchy Configuração de Quadros, no formato XML, de uso

interno pelo Assistente de Configuração de Navegação
5.5.9 hpPageReference
Abre uma Tela da aplicação em um Quadro ou Template de Quadro especificado. Para mais detalhes sobre como
configurar objetos para abrir Telas e janelas, consulte o tópico Navegação.
A tabela a seguir contém as propriedades do objeto hpPageReference.
Propriedades do objeto hpPageReference
possíveis são 0: Definido pelo usuário ou 1: Abre a tela
configurada
Direction Altera a direção da seta. Os valores possíveis são 1:

Direita ou 2: Esquerda

EnableTranslation Habilita o recurso de tradução automática

True
Lines Ajusta a visualização de linhas. Os valores possíveis são

1: Uma linha ou 2: Duas linhas

Objetos 124
scrArg Corresponde ao parâmetro Arg de uma Tela. Esta

srcArgFooter Argumento da Tela a ser aberta no Quadro







quando a propriedade Behaviour é igual a 1 (um). Esta
futura




125 Objetos




a 1 (um)


hpFrameHeader. Esta propriedade deve ser configurada
nos casos em que um novo Template de Quadros é
carregado ou caso mais de uma Tela deva ser aberta
simultaneamente no Template de Quadros corrente. Esta
Behaviour é igual a 1 (um)
Size Largura do objeto. Os valores possíveis para esta

propriedade são inteiros no intervalo entre 0 (zero), a
menor largura, e 8 (oito), a maior largura
TextValue Texto a ser exibido
5.5.10 hpPopupOpen
Abre uma janela do tipo pop-up usando um Template de configuração e uma referência de coordenadas para
posicionamento da janela, ambos definidos pelo usuário.
Template de Configuração
O Template de configuração deve ser indicado na propriedade popTemplate. Trata-se de um objeto do tipo
hpPopupTemplate (Associação para o objeto).
Objetos 126
Referência de Coordenadas
A referência de coordenadas deve ser definida na propriedade CoordinatesReference. Cada instância de um objeto
hpPopupOpen pode usar uma referência distinta, com prioridade sobre as configurações de posicionamento da
janela definidas no Template de configuração.
Para posicionar a janela a ser aberta usando as coordenadas definidas no Template de configuração, defina a
propriedade CoordinatesReference com o valor 0 (zero).
Para abrir a janela em uma coordenada definida manualmente, configure a propriedade CoordinatesReference com o
valor 1 (um) e informe, nas propriedades XCoordinate e YCoordinate, os valores absolutos em pixels.
Para usar o próprio objeto hpPopupOpen como referência de posição para a abertura da janela, configure a
propriedade CoordinatesReference com o valor 2 (dois). Em seguida informe na propriedade
ObjectPositionReference qual parte do objeto hpPopupOpen deve-se usar como referência. Na propriedade
ObjectMarginForOpening é possível definir a distância que o ponto de abertura da Tela tem do objeto.
ObjectPositionReference com ObjectMarginForOpening igual a zero
ObjectPositionReference com ObjectMarginForOpening maior que zero
127 Objetos
Para abrir a janela próxima à posição onde ocorre o clique do mouse, configure a propriedade
CoordinatesReference com o valor 3 (três). A função calcula automaticamente qual a melhor posição da janela com
base no tamanho da Tela e na distância que o ponto de clique tem das margens.
Para mais detalhes sobre como configurar objetos para abrir Telas e janelas, consulte o tópico Navegação.
A tabela a seguir contém as propriedades do objeto hpPopupOpen.
Propriedades do objeto hpPopupOpen
AppendMonitorID Acrescenta o identificador do monitor, como por
exemplo 01 ou 02, ao final do nome do Quadro onde a
janela pop-up está sendo aberta
CoordinatesReference Define a referência utilizada para as coordenadas de

abertura da Tela. Os valores possíveis para esta
propriedade são 0: hpPopupTemplate, 1: Valor manual,
2: Este objeto ou 3: Ponteiro do mouse. Para valores
manuais (1, um), preencha os valores das propriedades
XCoordinate e YCoordinate. Para este objeto (2, dois),
preencha os valores das propriedades
ObjectPositionReference e ObjectMarginForOpening
EventRightClick Incrementa seu valor de 1 (um) a 9 (nove) quando este

objeto recebe um evento de clique com o botão direito
do mouse
EnableXAuth Habilita a extensão de autenticação da Biblioteca

ObjectMarginForOpening Define a margem, em pixels, a ser aplicada neste objeto

ao usá-lo como referência de posição. Esta propriedade
é válida somente quando o valor da propriedade
CoordinatesReference é igual a 2 (dois)
ObjectPositionReference Define a posição relativa ao objeto onde a Tela é aberta.

Os valores possíveis para esta propriedade são 1:
Superior-Esquerda, 2: Superior-Centro, 3: Superior-
Direita, 4: Centro-Esquerda, 5: Centro-Centro, 6: Centro-
Direita, 7: Inferior-Esquerda, 8: Inferior-Centro ou 9:
Inferior-Direita. Esta propriedade é válida somente
quando o valor da propriedade CoordinatesReference é
igual a 2 (dois)
popArg Parâmetro Arg da tela
popFrame Nome do Quadro em que a janela pop-up é aberta ou

deixe esta propriedade em branco para um valor
automático. Esta propriedade é válida apenas para Telas
não modais
popName Caminho da Tela a ser aberta
popTemplate Associação para um objeto hpPopupTemplate que

contém os parâmetros de configuração da janela do tipo
pop-up
Objetos 128
popTitle Título da janela
XCoordinate Valor manual para a coordenada X de abertura da Tela,

em pixels. Esta propriedade é válida somente quando o
valor da propriedade CoordinatesReference é igual a 1
(um)
YCoordinate Valor manual para a coordenada Y de abertura da Tela,

em pixels. Esta propriedade é válida somente quando o
valor da propriedade CoordinatesReference é igual a 1
(um)
5.5.11 hpPopupTemplate
Template de configuração de janelas do tipo pop-up. Este objeto deve ser associado à propriedade popTemplate dos
objetos que possuem este recurso. Para mais detalhes sobre como configurar objetos para abrir Telas e janelas,
consulte o tópico Navegação.
A tabela a seguir contém as propriedades do objeto hpPopupTemplate.
Propriedades do objeto hpPopupTemplate
Autosize Calcula e configura automaticamente o tamanho da
janela a ser aberta com base no seu conteúdo
flagCenterWindow Centraliza a janela no monitor principal
flagConfigToolbarType Configura a janela para o estilo Barra de Ferramentas
flagDisableObjectButtons Desabilita os botões de objeto
flagEnableWindowMove Habilita a janela para ser movida
flagEnableWindowScale Habilita o redimensionamento da janela
flagShowCloseButton Exibe o botão Fechar na janela
flagShowMaximizeButton Exibe o botão Maximizar na janela
flagShowMinimizeButton Exibe o botão Minimizar na janela
flagShowWindowBorder Exibe a borda da janela
flagShowWindowOnTop Exibe a janela sempre à frente das demais janelas
flagShowWindowTitle Exibe a barra de título na janela
Height Altura da janela, em pixels
129 Objetos
MarginMode Ajusta automaticamente as margens da janela caso a
propriedade Autosize esteja configurada com o valor
True. Os valores possíveis para esta propriedade são 0:
Margem direita igual à margem esquerda e margem
inferior igual à margem superior, 1: Margem direita igual
à margem superior e margem inferior igual à margem
esquerda, 2: Margem direita igual à margem esquerda e
margem inferior igual à margem esquerda, 3: Margem
direita igual à margem superior e margem inferior igual
à margem superior, e 4: Margem direita igual a 0 (zero)
e margem superior igual a 0 (zero)
ModalScreen Modo da janela. Os valores possíveis para esta

propriedade são True: Janela modal ou False: Janela não
modal
Width Largura da janela, em pixels
XCoordinate Coordenada X da janela, em pixels
YCoordinate Coordenada Y da janela, em pixels
5.5.12 hpScreenNav
O objeto hpScreenNav é um menu de navegação com duas opções de comando, Voltar à tela anterior ou Avançar à
próxima Tela, conforme a figura a seguir.
Objeto
hpScreenNav
Para usá-lo, siga estes procedimentos:
1. No Studio, instancie um objeto hpScreenNav em Tela.
2. Configure em suas propriedades qual Quadro a Tela alvo da navegação deve ser aberta. Por exemplo, para
direcionar a navegação para o quadro hpFrameSetContent, ajuste o valor da propriedade scrContent para True,
deixando as demais propriedades configuradas em False.
A tabela a seguir contém as propriedades do objeto hpScreenNav.
Propriedades do objeto hpScreenNav
GroupElementID Número que define a posição do objeto dentro do
grupo. Esta propriedade é usada no recurso de
alinhamento automático entre objetos de um menu
GroupName Nome do grupo de objetos. Esta propriedade é usada

no recurso de alinhamento automático entre objetos de
um menu
Objetos 130
GroupOrientation Orientação dos objetos dentro de um grupo. Os valores
possíveis são 1: Horizontal ou 2: Vertical. Esta
propriedade é usada no recurso de alinhamento
automático entre objetos de um menu
Margin Margem, em unidades Himetric, entre os objetos de um

mesmo grupo. Esta propriedade é usada no recurso de
scrContent Configura o Quadro hpFrameSetContent como o

Quadro onde a Tela é aberta. Os valores possíveis são
True: Abre a Tela ou False: Não abre a Tela. Esta
futura
scrFooter Configura o Quadro hpFrameSetFooter como o Quadro

onde a Tela é aberta. Os valores possíveis são True:
Abre a Tela ou False: Não abre a Tela. Esta propriedade
foi descontinuada e vai ser removida da Biblioteca
scrHeader Configura o Quadro hpFrameSetHeader como o Quadro

scrLeft Configura o Quadro hpFrameSetLeft como o Quadro

scrMaster Configura o Quadro hpFrameSetMaster como o Quadro

scrMenu Configura o Quadro hpFrameSetMenu como o Quadro

scrRight Configura o Quadro hpFrameSetRight como o Quadro

5.5.13 hpScreenOpen
Abre uma ou mais Telas no Quadro ou Quadros especificados. Para mais detalhes sobre como configurar objetos
para abrir Telas e janelas, consulte o tópico Navegação.
131 Objetos
A tabela a seguir contém as propriedades do objeto hpScreenOpen.
Propriedades do objeto hpScreenOpen
EventRightClick Incrementa seu valor de 1 (um) a 9 (nove) quando este
objeto recebe um evento de clique com o botão direito
do mouse

ponto e vírgula
scrArg Parâmetro Arg da Tela. Esta propriedade foi









Tela neste monitor. Esta propriedade foi descontinuada e
vai ser removida da Biblioteca HighPerformance
Template em uma versão futura

hpFrameSetContent

hpFrameSetFooter
Objetos 132
hpFrameSetHeader

hpFrameSetLeft

hpFrameSetMaster

hpFrameSetMenu

futura


a 1 (um)

hpFrameSetRight

hpFrameHeader. Deve ser configurado nos casos em
que um novo Template de Quadros é carregado ou caso
mais de uma Tela deva ser aberta simultaneamente no
Template de Quadro corrente
5.6 Formulários
Esta seção contém informações sobre os objetos do tipo Formulário na Biblioteca HighPerformance Template.
NOTAS
· Os objetos do tipo Formulário são totalmente integrados à Biblioteca HighPerformance Template, com suporte
nativo a Temas.
· Os objetos hpCheckBox, hpCommandButton, hpOptionButton e hpToggleButton também têm suporte nativo
ao recurso de tradução automática mediante configuração prévia.
· O objeto hpTextBox também tem suporte ao uso como Date Time Picker.
5.6.1 hpCheckBox
O objeto hpCheckBox (Caixa de Seleção) indica se uma determinada opção está selecionada ou não, ou ainda se está
parcialmente selecionada.
133 Objetos
Objeto
hpCheckBox
Para mais detalhes sobre como acessar propriedades, métodos ou eventos que não estão disponíveis em instâncias
deste objeto, consulte o tópico Acesso a Propriedades, Métodos ou Eventos Não Disponíveis nas Instâncias.
A tabela a seguir contém as propriedades do objeto hpCheckBox.
Propriedades do objeto hpCheckBox
EventBeforeDragOver Vetor que contém os parâmetros do evento

BeforeDragOver. Os elementos do vetor retornado por
esta propriedade são os seguintes:
Elemento 0: Parâmetro Cancel
Elemento 1: Parâmetro Data
Elemento 2: Parâmetro X
Elemento 3: Parâmetro Y
Elemento 4: Parâmetro DragState
Elemento 5: Parâmetro Effect
Elemento 6: Parâmetro Shift
EventBeforeDropOrPaste Vetor que contém os parâmetros do evento

BeforeDropOrPaste. Os elementos do vetor retornado
por esta propriedade são os seguintes:
Elemento 1: Parâmetro Action
EventChange Incrementa seu valor de 1 (um) a 9 (nove) quando este

objeto tem seu valor alterado

esquerdo do mouse
Objetos 134
EventDblClick Incrementa seu valor de 1 (um) a 9 (nove) quando este
objeto recebe um evento de clique duplo com o botão
esquerdo do mouse
EventError Vetor que contém os parâmetros do evento Error. Os

elementos do vetor retornado por esta propriedade são
os seguintes:
Elemento 0: Parâmetro Number
Elemento 1: Parâmetro Description
Elemento 2: Parâmetro SCode
Elemento 3: Parâmetro Source
Elemento 4: Parâmetro HelpFile
Elemento 5: Parâmetro HelpContext
Elemento 6: Parâmetro CancelDisplay
EventKeyDown Vetor que contém os parâmetros do evento KeyDown.

Os elementos do vetor retornado por esta propriedade
são os seguintes:
Elemento 0: Parâmetro KeyCode
EventKeyPress Vetor que contém os parâmetros do evento KeyPress. O

elemento do vetor retornado por esta propriedade é o
parâmetro KeyAscii
EventKeyUp Vetor que contém os parâmetros do evento KeyUp. Os

os seguintes:
EventMouseDown Vetor que contém os parâmetros do evento

MouseDown. Os elementos do vetor retornado por esta
propriedade são os seguintes:
Elemento 0: Parâmetro Button
EventMouseMove Vetor que contém os parâmetros do evento

MouseMove. Os elementos do vetor retornado por esta
135 Objetos
EventMouseUp Vetor que contém os parâmetros do evento MouseUp.

são os seguintes:
GroupName Nome do grupo de objetos
TripleState Habilita este objeto para configurar ou retornar 3 (três)

valores de estado
Value Valor atual da variável
5.6.2 hpComboBox
O objeto hpComboBox (Lista de Seleção) combina as funcionalidades de uma lista com um editor de texto.
Objeto hpComboBox
O acesso a propriedades ou métodos do objeto hpComboBox original, não disponíveis nas instâncias, é realizado
através da propriedade Object.
O script a seguir ilustra o caso em que o acesso ao método AddItem é realizado a partir do próprio objeto
hpComboBox.
Sub hpComboBox1_OnStartRunning()
Object.AddItem "Primeira linha"
Object.AddItem "Segunda linha"
Object.AddItem "Terceira linha"
End Sub
O script a seguir ilustra o acesso ao método AddItem realizado a partir de outro objeto.
Sub CommandButton1_Click()
Set obj = Screen.Item("hpComboBox1").Object
With obj
.Clear
.AddItem "Primeira linha"
.AddItem "Segunda linha"
.AddItem "Terceira linha"
End With
End Sub
Objetos 136
Para mais detalhes sobre como acessar propriedades, métodos ou eventos não estão disponíveis em instâncias deste
objeto, consulte o tópico Acesso a Propriedades, Métodos ou Eventos Não Disponíveis nas Instâncias.
A tabela a seguir contém as propriedades do objeto hpComboBox.
Propriedades do objeto hpComboBox
EnableTyping Habilita a edição deste objeto. Os valores possíveis são
True: Edição está habilitada ou False: Edição está
desabilitada




objeto recebe um evento de clique com o botão esquerdo
do mouse

esquerdo do mouse
137 Objetos
EventDropButtonClick Incrementa seu valor de 1 (um) a 9 (nove) quando o
objeto recebe um evento de clique na seta suspensa

os seguintes:
EventKeyDown Vetor que contém os parâmetros do evento KeyDown. Os

os seguintes:

parâmetro KeyAscii

os seguintes:
EventMouseDown Vetor que contém os parâmetros do evento MouseDown.

são os seguintes:
EventMouseMove Vetor que contém os parâmetros do evento MouseMove.

são os seguintes:
Objetos 138
EventMouseUp Vetor que contém os parâmetros do evento MouseUp. Os

os seguintes:
Index Retorna o número da linha selecionada ou -1 (menos um)

se nenhuma linha está selecionada. Alterar o valor desta
propriedade tem o seguinte efeito na propriedade Value:
· Se o valor de Index é menor que 0 (zero), a

propriedade Value recebe uma String vazia
· Se o valor de Index corresponde a um item existente na

lista de itens, a propriedade Value recebe este valor
· Se o valor de Index é maior do que o índice do último

item existente, a propriedade Value recebe a String
correspondente ao índice do último item existente
Object Referência ao objeto hpComboBox original
5.6.3 hpCommandButton
O objeto hpCommandButton (Botão de Comando) é usado para executar ações específicas quando pressionado.
Objeto
hpCommandButton
A tabela a seguir contém as propriedades do objeto hpCommandButton.
Propriedades do objeto hpCommandButton
EventClick
139 Objetos
StatusEnabled Disponibilidade do objeto. Os valores disponíveis são

True: Objeto está habilitado ou False: Objeto está
desabilitado
StatusInterlocked Estado de intertravamento. Os valores disponíveis são

True: Objeto está intertravado ou False: Objeto não está
intertravado
5.6.4 hpDateTimeCombo
O objeto hpDateTimeCombo é uma lista de seleção para datas e horas, que permite selecionar uma data e hora
através de um objeto hpDateTimePicker.
A tabela a seguir contém as propriedades do objeto hpDateTimeCombo.
Propriedades do objeto hpDateTimeCombo
AutoApply Atualiza automaticamente o valor de data e hora à
medida que este valor é ajustado no objeto
hpDateTimePicker
Format Configura o formato do valor mostrado no objeto

IconName Nome do ícone a ser exibido. Se esta propriedade está

oculto
ShowIcon Visibilidade do ícone. Os valores possíveis são True:

Visível ou False: Oculto
5.6.5 hpDateTimeDisplay1
O objeto hpDateTimeDisplay1 é um Display para datas e horas pré-formatadas.
Objetos 140
Objeto hpDateTimeDisplay1
A tabela a seguir contém as propriedades do objeto hpDateTimeDisplay1.
Propriedades do objeto hpDateTimeDisplay1
DateFormat Formatação de data
SwitchPos Alterna a disposição dos elementos. Os valores possíveis

são True: Hora à direita ou False: Hora à esquerda
TimeFormat Formatação de hora
5.6.6 hpDateTimeDisplay2
O objeto hpDateTimeDisplay2 é um Display para datas e horas pré-formatadas.
Objeto
hpDateTimeDisplay2
A tabela a seguir contém as propriedades do objeto hpDateTimeDisplay2.
Propriedades do objeto hpDateTimeDisplay2
DateFormat Formatação de data
SwitchPos Alterna a disposição dos elementos. Os valores possíveis

são True: Hora abaixo da data ou False: Hora acima da
data
TimeFormat Formatação de hora
5.6.7 hpDateTimePicker
O objeto hpDateTimePicker é um seletor de data e hora da Biblioteca HighPerformance Template, conforme a
figura a seguir.
141 Objetos
Objeto hpDateTimePicker
Seleção de um período
Para usá-lo, instancie em Tela o objeto hpDateTimeCombo, conforme a figura a seguir.
Objeto hpDateTimeCombo
Caso seja necessário usar uma configuração diferenciada, é possível usar o objeto hpTextBox alterando a
propriedade Behaviour para 1 (um).
A tabela a seguir contém as propriedades do objeto hpDateTimePicker.
Propriedades do objeto hpDateTimePicker
AutoApply Se esta propriedade está configurada para True, aplica
as alterações automaticamente. Se esta propriedade está
configurada para False, é necessário clicar em Aplicar
para validar as alterações
Objetos 142
DateShow String de data e hora para ser configurada
DateShowApply String de data e hora para ser configurada quando o

comando Aplicar é executado. Esta propriedade é usada
somente quando a propriedade AutoApply é igual a
False
ListMonths Lista com os nomes dos meses do ano, separados por

vírgula
ListWeekDays Lista com os nomes dos dias da semana, separados por

vírgula
MenuParameter Parâmetros para o método SelectMenu do Viewer. O

único valor possível é "Agora|Hoje|Este mês|Este
bimestre|Este trimestre|Este semestre|Este ano"
Time24h Formato de hora. Os valores possíveis são True: 24h ou

False: 12h am-pm
5.6.8 hpDividerHorizontal
Divisor horizontal usado para dividir áreas de uma Tela.
Objeto hpDividerHorizontal
5.6.9 hpDividerVertical
Divisor vertical usado para dividir áreas de uma Tela.
Objeto
hpDividerVertical
5.6.10 hpListBox
O objeto hpListBox exibe uma lista de itens dentre os quais o usuário pode selecionar um ou mais itens.
143 Objetos
Objeto hpListBox
O acesso a propriedades ou métodos do objeto hpListBox original que não estão disponíveis nas instâncias deste
objeto é realizado através da propriedade Object.
O script a seguir ilustra o caso em que o acesso ao método AddItem é realizado a partir do próprio objeto
hpListBox.
Sub hpListBox1_OnStartRunning()
Object.AddItem "Primeira linha"
Object.AddItem "Segunda linha"
Object.AddItem "Terceira linha"
End Sub
O script a seguir ilustra o acesso ao método AddItem realizado a partir de outro objeto.
Sub CommandButton1_Click()
Set obj = Screen.Item("hpListBox1").Object
With obj
.Clear
.AddItem "Primeira linha"
.AddItem "Segunda linha"
.AddItem "Terceira linha"
End With
End Sub
Para mais detalhes sobre como acessar propriedades, métodos ou eventos não disponíveis nas instâncias deste
A tabela a seguir contém as propriedades do objeto hpListBox.
Propriedades do objeto hpListBox

Objetos 144


esquerdo do mouse

esquerdo do mouse

os seguintes:

são os seguintes:

parâmetro KeyAscii

os seguintes:
145 Objetos



são os seguintes:
Object Referência ao objeto hpListBox original
Value Valor do texto selecionado
5.6.11 hpMarker
Marcador de uso genérico.
Objeto
hpMarker
Este objeto pode ser usado em diversas situações, como por exemplo:
· Marcar campos de formulários que necessitem de uma atenção especial
· Marcar dispositivos ou pontos de processo para indicar uma condição especial
· Marcar a chamada a caixas de texto com conteúdo explicativo
Objetos 146
5.6.12 hpOptionButton
O objeto hpOptionButton (Botão de Opção) indica se uma opção está selecionada ou não.
Objeto
hpOptionButton
Para mais detalhes sobre como acessar propriedades, métodos ou eventos não disponíveis nas instâncias deste
A tabela a seguir contém as propriedades do objeto hpOptionButton.
Propriedades do objeto hpOptionButton
Caption Texto descritivo



147 Objetos
esquerdo do mouse

esquerdo do mouse

os seguintes:

são os seguintes:

parâmetro KeyAscii

os seguintes:


Objetos 148

são os seguintes:
GroupName Nome do grupo de objetos
TripleState Habilita este objeto para configurar ou retornar 3 (três)

valores de estado
5.6.13 hpSliderHorizontal
O objeto hpSliderHorizontal é um controle deslizante na orientação horizontal.
Objeto hpSliderHorizontal
A tabela a seguir contém as propriedades do objeto hpSliderHorizontal.
Propriedades do objeto hpSliderHorizontal
Maximum Valor máximo
Minimum Valor mínimo
TimeoutChange Tempo limite considerado para definir se o valor

indicado na propriedade Value estabilizou ou não
ValueChange Indica se o valor da propriedade Value estabilizou

dentro do tempo limite definido na propriedade
TimeoutChange ou não. Se o valor estabilizou, já pode
ser lido com segurança
149 Objetos
5.6.14 hpTextBox
O objeto hpTextBox (Caixa de Texto) permite a criação de um texto a ser exibido em Tela.
Objeto hpTextBox
A tabela a seguir contém as propriedades do objeto hpTextBox.
Propriedades do objeto hpTextBox
possíveis são 0: Normal ou 1: DateTimePicker
DateTimeAutoApply Atualiza automaticamente o valor de data e hora quando

ajustado no objeto hpDateTimePicker. Esta propriedade
é usada somente quando a propriedade Behaviour é
igual a 1 (um)

esquerdo do mouse

esquerdo do mouse

são os seguintes:

os seguintes:

Objetos 150
são os seguintes:
EventValidate Vetor que contém os parâmetros do evento Validate. Os

os seguintes:
Elemento 1: Parâmetro NewValue
Format Formatação do texto
Multiline Habilita a quebra automática do texto durante a edição.

Os valores possíveis são True: Habilitada ou False:
Desabilitada
SetPointDataType Tipo de dados da variável Setpoint
TextAlignment Alinhamento horizontal
Value Texto a ser exibido
VertTextAlignment Alinhamento vertical
WrapText Habilita a quebra automática do texto durante a

visualização. Os valores possíveis são True: Habilitada ou
False: Desabilitada
5.6.15 hpThemePicker
O objeto hpThemePicker é usado para selecionar um Tema em tempo de execução, ou para alternar entre o modo
claro e escuro do Tema selecionado.
Propriedades do objeto hpThemePicker
EnablingMode Define a autorização para alterações de Tema. Os
valores possíveis para esta propriedade são 0: Desativa
todas as alterações, 1: Ativa apenas a mudança de modo,
2: Habilita apenas a alteração de Tema ou 3: Habilita a
mudança de Tema e de modo
Icon Define o ícone a ser mostrado quando o valor da

propriedade ToggleStatus é igual a True
IconGallery Nome do arquivo de biblioteca para ícones
151 Objetos
MenuDescription Texto a ser exibido na dica do menu
SelectedMode Modo selecionado. Os valores possíveis para esta

propriedade são 1: Modo claro ou -1: Modo escuro
SelectedTheme Nome do Tema selecionado
ShowThemeFactoryLink Define a visibilidade do link Theme Factory no menu de

seleção. Os valores possíveis para esta propriedade são
True: Mostra o link ou False: Oculta o link
5.6.16 hpToggleButton
O objeto hpToggleButton permite que, ao receber um clique do mouse, seu estado alterne entre dois valores pré-
configurados.
Objeto
hpToggleButton
A tabela a seguir contém as propriedades do objeto hpToggleButton.
Propriedades do objeto hpToggleButton
EventClick

LabelOff Texto a ser exibido quando o estado é igual a Off
LabelOn Texto a ser exibido quando o estado é igual a On
StatusEnabled Disponibilidade do objeto. Os valores disponíveis são

True: Objeto habilitado ou False: Objeto desabilitado
StatusInterlocked Estado de intertravamento. Os valores disponíveis são

True: Objeto está intertravado ou False: Objeto não está
intertravado
ToggleStatus Estado da variável. Os valores possíveis são True: On ou

False: Off
Objetos 152
5.7 Ícones
Esta seção contém informações sobre os objetos do tipo Ícone na Biblioteca HighPerformance Template.
5.7.1 hpArchitecture
A Biblioteca HighPerformance Template vem com duas bibliotecas de objetos para uso em arquiteturas,
hpArchitecture2D (contém elementos bidimensionais) e hpArchitecture3D (contém elementos tridimensionais).
Arquiteturas bidimensionais costumam ocupar uma área maior do que as arquiteturas tridimensionais, favorecendo a
visualização individual de cada elemento e detalhes do processo. São ideais para uso no caso de um pequeno
número de objetos (cerca de 10 elementos) ou onde uma visualização específica é mais importante do que a
visualização global, ou seja, os detalhes da representação do fluxo de dados entre cada objeto ou da particularidade
de cada elemento são mais importantes do que a representação do todo. A figura a seguir mostra um exemplo de
arquitetura bidimensional.
Arquitetura bidimensional
Arquiteturas tridimensionais possuem um melhor aproveitamento de espaço, ou seja, ocupam uma área menor do
que as arquiteturas bidimensionais com o mesmo número de elementos. São ideais para uso no caso de um grande
número de objetos ou onde uma visualização global ou de contexto é mais importante do que a visualização
específica, ou seja, a representação do todo ou a evidência das partes de um todo é mais importante do que a
representação das particularidades de cada elemento. A figura a seguir contém um exemplo de arquitetura
tridimensional.
153 Objetos
Arquitetura tridimensional
5.7.2 hpIcons
A biblioteca hpIcons contém ícones vetoriais prontos para serem usados na Biblioteca HighPerformance Template,
com suporte nativo a Temas. Os ícones desta biblioteca estão disponíveis na Galeria do Studio, conforme a figura a
seguir.
Biblioteca hpIcons
A tabela a seguir contém as propriedades dos objetos da biblioteca hpIcons.
Objetos 154
Propriedades dos objetos da biblioteca hpIcons
InvertColors Inverte a cor do ícone. Os valores possíveis são True:
Ícone com a cor mais escura que o fundo da Tela e
False: Ícone com a cor padrão, mais clara que o fundo
da Tela
5.8 Menus
Esta seção contém informações sobre os objetos do tipo Menu na Biblioteca HighPerformance Template.
NOTAS
· Os objetos do tipo Menu são totalmente integrados à Biblioteca HighPerformance Template, com suporte
nativo a Temas.
· Os objetos hpLinkDetail, hpLinkIcon e hpLinkMain também têm suporte nativo a seleção de idiomas, abertura
de Telas e janelas pop-up, tradução automática mediante configuração prévia e registro automático da Tela aberta
no histórico de navegação.
· O objeto hpTabsBar também tem suporte nativo a tradução automática mediante configuração prévia.
· Consulte o tópico Menu Lyra para mais informações sobre navegação entre Telas.
5.8.1 hpAccordion
O objeto hpAccordion é um menu no estilo sanfona que exibe um único item de cada vez, enquanto oculta os demais
itens. Este objeto é útil para menus com muito conteúdo e que necessitem de economia de espaço em tela.
Este objeto funciona como uma calculadora de coordenadas entre objetos do tipo Button, um botão, e do tipo
Content, o conteúdo. Cada objeto Button tem um objeto Content equivalente, e o objeto Button recebe o clique do
mouse para exibir todo o conteúdo disposto no respectivo objeto Content.
Os objetos Button e Content podem ser qualquer primitiva, grupo de primitivas ou XControl personalizado. Os
nomes devem ser declarados nas propriedades ButtonList e ContentList, respectivamente uma lista com os nomes
de objetos do tipo Button e uma lista com os nomes de objetos do tipo Content, separados por ponto e vírgula.
Para selecionar um conteúdo específico para ser exibido ao iniciar este objeto, adicione o marcador asterisco (*) na
frente do nome do objeto Button correspondente na propriedade ButtonList.
Todos os objetos do tipo Button e Content devem ter a mesma largura, ou seja, a mesma propriedade Width, mas
podem ter alturas diferentes, ou seja, diferentes propriedades Height.
Os objetos do tipo Button, Content e hpAccordion devem estar dispostos no mesmo nível hierárquico na Tela, ou
seja, todos devem estar instanciados diretamente na Tela ou dentro de um mesmo grupo, desde que estejam no
mesmo nível.
Sempre que um usuário alterar qualquer um dos parâmetros deste objeto no Studio, deve executar novamente o
evento CustomConfig para que o posicionamento dos objetos seja recalculado com os novos valores.
Funcionalidade de Objetos do Tipo Button
Sempre que um usuário clicar em um objeto do tipo Button, deve informar ao objeto hpAccordion a mudança de
seleção. Isto é realizado usando a propriedade ClickedButton. A recomendação é que cada objeto do tipo Button
execute um script ao receber o clique do mouse, escrevendo o nome do objeto na propriedade ClickedButton,
conforme o script a seguir.
Parent.Item("hpAccordion1").ClickedButton = Name
155 Objetos
Visualização de Objetos do Tipo Content
Recomenda-se que os objetos do tipo Content tenham fundo transparente e que a altura seja a altura exata do
conteúdo. Desta forma, pode-se configurar um único fundo no objeto hpAccordion, comum a todos os conteúdos,
usando as propriedades BackgroundVisible, BackgroundColorStyle e BackgroundColor.
A tabela a seguir contém as propriedades do objeto hpAccordion.
Propriedades do objeto hpAccordion
BackgroundColor Define a cor de fundo deste objeto. Esta propriedade é
válida somente quando o valor da propriedade
BackgroundColorStyle é igual a 0 (zero)
BackgroundColorStyle Define o estilo da cor de fundo deste objeto. Os valores

possíveis são 0: Cor personalizada ou 1: Cor de fundo da
Tela
BackgroundVisible Retorna ou define a visibilidade de fundo deste objeto
ButtonList Lista de nomes de objetos do tipo Button, separados

ClickedButton Define o nome do objeto do tipo Button selecionado
ContentList Lista de nomes de objetos do tipo Content, separados

Gutter Espaço entre dois objetos do tipo Button, em unidades

Himetric
Index Retorna o índice do objeto do tipo Content selecionado.

O primeiro elemento começa em 0 (zero)
MaxHeight Define o valor da altura do objeto hpAccordion que

acomoda todos os objetos declarados, em unidades
Himetric. Esta propriedade é válida somente quando o
valor da propriedade MaxHeightSettingMode é igual a
1 (um)
MaxHeightSettingMode Define como a altura deste objeto é definida. Os valores

possíveis são 0: Calculada automaticamente ou 1:
Definida manualmente na propriedade MaxHeight
5.8.2 hpLinkDetail
O objeto hpLinkDetail é um item de menu que exibe tanto um descritivo textual quanto uma representação gráfica
através de um ícone.
Objeto hpLinkDetail
Este objeto pode assumir os seguintes comportamentos:
· Seletor de temas: Instancie este objeto em Tela e altere o valor de sua propriedade Behaviour para 1 (um)
Objetos 156
· Seletor de idiomas: Instancie este objeto em Tela e altere o valor de sua propriedade Behaviour para 2 (dois)
· Link para abertura de Tela: Instancie este objeto em Tela e altere o valor de sua propriedade Behaviour para 3
(três). Em seguida configure os demais parâmetros para a abertura da Tela, como detalhado no tópico
Navegação
· Link para abertura de janelas pop-up: Instancie o objeto em Tela e altere o valor de sua propriedade Behaviour
para 4 (quatro). Em seguida configure os demais parâmetros para a abertura de janelas pop-up, como detalhado
no tópico Abrindo Telas Pop-ups e Modais
A tabela a seguir contém as propriedades do objeto hpLinkDetail.
Propriedades do objeto hpLinkDetail
AutoScale Ajuste automático do ícone

são 0: Definido pelo usuário, 1: Seletor de temas, 2:
Seletor de idiomas, 3: Abre Tela ou 4: Abre janela pop-up
DisableSelection Disponibilidade de seleção para o objeto. Os valores

possíveis são True: Seleção habilitada ou False: Seleção
desabilitada


esquerdo do mouse
GroupElementID Número que define a posição do objeto dentro de um


um menu



oculto
157 Objetos
MenuDescription Texto descritivo

quando a propriedade Behaviour é igual a 3 (três)

(quatro)

quando a propriedade Behaviour é igual a 4 (quatro)
popTemplate Associação para o objeto hpPopupTemplate que

contém as configurações para a abertura da janela. Esta
Behaviour é igual a 4 (quatro)

RefreshIcon Atualiza a exibição do ícone sempre e quando variar seu

valor

(três). Esta propriedade foi descontinuada e vai ser
uma versão futura





Objetos 158


quando a propriedade Behaviour é igual a 3 (três). Esta
futura







Behaviour é igual a 3 (três). Esta propriedade foi


a 1 (um)
159 Objetos

"hpFrameHeader". Esta propriedade deve ser
configurada nos casos em que um novo Template de
Quadros é carregado, ou mais de uma Tela deve ser
aberta simultaneamente no Template de Quadros
corrente. Esta propriedade é usada somente quando a
propriedade Behaviour é igual a 3 (três)
Selected Estado da seleção do objeto. Os valores possíveis são

True: Objeto selecionado ou False: Objeto não
selecionado
5.8.3 hpLinkIcon
O objeto hpLinkIcon é um item de menu que exibe uma representação gráfica através de um ícone.
Objeto
hpLinkIcon
Navegação
A tabela a seguir contém as propriedades do objeto hpLinkIcon.
Propriedades do objeto hpLinkIcon


desabilitada
Objetos 160

esquerdo do mouse


um menu



oculto



(quatro)



161 Objetos
valor

uma versão futura








futura



Objetos 162





a 1 (um)



selecionado
5.8.4 hpLinkMain
O objeto hpLinkMain é um item de menu que exibe tanto um descritivo textual como uma representação gráfica
através de um ícone.
163 Objetos
Objeto
hpLinkMain
Navegação
A tabela a seguir contém as propriedades do objeto hpLinkMain.
Propriedades do objeto hpLinkMain


desabilitada


esquerdo do mouse


um menu
Objetos 164


oculto



(quatro)




valor

uma versão futura


165 Objetos





futura







Objetos 166

a 1 (um)



selecionado
5.8.5 hpLinkToggleIcon
O objeto hpLinkToggleIcon é um item de menu que exibe dois estados possíveis, cada um com seu respectivo ícone.
Objeto
hpLinkToggleIcon
A tabela a seguir contém as propriedades do objeto hpLinkToggleIcon.
Propriedades do objeto hpLinkToggleIcon

esquerdo do mouse

167 Objetos
IconOff Nome do ícone a ser exibido quando o valor da
propriedade ToggleStatus é igual a False
IconOn Nome do ícone a ser exibido quando o valor da

propriedade ToggleStatus é igual a True

valor
ToggleStatus Valor corrente da variável. Os valores possíveis são True:

On ou False: Off
5.8.6 hpTabBarHorizontal
O objeto hpTabBarHorizontal foi descontinuado. Este objeto não recebe mais atualizações e vai ser removido da
Biblioteca HighPerformance Template em uma versão futura. Recomenda-se o uso do objeto hpTabsBar no lugar
deste objeto.
5.8.7 hpTabBarVertical
O objeto hpTabBarVertical foi descontinuado. Este objeto não recebe mais atualizações e vai ser removido da
Biblioteca HighPerformance Template em uma versão futura. Recomenda-se o uso do objeto hpTabsBar no lugar
deste objeto.
5.8.8 hpTabsBar
O objeto hpTabsBar é um item de menu organizado em forma de abas dispostas horizontalmente ou verticalmente,
que oferece uma forma visualmente limpa e organizada de navegação entre itens de uma mesma página ou até
mesmo entre páginas distintas.
Aba disposta
horizontalmente
Aba
disposta
verticalmente
Com este objeto pode-se:
· Criar inúmeras abas configurando uma única propriedade
· Controlar a largura das abas por associação
· Controlar o status de disponibilidade das abas por associação
· Calcular automaticamente a largura das abas, inclusive na troca de idioma
· Configurar a orientação horizontal ou vertical
· Aparar automaticamente espaços excedentes nos rótulos das abas
Objetos 168
Este objeto pode ser rapidamente configurado, conforme os procedimentos a seguir.
1. Instancie este objeto em Tela.
2. Defina a orientação do objeto configurando a propriedade Orientation com o valor 0 (zero) para Horizontal ou 1
(um) para Vertical.
3. Configure a propriedade LabelList com os textos descritivos das abas, separados por ponto e vírgula.
4. Em seguida, configure a propriedade WidthList com os valores em Himetric da largura das abas, separados por
ponto e vírgula, ou deixe esta propriedade vazia para que os valores sejam calculados automaticamente.
Opcionalmente no Studio, clique com o botão direito do mouse no objeto e selecione a opção Configurar para
visualizar previamente a aparência deste objeto em tempo de execução.
Exemplo de configuração para 3 (três) abas com orientação horizontal, largura definida pelo usuário e iniciando com
a aba 2 (dois) selecionada:
· LabelList: Aba1;Aba2;Aba3
· WidthList: 2000;3000;2500 (larguras das abas um, dois e três respectivamente)
· EnabledList: 1;1;0 (abas um e dois habilitadas e aba três desabilitada)
· Orientation: 0 (zero)
· Index: 2 (dois, aba dois inicia selecionada)
A mesma configuração, porém com larguras calculadas automaticamente e todas as abas habilitadas:
· LabelList: Aba1;Aba2;Aba3
· WidthList: "" (larguras calculadas automaticamente)
· EnabledList: 1 (um, todas as abas habilitadas)
· Orientation: 0 (zero)
· Index: 2 (dois, aba dois inicia selecionada)
Funcionalidade de Objetos Personalizados
Ao informar uma classe personalizada nas propriedades HorizontalClassName ou VerticalClassName, o objeto

pertencente a esta classe deve cumprir com os seguintes critérios:
· Ter na lista de propriedades as mesmas propriedades existentes nos objetos nativos da Biblioteca
HighPerformance Template, ~hpTabH ou ~hpTabV.
· Ao receber um clique de mouse, deve escrever o valor da propriedade Id na propriedade Index do objeto
hpTabsBar.
Exemplo de script a ser executado no evento de clique do mouse:

Set tab = Parent
Set bar = tab.Parent.Parent
tab.SetFocus()
bar.Index = tab.Id
169 Objetos
Em que tab refere-se ao objeto personalizado e bar refere-se ao objeto hpTabsBar.
NOTAS
· Caso a propriedade Orientation seja igual a 1 (um), o menu é construído verticalmente. Neste caso, o cálculo das
larguras de abas se restringe à largura de maior valor. Se o usuário definir mais de um valor de largura na
propriedade WidthList, somente o primeiro valor é considerado.
· Caso o número de abas definidas na propriedade LabelList seja maior que os valores definidos nas propriedades
WidthList e EnabledList, estas propriedades têm os valores automaticamente completados com os valores
padrão definidos nas propriedades DefaultSize e DefaultStatus, respectivamente.
A tabela a seguir contém as propriedades do objeto hpTabsBar.
Propriedades do objeto hpTabsBar
AutoTrim Apara automaticamente os rótulos das guias. Os valores
possíveis são Verdadeiro: Ativa ou Falso: Desativa
DefaultSize Tamanho padrão da aba, em unidades Himetric
DefaultSLI Define o idioma padrão para links de tradução
DefaultStatus Status de disponibilidade padrão da aba. Os valores

possíveis são Verdadeiro: Aba ativada ou Falso: Aba
desativada
EnabledList Lista de valores para status de disponibilidade das abas.

Os valores possíveis são 0: Aba desabilitada, 1: Aba
habilitada, Um único zero: Todas as abas desabilitadas,
Um único um: Todas as abas habilitadas ou Uma String
vazia: Todas as guias usam o valor padrão. Em uma lista
de valores, estes devem ser separados por ponto e
vírgula
Gutter Espaço, em unidades Himetric, entre as abas
HorizontalClassName Nome da classe do objeto item de menu usado na

orientação horizontal, tal como usado no método
AddObject
Index Número de identificação da aba selecionada. Os valores

possíveis são -1: Nenhuma aba selecionada, 0: Primeira
aba, 1: Segunda aba e assim por diante. Esta
propriedade permite leitura e escrita
LabelList Lista de valores para rótulos de abas. Os valores devem

ser separados por ponto e vírgula
Orientation Define a orientação do menu. Os valores possíveis são 0:

Horizontal ou 1: Vertical
Objetos 170
SelectionStyle Define o estilo de exibição das abas selecionadas. Os
valores possíveis são 0: Preenchimento de fundo, 1: Barra
de destaque ou 2: Barra de destaque com preenchimento
de fundo
VerticalClassName Nome da classe do objeto item de menu usado na

orientação vertical, tal como usado no método
AddObject
WidthList Lista de valores para larguras de abas, em unidades

Himetric. Os valores devem ser separados por ponto e
vírgula. Uma String vazia habilita o cálculo automático da
largura para todas as abas
5.9 Telas, Quadros e Monitores

Esta seção contém informações sobre os objetos do tipo Tela, Quadro e Monitor na Biblioteca HighPerformance
Template.
5.9.1 hpMultiMonitorConfig
O objeto hpMultiMonitorConfig permite configurar um vetor de monitores usado por uma aplicação na estação
definida por este objeto. Assim, para cada estação que utilize um Viewer deve haver uma instância deste objeto no
servidor de Domínio definindo a disposição dos respectivos monitores.
Por exemplo, para configurar um vetor de 6 (seis) monitores com resolução Full HD (1920 × 1080 pixels) dispostos
em duas linhas e três colunas na estação Op01, as propriedades do objeto hpMultiMonitorConfig devem ser
configuradas da seguinte forma:
· MonitorArray: 2x3
· SelectionID: Op01
· ViewerWidth: 5760
· ViewerHeight: 2160
Neste caso, a propriedade ViewerWidth é o produto das resoluções horizontais dos monitores (3 × 1920 = 5760
pixels) e a propriedade ViewerHeight é o produto das resoluções verticais dos monitores (2 × 1080 = 2160 pixels).
A tabela a seguir contém as propriedades do objeto hpMultiMonitorConfig.
Propriedades do objeto hpMultiMonitorConfig
MonitorArray Configuração do vetor de monitores usado pela
aplicação, no formato "LinhaxColuna". Exemplos de
configuração são 1x1: 1 (um) monitor simples, 1x2: 2
(dois) monitores dispostos horizontalmente e 2x3: 6
(seis) monitores dispostos em duas linhas por três
colunas. Suporta um total de 9 (nove) monitores
171 Objetos
SelectionID Nome local do computador onde o vetor de monitores é
aplicado. Para tornar esta configuração aplicável a
qualquer computador que não esteja previamente
configurado, deixe o valor desta propriedade em branco
ViewerHeight Altura, em pixels, do Viewer
ViewerWidth Largura, em pixels, do Viewer
5.10 Temas
Esta seção contém informações sobre os objetos do tipo Tema na Biblioteca HighPerformance Template.
5.10.1 ~hpColor
O objeto ~hpColor é um objeto interno da função Temas, usado para definir uma cor específica, e pode funcionar
também como um conversor entre formatos de cor. Para isto, execute os passos a seguir:
1. Selecione uma instância deste objeto no Studio.
2. Certifique-se de que as propriedades cDouble, cHex e cRGB contêm, respectivamente, os valores padrão "0",
"000000" e "0,0,0".
3. Configure a propriedade correspondente com o valor a ser convertido.
4. Clique com o botão direito do mouse no objeto e selecione a opção Configurar. O objeto preenche as demais
propriedades com os valores correspondentes.
A tabela a seguir contém as propriedades do objeto ~hpColor.
Propriedades do objeto ~hpColor
cDouble Código da cor no formato Double
cHex Código da cor no formato Hexadecimal
cRGB Código da cor no formato RGB
5.10.2 ~hpColorPalette
O objeto ~hpColorPalette é um objeto interno da função Temas, usado para definir uma paleta de cores. Para mais
detalhes, consulte o tópico Paletas de Cores.
A tabela a seguir contém as propriedades do objeto ~hpColorPalette.
Propriedades do objeto ~hpColorPalette
FriendlyName Define um nome amigável para a paleta de cores
configurada neste objeto
Objetos 172
PaletteType Define o tipo de paleta de cores. Isto afeta a
nomenclatura das cores quando geradas
automaticamente. Os valores possíveis para esta
propriedade são 0: System Monochrome, 1: System
Polychrome ou 2: Custom
5.10.3 hpTheme
O objeto hpTheme é usado para abrigar todos os elementos que compõem um Tema na Biblioteca
HighPerformance Template. Para criar a estrutura interna de um Tema, execute os passos a seguir:
1. Instancie um objeto hpTheme na pasta hpObjects - Themes.
2. Renomeie este objeto para o nome do Tema.
3. Clique com o botão direito do mouse no objeto e selecione a opção Configurar. Aguarde a construção da
estrutura interna do objeto.
Após concluir a criação da estrutura interna, publique no Viewer esta alteração. Para isto, clique com o botão direito
do mouse no objeto ~hpThemePublisher na pasta hpObjects - Themes e selecione a opção Configurar. Ao término
da publicação, execute o Viewer para visualizar as alterações.
5.10.4 ~hpThemePublisher
O objeto ~hpThemePublisher é um objeto interno da função Temas, usado para publicar no objeto Viewer as
configurações realizadas no objeto hpTheme. Para mais detalhes, consulte o tópico Publicando Alterações.
A tabela a seguir contém as propriedades do objeto ~hpThemePublisher.
Propriedades do objeto ~hpThemePublisher
StartupThemeName Nome do Tema iniciado com o Viewer
StartupThemeMode Modo do Tema a ser iniciado com o Viewer. As opções

disponíveis são 0: Light (Claro) ou 1: Dark (Escuro)
NOTA
Toda alteração realizada nos valores das propriedades StartupThemeName e StartupThemeMode deve ser
publicada no Viewer, conforme descrito no tópico Publicando Alterações.
5.10.5 hpTheme01
O objeto hpTheme01 contém todas as configurações que caracterizam um Tema. As configurações de um Tema
podem abranger não apenas diferentes esquemas de cores mas também outras características visuais, tais como o
tipo e a espessura de bordas e presença ou ausência de um determinado efeito, entre outras.
173 Objetos
NOTA
Ao realizar qualquer alteração em um esquema de cor do objeto hpTheme01, deve-se executar o método
CustomConfig deste objeto, clicando com o botão direito na instância e selecionando a opção Configurar para
atualizar as Associações dos Tags deste método no Viewer.
A tabela a seguir contém as propriedades do objeto hpTheme01.
Propriedades do objeto hpTheme01
BlinkE3AlarmACKSeverity0Text Cor de pisca para alarmes reconhecidos e de severidade
alta

média

baixa
BlinkE3AlarmACKSeverityCText Cor de pisca para alarmes reconhecidos e de severidade

crítica
BlinkE3AlarmActiveSeverity0Text Cor do pisca para alarmes ativos e de severidade alta
BlinkE3AlarmActiveSeverity1Text Cor de pisca para alarmes ativos e de severidade média
BlinkE3AlarmActiveSeverity2Text Cor de pisca para alarmes ativos e de severidade baixa
BlinkE3AlarmActiveSeverityCText Cor de pisca para alarmes ativos e de severidade crítica
BlinkE3AlarmEventSeverity0Text Cor de pisca para eventos de severidade alta
BlinkE3AlarmEventSeverity1Text Cor de pisca para eventos de severidade média
BlinkE3AlarmEventSeverity2Text Cor de pisca para eventos de severidade baixa
BlinkE3AlarmEventSeverityCText Cor de pisca para eventos de severidade crítica
BlinkE3AlarmNACKSeverity0Text Cor de pisca para alarmes não reconhecidos e de

severidade alta

severidade média

severidade baixa
BlinkE3AlarmNACKSeverityCText Cor de pisca para alarmes não reconhecidos e de

severidade crítica
ColorAlm1Background Cor de fundo para alarmes de severidade alta
ColorAlm2Background Cor de fundo para alarmes de severidade média
ColorAlm3Background Cor de fundo para alarmes de severidade baixa
Objetos 174
ColorAlm4Background Reservada para uso futuro
ColorAlmBorder Cor de borda para alarmes
ColorAlmCBackground Cor de fundo para alarmes de severidade crítica
ColorAlmText Cor de texto para alarmes
ColorArcHighlight Cor de destaque para objetos de arquitetura
ColorArcLight Cor de tons claros para objetos de arquitetura
ColorArcLine Cor do traço para objetos de arquitetura
ColorArcMidtone Cor de meio tom para objetos de arquitetura
ColorArcShadow Cor de tons escuros para objetos de arquitetura
ColorChartAxis Cor para o eixo de gráficos
ColorChartAxisClear Cor de tons claros para o eixo de gráficos
ColorChartGrid Cor para o grid de gráficos
ColorChartNode Cor para nós de gráficos
ColorChartPen Cor para penas de gráficos
ColorChartRadarFill Cor para preenchimento de gráficos do tipo Radar
ColorChartTargetLine Cor para a linha alvo de gráficos
ColorDeviceBorder Cor para a borda de dispositivos
ColorDisplayUnit Cor para o texto da unidade de engenharia
ColorDisplayValue Cor para o valor do Display
ColorDivider Cor para o divisor
ColorE3AlarmACKSeverity0Background Cor de fundo para alarmes reconhecidos e de

severidade alta
ColorE3AlarmACKSeverity0Text Cor de texto para alarmes reconhecidos e de severidade

alta

severidade média

média

severidade baixa

baixa
175 Objetos
ColorE3AlarmACKSeverityCBackground Cor de fundo para alarmes reconhecidos e de
severidade crítica
ColorE3AlarmACKSeverityCText Cor de texto para alarmes reconhecidos e de severidade

crítica
ColorE3AlarmActiveSeverity0Background Cor de fundo para alarmes ativos e de severidade alta
ColorE3AlarmActiveSeverity0Text Cor de texto para alarmes ativos e de severidade alta
ColorE3AlarmActiveSeverity1Background Cor de fundo para alarmes ativos e de severidade média
ColorE3AlarmActiveSeverity1Text Cor de texto para alarmes ativos e de severidade média
ColorE3AlarmActiveSeverity2Background Cor de fundo para alarmes ativos e de severidade baixa
ColorE3AlarmActiveSeverity2Text Cor de texto para alarmes ativos e de severidade baixa
ColorE3AlarmActiveSeverityCBackground Cor de fundo para alarmes ativos e de severidade crítica
ColorE3AlarmActiveSeverityCText Cor de texto para alarmes ativos e de severidade crítica
ColorE3AlarmEventSeverity0Background Cor de fundo para eventos de severidade alta
ColorE3AlarmEventSeverity0Text Cor de texto para eventos de severidade alta
ColorE3AlarmEventSeverity1Background Cor de fundo para eventos de severidade média
ColorE3AlarmEventSeverity1Text Cor de texto para eventos de severidade média
ColorE3AlarmEventSeverity2Background Cor de fundo para eventos de severidade baixa
ColorE3AlarmEventSeverity2Text Cor de texto para eventos de severidade baixa
ColorE3AlarmEventSeverityCBackground Cor de fundo para eventos de severidade crítica
ColorE3AlarmEventSeverityCText Cor de texto para eventos de severidade crítica
ColorE3AlarmNACKSeverity0Background Cor de fundo para alarmes não reconhecidos e de

severidade alta
ColorE3AlarmNACKSeverity0Text Cor do texto para alarmes não reconhecidos e de

severidade alta

severidade média

severidade média

severidade baixa

severidade baixa
ColorE3AlarmNACKSeverityCBackground Cor de fundo para alarmes não reconhecidos e de

severidade crítica
Objetos 176
ColorE3AlarmNACKSeverityCText Cor do texto para alarmes não reconhecidos e de
severidade crítica
ColorFaceplateBackground Cor de fundo para a Tela Faceplate
ColorFormBackground Cor de fundo para formulários
ColorFormCmdBackground Cor de fundo para objetos de comando em formulários
ColorFormCmdBtBackground Cor de fundo para botões de comando em formulários
ColorFormCmdBtBorder Cor de borda para botões de comando em formulários
ColorFormText Cor de texto em formulários
ColorFormTextDisabled Cor de texto desabilitado em formulários
ColorFormTextOff Cor de texto para o estado Desligado em formulários
ColorFormTextOn Cor de texto para o estado Ligado em formulários
ColorGraphAlmLimit1 Cor para indicadores de alarme para limite 1 (um)
ColorGraphAlmLimit2 Cor para indicadores de alarme para limite 2 (dois)
ColorGraphAlmSeverity1 Cor para indicadores de alarme de severidade alta
ColorGraphAlmSeverity2 Cor para indicadores de alarme de severidade média
ColorGraphAlmSeverity3 Cor para indicadores de alarme de severidade baixa
ColorGraphAlmSeverityC Cor para indicadores de alarme de severidade crítica
ColorGraphOpIdeal Cor para indicação de operação ideal em gráficos
ColorGraphOpNormal Cor para indicação de operação normal em gráficos
ColorGraphRangeBackground Cor de fundo para indicação de faixa de operação em

gráficos
ColorGraphSPIndicator Cor para indicadores de Setpoint em gráficos
ColorGraphTrack Cor para trilha em gráficos
ColorGraphValueIndicator Cor para indicadores de valor em gráficos
ColorIcon Cor para o estado normal de ícones
ColorIconDisabled Cor para o estado desabilitado de ícones
ColorIconInverted Cor invertida para o estado normal de ícones
ColorIndText Cor de texto indicativo
ColorMenuBackground Cor de fundo para menus
ColorMenuBackgroundHover Cor de fundo para menus com efeito MouseOver
177 Objetos
ColorMenuBackgroundSelected Cor de fundo para menus selecionados
ColorMenuBackgroundSelectedHover Cor de fundo para menus selecionados com efeito

MouseOver
ColorMenuText Cor de fundo para textos em menus
ColorProcessLine Cor padrão para linhas de processos
ColorProcessLineAux1 Cor auxiliar para linhas de processos
ColorRadarChartPen1 Cor para a pena 1 (um) de gráficos do tipo Radar
ColorRadarChartPen2 Cor para a pena 2 (dois) de gráficos do tipo Radar
ColorRadarChartPen3 Cor para a pena 3 (três) de gráficos do tipo Radar
ColorRadarChartRangeBackground Cor de fundo para faixas de valores de gráficos do tipo

Radar
ColorScreenBackground Cor de fundo de Telas
ColorStatusInvalid Cor do estado Inválido
ColorStatusOff Cor do estado Desligado
ColorStatusOn Cor do estado Ligado
ColorTextDisabled Cor de texto desabilitado
ColorTextLabel1 Cor para categorias de texto Label1
ColorTextLabel3Highlight Cor para categorias de texto Label3 destacado
ColorTextLabel4Highlight Cor para categorias de texto Label4 destacado
Objetos 178
ColorTVArrowCollapsed Cor para setas retraídas em TreeViews
ColorTVArrowExpanded Cor para setas expandidas em TreeViews
ColorTVHover Cor para itens em TreeViews com efeito MouseOver
ColorTVItemBack Cor de fundo para itens em TreeViews
ColorTVSelectedBorder Cor de borda para itens selecionados em TreeViews
ColorTVSelectedFill Cor de fundo para itens selecionados em TreeViews
ColorTVText Cor de texto para itens em TreeViews
CustomColor01 Cor definida pelo usuário
ExtraChartPen1 Cor extra para penas em gráficos
179 Objetos
TemplateID Número que identifica o esquema de cores
5.11 Textos
Utilize somente as classes de texto fornecidas com a Biblioteca HighPerformance Template a fim de criar uma
hierarquia visual consistente em uma aplicação.
A Biblioteca hpTexts possui os objetos a seguir, que definem níveis fixos de categorias de texto:
· hpLabel0
· hpLabel1
· hpLabel2
· hpLabel3
· hpLabel3Highlight
· hpLabel4
· hpLabel4Highlight
· hpLabel5
· hpLabel6
No entanto, uma vez instanciados, estes objetos não podem ter seu tamanho ou categoria alterado. Somente um
objeto permite alterar a categoria dinamicamente, o objeto hpLabelGeneric.
Alterando-se sua propriedade Level é possível mudar o nível hierárquico do texto. Recomenda-se o uso deste objeto
ao invés dos demais por permitir maior flexibilidade no caso de ser realizada alguma alteração na aplicação.
A combinação ordenada de objetos de texto com diferentes níveis hierárquicos define a hierarquia visual da aplicação.
A seguir são sugeridas duas configurações de uso das classes de texto, dependendo de fatores como resolução,
tamanho dos monitores e sua distância do usuário. Os exemplos à esquerda ilustram a função das categorias de
texto, e à direita os níveis que devem ser configurados no objeto hpLabelGeneric.
Objetos 180
Configuração 1
Configuração 2
Para mais detalhes, consulte os tópicos a seguir para uma descrição de cada um dos objetos.
NOTA
Os objetos do tipo Texto são totalmente integrados à Biblioteca HighPerformance Template, com suporte nativo a
Temas e ao recurso de tradução automática mediante configuração prévia.
5.11.1 hpLabel0
Classe de texto de nível hierárquico mais alto, indicada para uso como título de aplicação. Uma vez instanciado este
objeto, não é mais possível alterar seu nível hierárquico. Caso isto seja necessário, recomenda-se o uso do objeto
hpLabelGeneric. Recomenda-se seu uso sempre em caixa baixa (minúsculas) com a primeira letra em caixa alta
(maiúscula) para melhor legibilidade.
A tabela a seguir contém as propriedades do objeto hpLabel0.
Propriedades do objeto hpLabel0
possíveis são 0: Comportamento padrão ou 1: Título de
Tela
181 Objetos
FrameSetToGetTitle Define o nome do Quadro (FrameSet) a partir do qual o
título da Tela é definido. Uma String em branco define o
título a partir da Tela aberta no Quadro hpFSMain
TextAlignment Alinhamento do texto. Os valores possíveis são 0: Texto

alinhado à esquerda, 1: Texto centralizado ou 2: Texto
alinhado à direita
TextDisabled Disponibilidade do objeto. Os valores possíveis são

True: Objeto desabilitado ou False: Objeto habilitado
TextFormat Formatação do texto
5.11.2 hpLabel1
Classe de texto de nível hierárquico imediatamente inferior ao nível 0 (zero), indicada para uso como título de
aplicação ou título de Tela. Uma vez instanciado este objeto, não é mais possível alterar seu nível hierárquico. Caso
isto seja necessário, recomenda-se o uso do objeto hpLabelGeneric. Recomenda-se seu uso sempre em caixa baixa
(minúsculas) com a primeira letra em caixa alta (maiúscula) para melhor legibilidade.
Tela


alinhado à direita

5.11.3 hpLabel2
Classe de texto de nível hierárquico imediatamente inferior ao nível 1 (um), indicada para uso como título de aplicação
ou título de Tela. Uma vez instanciado este objeto, não é mais possível alterar seu nível hierárquico. Caso isto seja
necessário, recomenda-se o uso do objeto hpLabelGeneric. Recomenda-se seu uso sempre em caixa baixa
Objetos 182
Tela


alinhado à direita

5.11.4 hpLabel3
Classe de texto de nível hierárquico imediatamente inferior ao nível 2 (dois), indicada para uso como título de Tela ou
de um grupo de objetos. Uma vez instanciado este objeto, não é mais possível alterar seu nível hierárquico. Caso isto
seja necessário, recomenda-se o uso do objeto hpLabelGeneric. Recomenda-se seu uso sempre em caixa baixa

alinhado à direita

183 Objetos
5.11.5 hpLabel3Highlight
Classe de texto de nível hierárquico imediatamente inferior ao nível 2 (dois) com efeito de destaque, indicada para uso
como título de Tela ou de um grupo de objetos. Uma vez instanciado este objeto, não é mais possível alterar seu nível
hierárquico. Caso isto seja necessário, recomenda-se o uso do objeto hpLabelGeneric. Recomenda-se seu uso
sempre em caixa baixa (minúsculas) com a primeira letra em caixa alta (maiúscula) para melhor legibilidade.
A tabela a seguir contém as propriedades do objeto hpLabel3Highlight.
Propriedades do objeto hpLabelHighlight

alinhado à direita

5.11.6 hpLabel4
Classe de texto de nível hierárquico imediatamente inferior ao nível 3 (três), indicada para uso como texto normal ou
descritivo de uma variável. Uma vez instanciado este objeto, não é mais possível alterar seu nível hierárquico. Caso
isto seja necessário, recomenda-se o uso do objeto hpLabelGeneric. Recomenda-se seu uso sempre em caixa baixa

alinhado à direita

5.11.7 hpLabel4Highlight
Classe de texto de nível hierárquico imediatamente inferior ao nível 3 (três), com efeito de destaque, indicada para uso
como texto normal ou descritivo de uma variável. Uma vez instanciado este objeto, não é mais possível alterar seu
Objetos 184
nível hierárquico. Caso isto seja necessário, recomenda-se o uso do objeto hpLabelGeneric. Recomenda-se seu uso
sempre em caixa baixa (minúsculas) com a primeira letra em caixa alta (maiúscula) para melhor legibilidade.
A tabela a seguir contém as propriedades do objeto hpLabel4Highlight.
Propriedades do objeto hpLabelHighlight

alinhado à direita

5.11.8 hpLabel5
Classe de texto de nível hierárquico imediatamente inferior ao nível 4 (quatro), indicada para uso como texto de
legenda para imagens ou gráficos. Uma vez instanciado este objeto, não é mais possível alterar seu nível hierárquico.
Caso isto seja necessário, recomenda-se o uso do objeto hpLabelGeneric. Recomenda-se seu uso sempre em caixa
baixa (minúsculas) com a primeira letra em caixa alta (maiúscula) para melhor legibilidade.

alinhado à direita

5.11.9 hpLabel6
Classe de texto de nível hierárquico imediatamente inferior ao nível 5 (cinco), indicada para uso como texto normal e
descritivo de uma variável ou como legenda para imagens ou gráficos em espaços extremamente reduzidos. Uma vez
instanciado este objeto, não é mais possível alterar seu nível hierárquico. Caso isto seja necessário, recomenda-se o
uso do objeto hpLabelGeneric. Recomenda-se seu uso sempre em caixa alta (maiúscula) para melhor legibilidade.
185 Objetos

alinhado à direita

5.11.10 hpLabelGeneric
Objeto genérico para classe de texto de nível hierárquico. Recomenda-se sua utilização sempre que houver a
possibilidade de alteração do nível hierárquico de textos já implementados na aplicação. Para isto, altere uma única
propriedade deste objeto para que assuma a aparência do novo nível configurado. Para se obter uma melhor
legibilidade, nos níveis de 0 (zero) a 5 (cinco) recomenda-se seu uso sempre em caixa baixa (minúsculas) com a
primeira letra em caixa alta (maiúscula). Já para o nível 6 (seis), recomenda-se seu uso sempre em caixa alta
(maiúsculas).
A tabela a seguir contém as propriedades do objeto hpLabelGeneric.
Propriedades do objeto hpLabelGeneric
Tela. Esta propriedade é usada somente quando a
propriedade Level é igual a 0 (zero), 1 (um) ou 2 (dois)
Highlight Efeito de destaque. Os valores possíveis são True:

Destaque habilitado ou False: Destaque desabilitado
Level Nível hierárquico baseado nas classes de texto

disponíveis. Os valores possíveis são 0: hpLabel0, 1:
hpLabel1, 2: hpLabel2, 3: hpLabel3, 4: hpLabel4, 5:
hpLabel5 ou 6: hpLabel6

alinhado à direita

Objetos 186
5.12 Tradução
Esta seção contém informações sobre os objetos do tipo Tradução na Biblioteca HighPerformance Template.
5.12.1 hpTranslatorAddLinkXM
O objeto hpTranslatorAddLinkXM cria as Associações de tradução em modo extendido (eXtended Mode) nos objetos
de Tela. Para isto, instancie este objeto em uma Tela e execute-o no Studio. Ao varrer os objetos da Tela, este objeto
decide quais objetos recebem as Associações de tradução e em quais propriedades estas Associações são criadas
com base nas configurações realizadas no objeto hpTranslatorController. Uma vez criadas as Associações, a Tela
deve ser salva para persistir estas configurações.
NOTA
Caso a propriedade EnableGroupSearch do objeto hpTranslatorController esteja habilitada, a varredura executada
leva em conta objetos dentro de objetos do tipo DrawGroup.
Para mais detalhes sobre o roteiro de configuração do processo de tradução, consulte o tópico Tradução.
A tabela a seguir contém as propriedades do objeto hpTranslatorAddLinkXM.
Propriedades do objeto hpTranslatorAddLinkXM
idioma principal da aplicação. O valor padrão desta
propriedade é "pt-BR" (português do Brasil). Esta
futura
Run Cria as Associações de tradução em tempo de execução.

O valor padrão desta propriedade é Falso
5.12.2 hpTranslatorController
O objeto hpTranslatorController é o principal controlador do recurso de tradução da Biblioteca HighPerformance
Template. Com este objeto é possível configurar o comportamento do recurso de tradução e importar e armazenar
um dicionário com os termos traduzidos. Este objeto é instanciado no item Objetos de Servidor - Objetos de Dados
- hpObjects - Translator do Organizer no arquivo de projeto hpMain.prj.
Para mais detalhes sobre o roteiro de configuração do processo de tradução, consulte o tópico Tradução.
A tabela a seguir contém as propriedades do objeto hpTranslatorController.
187 Objetos
Propriedades do objeto hpTranslatorController
AutoCreateHPLinks Habilita a criação automática das Associações de
tradução para os objetos nativos da Biblioteca
HighPerformance Template. Esta configuração, quando
habilitada, elimina a necessidade de declarar os objetos
nativos na propriedade PropertiesList. Os valores
possíveis são True: Criação automática habilitada ou
False: Criação automática desabilitada

idioma principal da aplicação. O valor padrão desta
propriedade é "pt-BR" (português do Brasil)
Definitions Armazena um vetor contendo as definições lidas do

dicionário
Dictionary Nome do arquivo de dicionário com os termos

traduzidos, com a extensão .csv. Se o valor desta
propriedade contém apenas o nome do arquivo, este
arquivo deve estar armazenado na pasta
HighPerformance - Dictionaries. Caso contrário, deve
ser um caminho completo. Em caso de erro na leitura,
verifique as propriedades ImportStatus e
ErrorDescription para mais informações
EnableGlobalTranslation Habilita o recurso de tradução no escopo global da

aplicação
EnableGroupSearch Habilita a busca por objetos dentro de objetos do tipo

DrawGroup durante a criação de Associações de
tradução realizada pelo objeto hpTranslatorAddLinkXM
ErrorDescription Descrição do erro ocorrido na importação do dicionário
ImportDictionary Importa um dicionário e o salva na propriedade

Definitions
ImportStatus Indica o estado atual da importação. Os valores possíveis

são -1: Erro, 0: Ocioso, 1: Executando ou 2: Importação
concluída com sucesso
KeepsExistingLinks Impede que o objeto hpTranslatorAddLinkXM

sobrescreva as Associações existentes nos objetos de
Tela. Os valores possíveis são True: Preserva as
Associações existentes ou False: Sobrescreve as
Associações existentes
LinkEnabledTranslationOnly Cria as Associações de tradução somente nos objetos

cuja propriedade EnableTranslation seja igual a True.
Caso um objeto declarado na propriedade
PropertiesList não possua a propriedade
EnableTranslation, as Associações de tradução são
criadas normalmente
Objetos 188
PropertiesList Lista contendo os tipos de XControls e suas
propriedades que recebem as Associações de tradução.
O formato desta lista é
"TipoObjeto:Propriedade1,...,PropriedadeN;". Por
exemplo, se um objeto myObject1 recebe as
Associações de tradução nas propriedades Value e Tip
e um objeto myObject2 recebe as Associações de
tradução somente na propriedade DocString, o valor
desta propriedade deve ser igual a
"myObject1:Value,Tip;myObject2:DocString;"
XMLOutput Código no formato XML criado a partir da leitura

realizada no dicionário indicado na propriedade
Dictionary
5.13 TreeView
O controle Treeview da Biblioteca HighPerformance Template replica a estrutura de um objeto fonte, que pode ser
por exemplo uma Pasta de Dados (DataServer) ou uma Subestação (PowerSubstation). As figuras a seguir mostram
exemplos de estruturas de objetos fonte.
Pasta de Dados
189 Objetos
Subestação
Em linhas gerais, a estrutura com objetos fontes deve ser lida por um objeto gerador de XML, o objeto
hpXMLCatalog da biblioteca hpXMLIndexer. O código XML correspondente à estrutura deve ser repassado a um
Tag Interno no Viewer, que o repassa para o objeto hpTreeview instanciado em Tela. As figuras a seguir ilustram este
fluxo de dados.
Objeto hpXMLCatalog
Objetos 190
Tag Interno no Viewer
Associação na propriedade DocInput
Os procedimentos para usar o controle Treeview são os seguintes:
1. Instancie um objeto hpXMLCatalog na pasta hpObjects - XML.
2. Configure o objeto hpXMLCatalog.
3. Copie e renomeie um Tag Interno existente na pasta Viewer - hpControls - XML, disponível na aplicação de
demonstração da Biblioteca HighPerformance Template.
191 Objetos
4. Verifique se o Tag Interno criado no passo anterior tem o mesmo nome do objeto hpXMLCatalog
correspondente.
5. Instancie em Tela um objeto hpTreeView, da biblioteca hpTreeview.lib.
6. Associe a propriedade DocInput do objeto hpTreeView ao Tag Interno correspondente.
O nó selecionado retorna seu caminho (path) na propriedade SelectedNode do objeto hpTreeView.
NOTA
Este objeto é totalmente integrado à Biblioteca HighPerformance Template, com suporte nativo a Temas e ao
recurso de tradução automática.
5.13.1 Propriedades
A tabela a seguir contém as propriedades do objeto hpTreeView.
Propriedades do objeto hpTreeView
CheckAllNodes Seleciona todos os nós do objeto TreeView. Os valores
possíveis são True: Executa a seleção ou False
(automático): Seleção concluída. Esta propriedade é
usada somente quando a propriedade
MultipleSelection é igual a True
ColorArrowCollapsed Cor da seta para nós recolhidos. Esta propriedade é

HighPerformanceMode é igual a False
ColorArrowExpanded Cor da seta para nós expandidos. Esta propriedade é

ColorHover Cor dos nós com o efeito MouseOver. Esta propriedade

é usada somente quando a propriedade
ColorIcon Cor dos ícones. Esta propriedade é usada somente

quando a propriedade HighPerformanceMode é igual a
False
ColorItemBack Cor de fundo dos nós. Esta propriedade é usada

somente quando a propriedade HighPerformanceMode
é igual a False
ColorSelectedBorder Cor da borda dos nós selecionados. Esta propriedade é

ColorSelectedFill Cor de fundo dos nós selecionados. Esta propriedade é

Objetos 192
ColorText Cor do texto. Esta propriedade é usada somente quando
a propriedade HighPerformanceMode é igual a False

idioma principal para as Associações de tradução. O
valor padrão desta propriedade é "pt-BR" (português do
Brasil)
DocInput Associação para um Tag Interno que contém um objeto

do tipo XMLDOM na propriedade Value
Domain Nome de um Domínio Remoto, como por exemplo

"MyDomain:". Para acesso local, o valor desta
propriedade deve ser deixado em branco
DoubleClickMode Define o modo de resposta ao evento de clique duplo.

Os valores possíveis são 0: Expande o nó (padrão) ou 1:
Incrementa o valor da propriedade EventDoubleClick.
Esta propriedade é usada somente quando a
propriedade Behaviour é igual a 1 (um) e a propriedade
EnableCommandOnSingleClick é igual a False
EnableCommandOnSingleClick Habilita o modo de resposta ao evento de clique

simples. Os valores possíveis são True: Incrementa o
valor da propriedade EventSingleClick ou False:
Seleciona o nó (padrão). Se o valor desta propriedade é
igual a True, o clique duplo deixa de ter efeito sobre o
objeto TreeView
EnableFiltering Habilita o controle de busca do usuário. Os valores

possíveis são True: Exibe e habilita o controle de busca
ou False: Oculta e desabilita o controle de busca
EnableKeywords Habilita a busca por palavras-chave. Esta propriedade é

usada somente quando a propriedade EnableFiltering é
igual a True
EventDoubleClick Incrementa seu valor de 1 (um) a 9 (nove) quando este

esquerdo do mouse
EventSingleClick Incrementa seu valor de 1 (um) a 9 (nove) quando este

esquerdo do mouse
FilterCriteria Define um critério da busca. Os valores possíveis são 0:

Critério baseado em hierarquia (HierarchyBased) ou 1:
Critério baseado em conteúdo (ContentBased). Em uma
busca baseada em hierarquia, o nó que corresponde ao
filtro é exibido juntamente com seus filhos, mesmo que
estes não correspondam ao filtro definido pelo usuário.
Em uma busca baseada em conteúdo, o nó que
corresponde ao filtro traz apenas os filhos que também
correspondam ao filtro definido pelo usuário. Esta
EnableFiltering é igual a True
193 Objetos
FilterMode Define o modo da busca. Os valores possíveis são 0:
Pelo nome (ByName), 1: Pelo tipo (ByType) ou 2: Pelo
nome e tipo (ByNameAndType). Esta propriedade é
igual a True
FilterString String com os termos para filtrar a busca. Por exemplo,

a expressão "TR1 Breaker -Operator" exibe os objetos
que contenham "TR1" ou "Breaker" em seu nome ou tipo,
excluindo do resultado todos os objetos que tenham
"Operator" em seu nome ou tipo. Esta propriedade é
igual a True
HighPerformanceMode Modo de visualização do objeto TreeView. Os valores

possíveis são True: Aparência de alto desempenho visual
onde as cores são integradas aos Temas ou False:
Aparência convencional onde as cores são definidas
manualmente pelo usuário
InvertColors Inverte a cor dos ícones. Os valores possíveis são True:

Cor mais escura que o fundo da Tela e False: Cor mais
clara que o fundo da tela. Esta propriedade é usada
somente quando a propriedade HighPerformanceMode
é igual a True
ItemCheckedOnClick Retorna o caminho do nó selecionado através da caixa

de seleção múltipla
ItemUncheckedOnClick Retorna o caminho do nó desmarcado através da caixa

de seleção múltipla
MaxVisibleElements Número máximo de elementos visíveis. Ao invés de

digitar um valor diretamente neste campo, recomenda-se
criar uma Associação com o número de elementos na
Janela de Propriedades deste objeto. O objetivo é evitar
a distorção das dimensões do objeto por conta da
diferença de tamanho
MultipleSelection Habilita o modo de seleção múltipla. Os valores possíveis

são True: Exibe as caixas de seleção múltipla ou False:
Oculta as caixas de seleção múltipla
ParamsResetOnSourceChange Redefine o valor dos parâmetros S, E, C e Y do código

XML sempre que a origem, ou seja, a propriedade
DocInput, é alterada, assim como os valores de seleção
múltipla
PowerIconsAutoShow Exibe automaticamente os respectivos ícones para

objetos do Elipse Power. Esta propriedade é usada
somente quando a propriedade ShowIcons é igual a
True
ResetAllCheckedNodes Desmarca todas as caixas de seleção no objeto

TreeView. Esta propriedade é usada somente quando a
propriedade MultipleSelection é igual a True
Objetos 194
SelectedNode Caminho do nó selecionado. Esta propriedade é usada
em conjunto com a propriedade SelectedNodeReady
SelectedNodeReady Indica quando a propriedade SelectedNode está pronta

para ser lida
SelectedNodeType Tipo do nó selecionado
SelectionList Retorna uma lista com os caminhos dos objetos

selecionados através das respectivas caixas de seleção
múltipla. Os caminhos são separados por ponto e vírgula
e incluem tanto objetos visíveis na janela do objeto
TreeView quanto objetos ocultos. Esta propriedade é
MultipleSelection é igual a True
ShowIcons Visibilidade dos ícones. Os valores possíveis são True:

Ícones visíveis ou False: Ícones ocultos
StateResetRequestPaths Lista com os valores das propriedades PathName dos

nós cuja caixa de seleção deve ser desmarcada. Esta
operação é realizada ao alterar o valor desta
propriedade, e é zerada em seguida. Os valores devem
StateSetRequestPaths Lista com os valores das propriedades PathName dos

nós cuja caixa de seleção deve ser marcada. Esta
operação é realizada ao alterar o valor desta
propriedade, e é zerada em seguida. Os valores devem
TreeWidth Largura, em unidades Himetric, do objeto TreeView
5.13.2 Modo HighPerformance ou Convencional

A Biblioteca hpTreeview é parte integrante da Biblioteca HighPerformance Template, porém pode ser usada fora
do Template. Para isto, configure no objeto hpTreeView a propriedade HighPerformanceMode para False e ajuste as
cores manualmente.
Ao configurar a propriedade HighPerformanceMode para False, as seguintes propriedades são habilitadas:
· ColorArrowCollapsed: Cor do indicador de pasta quando recolhido
· ColorArrowExpanded: Cor do indicador de pasta quando expandido
· ColorHover: Cor usada para indicar que o ponteiro do mouse se encontra sobre o nó
· ColorIcon: Cor usada nos ícones do Elipse Power quando a propriedade PowerIconsAutoShow está configurada
em True
· ColorItemBack: Cor de fundo de cada nó
· ColorSelectedBorder: Cor da borda de um nó selecionado
· ColorSelectedFill: Cor de fundo do nó selecionado
· ColorText: Cor do texto de cada nó
195 Objetos
Ao configurar a propriedade HighPerformanceMode para True, o objeto TreeView é integrado à Biblioteca
HighPerformance Template, herdando todas as suas facilidades. Neste modo são habilitadas as seguintes
propriedades:
· EnableIconBackground: Desenha um retângulo como fundo de cada ícone
· EnableTranslation: Habilita a tradução do objeto em tempo de execução
· InvertColors: Inverte as cores dos ícones. Se o ícone exibe o traço em cor clara, passa a exibir o traço em cor
escura, e vice-versa
5.13.3 Exibindo Ícones

Para exibir ícones no objeto TreeView, altere o valor da propriedade ShowIcons para True. Se o objeto TreeView é
usado dentro da Biblioteca HighPerformance Template, é possível:
· Exibir ícones do Elipse Power automaticamente: Para isto, mude o valor da propriedade PowerIconsAutoShow
para True
· Exibir ícones da biblioteca hpIcons: Para isto, digite o nome do ícone na propriedade DocString dos objetos
fonte, como por exemplo "hpIconHome"
Se o objeto TreeView é usado fora da Biblioteca HighPerformance Template, é possível:
· Exibir ícones do Elipse Power automaticamente: Para isto, mude o valor da propriedade PowerIconsAutoShow
para True. A cor do traço dos ícones deve ser especificada na propriedade ColorIcon do objeto hpTreeView
· Exibir ícones gerados pelo usuário: Para isto, digite o endereço e o nome do ícone na propriedade DocString
dos objetos fonte. Se o caminho da imagem contém números ou caracteres especiais, este deve ser colocado
entre colchetes. A figura a seguir mostra um exemplo de referência a uma imagem inserida como Recurso na
aplicação
Propriedade DocString
Independente do valor da propriedade HighPerformanceMode, quando a propriedade PowerIconsAutoShow está

configurada em True, os ícones dos objetos do Elipse Power são automaticamente exibidos, ignorando qualquer
texto configurado na propriedade DocString dos objetos fonte.
5.13.4 Exibindo a Barra de Rolagem

A barra de rolagem do objeto TreeView é exibida automaticamente quando o número de nós visíveis excede o limite
estabelecido para o objeto, configurado na propriedade MaxVisibleElements. Da mesma forma, a barra de rolagem
é oculta automaticamente quando o número de nós visíveis é inferior ao definido na propriedade
MaxVisibleElements. As propriedades a seguir influenciam o funcionamento da barra de rolagem:
· MaxVisibleElements: Número máximo de nós exibidos no objeto
Objetos 196
· TreeWidth: Largura do controle
5.13.5 Selecionando Múltiplos Nós

Para ativar o modo de seleção múltipla de nós, configure a propriedade MultipleSelection para True. Neste modo,
cada item do controle TreeView pode ser selecionado através de uma caixa de seleção. As propriedades a seguir
retornam valores neste modo:
· SelectionList: Lista de todos os nós cujas respectivas caixas de seleção estão selecionadas. Ao selecionar um nó
pai, todos os seus nós filhos e descendentes são selecionados e aparecem nesta lista, independente de estarem
expandidos ou não. Da mesma forma, ao desmarcar um nó pai, todos os seus nós filhos e descendentes são
desmarcados e removidos desta lista, independente de estarem expandidos ou não
· ItemCheckedOnClick: Último nó cuja caixa de seleção foi selecionada através de um clique de mouse
· ItemUncheckedOnClick: Último nó cuja caixa de seleção foi desmarcada através de um clique de mouse
É possível selecionar ou desmarcar todos os nós do objeto TreeView, tanto os visíveis quanto os ocultos, usando as
propriedades CheckAllNodes e ResetAllCheckedNodes.
5.13.6 Filtrando o Conteúdo

O objeto hpTreeView permite filtrar itens pelo nome ou pelo tipo do objeto fonte e por palavras-chave, utilizando as
seguintes propriedades:
· EnableFiltering: Habilita ou desabilita o recurso de filtro
· FilterMode:
· 0 - ByName: Busca somente pelo nome do objeto
· 1 - ByType: Busca somente pelo tipo do objeto
· 2 - ByNameAndType: Busca tanto pelo nome quanto pelo tipo do objeto
· FilterCriteria:
· 0 - HierarchyBased: Traz o nó que corresponde ao filtro e todos os seus objetos filhos, mesmo que estes não
correspondam ao critério definido no filtro
· 1 - ContentBased: Traz o nó que corresponde ao filtro e apenas os objetos filhos que correspondam ao
critério do filtro
· EnableKeywords: Habilita ou desabilita a utilização de palavras-chave no filtro
Para filtrar os nós, siga estes procedimentos:
1. Certifique-se de que o filtro esteja habilitado, ou seja, que o valor da propriedade EnableFiltering seja igual a
True.
2. Para incluir um nó na visualização, digite na caixa de busca localizada sobre o objeto TreeView um texto que esteja
contido no nome ou tipo do nó que se deseja exibir. Por exemplo, ao digitar "Break", o objeto TreeView exibe
todos os objetos que contenham a expressão "Break" em seu tipo, como PowerBreaker, ou que contenham a
expressão "Break" em seu nome.
3. Para excluir um nó da visualização, siga o critério anterior, porém adicionando um sinal de menos à frente do
termo. Por exemplo, ao digitar "-Scada", o objeto TreeView deixa de exibir os nós cujo nome ou tipo contenham a
expressão "Scada".
197 Objetos
4. É possível filtrar mais de um termo por vez. Para isto, digite os termos separados por espaço. Por exemplo, ao
digitar "TR1 -Operator", o filtro inclui os nós relacionados a "TR1" e exclui da visualização todos os nós
relacionados a "Operator".
5. É possível também alterar o conteúdo do campo de busca através da propriedade FilterString do objeto
TreeView.
6. Se o filtro está habilitado e o valor da propriedade FilterString é uma String vazia, o filtro exibe todos os nós
possíveis.
7. Para cadastrar palavras-chave, consulte o tópico hpXMLCatalog.
5.13.7 Troca Dinâmica da Fonte de Dados

O objeto hpTreeView permite trocar dinamicamente sua fonte de dados. Para isto, atribua a propriedade PathName
do Tag Interno no Viewer à propriedade DocInput do objeto hpTreeview, conforme o exemplo a seguir.
Screen.Item("hptreeview1").DocInput = Application.Item("hpControls")._
Item("XML").Item("docInput_Nav").PathName
5.13.8 Eventos Personalizados

É possível personalizar a resposta do objeto ao receber um clique simples ou duplo em um de seus nós.
Clique Simples
1. Configure a propriedade EnableCommandOnSingleClick com o valor True.
2. Crie um evento personalizado que responda à alteração da propriedade EventSingleClick. Desta forma, sempre
que o usuário clica em um nó, este script é executado.
NOTA
Com esta configuração, as propriedades DoubleClickMode e EventDblClick permanecem inativas.
Clique Duplo
1. Configure a propriedade DoubleClickMode com o valor True.
2. Crie um evento personalizado que responda à alteração da propriedade EventDblClick. Desta forma, sempre que
o usuário clica duas vezes em um nó, este script é executado e o nó que recebeu este clique duplo não alterna
entre os estados expandido e recolhido.
5.14 XML
Esta seção contém informações sobre os objetos do tipo XML na Biblioteca HighPerformance Template.
5.14.1 hpXMLCatalog
O objeto hpXMLCatalog lê uma ou mais pastas de objetos e gera o código XML correspondente na propriedade
xmlOutput.
NOTA
Este objeto é totalmente integrado à Biblioteca HighPerformance Template, com suporte à geração de código
XML compatível com os objetos hpTreeView e hpLyraMenu.
Objetos 198
Este objeto pode ser usado tanto dentro como fora da Biblioteca HighPerformance Template. Desta forma é capaz
de gerar código XML a partir de objetos de qualquer aplicação Elipse E3 ou Elipse Power.
A tabela a seguir contém as propriedades do objeto hpXMLCatalog.
Propriedades do objeto hpXMLCatalog
ExtraProperties Parâmetros personalizados para o código XML. Para
mais informações, consulte o tópico Parâmetros
Personalizados
FriendlyNameProperty Nome da propriedade do objeto de dados que contém

o texto dos nós do objeto hpTreeView. Para exibir a
denominação dos nós com o valor da propriedade
Caption dos objetos de dados, por exemplo, o valor
desta propriedade deve ser igual a "Caption"
FriendlyTipProperty Nome da propriedade do objeto de dados que contém

o texto da dica dos nós do objeto hpTreeView. Para
exibir a dica de cada nó com o valor da propriedade
DocString dos objetos de dados, por exemplo, o valor
desta propriedade deve ser igual a "DocString"
GetAllChildren Retorna os objetos filhos em todos os níveis da árvore.

Se esta propriedade é configurada em False, retorna
somente o primeiro nível hierárquico
HideDataType Tipo ou tipos de objetos a serem excluídos da consulta
HideObjectName Nome ou nomes de objetos a serem excluídos da

consulta
InitialPath Lista de pastas a serem lidas para gerar o código XML,

separadas por ponto e vírgula
InvalidCharReplacement Indica o caractere para substituição de caracteres

inválidos no código XML. Os valores possíveis são 0:
Remove o caractere sem substituir, 1: Substitui pelo
caractere de sublinhado (ASCII 95), 2: Substitui pelo
caractere de espaço (ASCII 32), 3: Substitui pelo caractere
de hífen (ASCII 45), 4: Substitui pelo sinal de mais (ASCII
43) ou 5: Substitui pelo ponto de interrogação (ASCII 63)
KeywordProperty Nome da propriedade, no objeto fonte, que contém a

palavra-chave ou palavras-chave
NormalizeBranchCheckState Normaliza o valor da seleção das caixas de seleção nos

nós em cada ramificação onde ao menos um nó, o
parâmetro C, foi alterado no código XML. Se o valor
desta propriedade é igual a True, o usuário pode
declarar, na propriedade ExtraProperties, o parâmetro
reservado C. Caso contrário é mostrado um alerta sobre
o conflito do parâmetro declarado com o parâmetro
reservado
199 Objetos
OutputMode Especifica o local onde o código XML é gerado. Os
valores possíveis são 0: Gera um único código XML e
salva este código na propriedade xmlOutput (padrão)
ou 1: Gera um código XML específico para cada objeto
do tipo xfPlantFolder ou equivalente encontrado na
varredura, salvando este código na propriedade
xmlData de cada objeto xfPlantFolder ou equivalente
Run Gera um novo código XML se o valor é igual a True
RunOnStart Gera o código XML na inicialização da aplicação.

Recomenda-se deixar este valor em False para um
melhor desempenho na inicialização da aplicação
ScanNodeAfterSave Afeta o modo como é realizada a varredura pela árvore

de objetos. Esta propriedade é válida apenas quando a
propriedade OutputMode é igual a 1 (um). Os valores
possíveis são True: Permite que, após salvar o código
XML na propriedade xmlData de um nó do tipo
xfPlantFolder ou equivalente, o objeto hpXMLCatalog
continue a varredura pelos filhos deste nó, a fim de que,
caso encontre mais filhos do tipo xfPlantFolder ou
equivalente cuja propriedade StoreXML seja igual a True,
os respectivos códigos XML sejam também gravados ou
False: Permite que, após gravar o código XML no
primeiro objeto xfPlantFolder ou equivalente
encontrado cuja propriedade StoreXML seja igual a
True, o objeto hpXMLCatalog interrompa a varredura
neste nó e passe ao nó seguinte, ignorando todos os
filhos do objeto alterado. NOTA: Para um melhor
desempenho, o valor desta propriedade deve
permanecer em False sempre que possível
ShowDataType Tipo ou tipos de objetos a serem incluídos na consulta.

Um valor vazio nesta propriedade retorna todos os tipos
de objetos
ShowObjectName Nome ou nomes de objetos a serem incluídos na

consulta. Um valor vazio nesta propriedade retorna
todos os nomes de objetos
ShowRootFolder Se configurada para True, o nó raiz das pastas incluídas

na propriedade InitialPath é incluído no código XML. Se
configurada para False, o nó raiz não é incluído no
código XML
xmlCurrentFolder Exibe o nome da pasta em análise ao gerar o código

XML no Studio
xmlOutput Código XML finalizado
xmlProgress Exibe o andamento da geração do código XML no

Studio
Objetos 200
XMLTemplate Modifica o código XML resultante com base em um
modelo pré-definido. Os valores possíveis para esta
propriedade são 0: Modelo definido pelo usuário na
propriedade ExtraProperties, 1: Modelo para uso pelo
objeto hpTreeView, 2: Modelo para uso pelo objeto
hpLyraMenu, 3: Modelo para uso pela Tela Faceplate, 4:
Modelo para uso pelo FlexControl, 5: Modelo para uso
pelo objeto hpTreeView (modo compactado) ou 6:
Modelo para uso pela função de navegação
XRefMode Configura a forma de tratamento dos objetos xfPMRef.

Os valores possíveis são 0: Mantém os nós de
referências externas no código XML, 1: Remove os nós
de referências externas e mescla o conteúdo no código
XML
NOTAS
· Objetos equivalentes ao objeto xfPlantFolder são XFolders que tenham as mesmas propriedades StoreXML e
xmlData dos objetos do tipo xfPlantFolder. Sem estas propriedades, o objeto hpXMLCatalog não armazena no
objeto o código XML gerado.
· Caso os nomes das propriedades informadas nas propriedades FriendlyNameProperty e FriendlyTipProperty
não existam ou o valor seja uma String vazia, o texto dos nós usa o valor da propriedade Name do objeto e o
texto das dicas dos nós é configurado com uma String vazia e, portanto, a dica é desativada.
· As propriedades FriendlyNameProperty e FriendlyTipProperty, quando usadas como parâmetros
personalizados na propriedade ExtraProperties para geração de código XML, usam os códigos FNP e FTP,
respectivamente.
· O novo comportamento da dica, ou tip, representa uma quebra de compatibilidade, pois antes era exibida apenas
a denominação, ou seja, a propriedade Name do próprio nó como dica. Para retomar o comportamento anterior,
configure a propriedade FriendlyTipProperty com o valor "Name". Caso não deseje traduzir a dica, crie um termo
no dicionário da aplicação onde cada idioma deve ser configurado com o valor original.
5.14.1.2 Gerando Código XML

Para gerar código XML a partir da leitura de uma estrutura de objetos do servidor, siga estes procedimentos:
1. Instancie um objeto do tipo hpXMLCatalog na pasta XML do item Objetos de Servidor - Objetos de Dados -
hpObjects do Organizer.
2. Informe a pasta a ser lida para gerar o código XML na propriedade InitialPath. Para mais de uma pasta, separe
os valores por ponto e vírgula.
3. Clique com o botão direito do mouse no objeto hpXMLCatalog e selecione a opção Configurar.
4. As propriedades xmlCurrentFolder e xmlProgress indicam o progresso da geração do código XML. Ao final

deste processo, o código XML gerado está disponível na propriedade xmlOutput.
Este primeiro código XML contempla apenas os nós do primeiro nível hierárquico da árvore. Para trazer também
todos os seus filhos, configure o valor da propriedade GetAllChildren para True e execute novamente este objeto no
Studio.
O código XML gerado contém um conjunto de parâmetros pré-definidos, descritos na tabela a seguir.
201 Objetos
Parâmetros pré-definidos do objeto hpXMLCatalog
PARÂMETRO DESCRIÇÃO
H Número de objetos filhos
D Valor da propriedade DocString
K Valor da propriedade especificada em KeywordProperty
N Nome do objeto
P Valor da propriedade PathName
R Número sequencial
T Tipo do objeto
W Indica se o objeto é um objeto do Elipse Power (-1,

menos um) ou não (0, zero)
X Uso reservado
5.14.1.3 Usando Filtros

Para um melhor desempenho, recomenda-se sempre gerar um código XML que contenha apenas os elementos
necessários para o funcionamento normal da aplicação. Isto é possível com o uso de filtros usando as propriedades
HideDataType, ShowDataType, HideObjectName e ShowObjectName. Para filtrar mais de um tipo ou nome de
objeto simultaneamente, separe os tipos ou nomes por ponto e vírgula.
O filtro do objeto hpXMLCatalog pode realizar busca com dois tipos de correspondência, Ampla ou Exata. A busca
de termos usando correspondência ampla corresponde à busca padrão do objeto, no formato a seguir.
Analog;Discrete
Este tipo de filtro busca correspondência nos termos que sejam iguais ou contenham ao menos uma parte igual ao
termo declarado. Assim, Analog pode ser igual ou estar contido no termo correspondido, como por exemplo em
"xfAnalogInfo".
Já para realizar uma busca de termos usando a correspondência exata, deve-se declarar cada termo entre aspas
duplas, no formato a seguir.
"xfAnalogInfo";Discrete
Este filtro traz resultados onde a correspondência é exata para xfAnalogInfo e ampla para Discrete. Para filtrar todos
os termos com correspondência exata, cada termo deve ser declarado entre aspas duplas separadamente, conforme
o exemplo a seguir.
"xfAnalogInfo";"xfDiscreteInfo"
NOTA
Referências externas, ou objetos do tipo xfPMRef, quando submetidas aos filtros, podem gerar resultados
peculiares em virtude da natureza de apontamento a objetos externos, que por sua vez podem ser de tipos
contemplados nos parâmetros de filtragem. A tabela a seguir mostra o comportamento de algumas combinação de
elementos e propriedades, a fim de aclarar o funcionamento.
Objetos 202
Comportamento de combinações de elementos e propriedades
EXPRESSÃO RESULTADO
HideDataType = xfPMRef | XRefMode = 0 | Conteúdo Nenhum nó do tipo xfPMRef ou conteúdo externo deve
externo não declarado no filtro ser exibido
HideDataType = xfPMRef | XRefMode = 1 | Conteúdo Nenhum nó do tipo xfPMRef deve ser exibido, somente
externo não declarado no filtro o conteúdo externo
ShowDataType = xfPMRef | XRefMode = 0 | Conteúdo Exibe todos os nós do tipo xfPMRef

externo não declarado no filtro
ShowDataType = xfPMRef | XRefMode = 1 | Conteúdo Não exibe o conteúdo externo declarado no filtro e nem
externo declarado nas propriedades HideDataType ou o nó do tipo xfPMRef
HideObjectName
ShowDataType = xfPMRef | XRefMode = 1 | Conteúdo Exibe apenas o conteúdo externo declarado no filtro
externo declarado nas propriedades ShowDataType ou
ShowObjectName
5.14.1.4 Parâmetros Personalizados

É possível configurar parâmetros personalizados no código XML, tendo como base:
· Uma propriedade existente de um objeto
· Propriedades reservadas do objeto hpXMLCatalog
· Um valor padrão definido pelo usuário
A seguir são detalhados cada um destes tipos de parâmetros.
Parâmetros Baseados em uma Propriedade Existente de um Objeto
Para criar um parâmetro personalizado com base no valor de uma propriedade existente de um objeto, use a
propriedade ExtraProperties. Os parâmetros personalizados devem ser declarados nesta propriedade obedecendo o
formato Propriedade=Alias, onde Propriedade é o nome da propriedade existente no objeto e Alias é o nome do
parâmetro a ser incluído no código XML.
Por exemplo, para incluir o valor da propriedade Caption de um objeto, selecione um Alias para o parâmetro. Este
Alias deve ser diferente de todos os demais que já estejam em uso no código XML e na propriedade ExtraProperties.
Para isto, consulte os tópicos indicados a seguir.
· Parâmetros pré-definidos do objeto hpXMLCatalog
· Parâmetros adicionais compatíveis com o objeto hpTreeView
· Parâmetros adicionais compatíveis com o objeto hpLyraMenu
· Parâmetros adicionais compatíveis com a Tela Faceplate
Após verificar os possíveis conflitos, use a expressão "CA" como Alias exclusivo para o parâmetro da propriedade
Caption. Neste caso, o formato da declaração na propriedade ExtraProperties é o seguinte:
Caption=CA
O resultado no código XML é a inclusão do parâmetro CA com o valor da propriedade Caption, da seguinte forma:
CA="TMGT"
203 Objetos
Pode-se declarar mais de um parâmetro personalizado na propriedade ExtraProperties. Para isto, separe-os por
ponto e vírgula, como no exemplo a seguir.
Caption=CA;Value=VA;Tip=TI
O resultado no código XML é o seguinte:

CA="TMGT" VA="True" TI="Temperatura do MGT"
Parâmetros Baseados em uma Propriedade Reservada do objeto hpXMLCatalog
As propriedades listadas a seguir são reservadas para uso exclusivo do objeto hpXMLCatalog e podem ser
declaradas na propriedade ExtraProperties com qualquer Alias selecionado pelo usuário, desde que seja exclusivo.
Propriedade reservadas para uso na propriedade ExtraProperties
PROPRIEDADE VALOR RETORNADO

ParentPathName Propriedade PathName do objeto pai
Por exemplo, ao declarar na propriedade ExtraProperties uma propriedade reservada no formato a seguir:
ParentPathName=PPN
Neste caso, o objeto hpXMLCatalog identifica a propriedade como reservada e atribui o valor correspondente ao
Alias, que é o valor da propriedade PathName do objeto pai.
<Elm N="XObject11" P="Dados1.XObject11" PPN="Dados1"
NOTAS
· Um Alias deve ter um ou mais caracteres, e recomenda-se um número reduzido de caracteres para que o código
XML final também tenha um tamanho reduzido, o que melhora o desempenho de processamento e tráfego de
dados.
· Caso a propriedade declarada na propriedade ExtraProperties não exista em um determinado objeto, e não seja
uma propriedade reservada, então esta propriedade não é incluída no nó do código XML que corresponde a este
objeto.
· Propriedades reservadas são incluídas em todos os nós do código XML.
Parâmetros Baseados em um Valor Padrão
Para criar um parâmetro personalizado tendo por base um valor padrão definido pelo usuário, deve-se usar a
propriedade CustomParameters, no formato a seguir.
ParamName{DefaultValue};...;ParamName{DefaultValue}
O valor padrão de cada parâmetro deve ser declarado após o nome e entre chaves. Se omitido, o valor padrão é
assumido como uma String vazia, conforme o exemplo a seguir.
CustomParameters = CP1{v1};CP2;CP3{};CP4{v'4}
Esta configuração gera a saída a seguir no código XML, para todos os nós.
CP1='v1' CP2='' CP3='' CP4='v_4'
O valor padrão não pode conter os caracteres de aspas simples ('), ponto e vírgula (;) e chave de abertura ({).
O usuário deve configurar parâmetros com nomes diferentes dos demais parâmetros existentes no código XML, caso
contrário o valor do parâmetro existente é sobrescrito pelo valor do parâmetro personalizado.
Objetos 204
5.14.1.5 Normalização de Estados de Seleção Múltipla
A função de Normalização de Estados de Seleção Múltipla permite informar o estado de seleção múltipla de um nó
no objeto hpTreeView baseado no valor de uma propriedade. Isto é realizado através da associação do nome da
propriedade com o parâmetro reservado C na propriedade ExtraProperties, conforme o código a seguir.
NomeDaPropriedade=C
Esta função também atualiza os valores de seleção dos nós ascendentes e descendentes conforme o valor registrado.
Os valores aceitos para as propriedades associadas estão descritos na tabela a seguir.
Valores aceitos para propriedades associadas
PROPRIEDADE DO TIPO BOOLEAN PROPRIEDADE DO TIPO INTEGER

True -1 (menos um)
False 0 (zero)
Os valores correspondentes do parâmetro C no código XML estão descritos na tabela a seguir.
Valores correspondentes ao parâmetro C
PARÂMETRO C VALOR LÓGICO

-1 (menos um) Verdadeiro
0 (zero) Falso
1 (um) Intermediário
Esta função é para códigos XML de uso exclusivo do objeto hpTreeView, tanto para o modo normal, propriedade
XMLTemplate igual a 1 (um), como para o modo compacto, propriedade XMLTemplate igual a 5 (cinco).
Exemplo de Uso
Se a propriedade associada é do tipo Booleano e o valor é igual a Verdadeiro, a função de normalização registra o
valor do parâmetro C do nó correspondente igual a -1 (menos um, Verdadeiro). Em seguida, a função de
normalização ajusta o valor do parâmetro C dos nós descendentes para o mesmo valor, enquanto os nós
ascendentes são ajustados para os valores -1 (menos um, Verdadeiro) ou 1 (um, Intermediário) conforme o caso.
Roteiro
Para que o código XML seja gerado com sucesso, são necessários os passos a seguir.
1. Configure a propriedade NormalizeBranchCheckState com o valor True.
2. Configure a propriedade XMLTemplate com o valor 1 (um) ou 5 (cinco).
3. Configure a propriedade ExtraProperties com a propriedade do objeto que informa se o nó inicia marcado ou
não, como por exemplo "EnableCheckObject=C".
205 Objetos
IMPORTANTE
Para que as atribuições de valor da propriedade do objeto funcionem corretamente, é necessário que os valores
sejam Booleanos ou os inteiros 0 (zero) e -1 (menos um), caso contrário o parâmetro C do código XML mantém os
valores padrão.
5.14.1.6 Compatibilidade com o Objeto hpTreeView

Configure o valor da propriedade XMLTemplate com o valor 1 (um) a fim de gerar um código XML compatível com
um objeto hpTreeView. A tabela a seguir contém a descrição dos parâmetros adicionados ao código XML resultante.
Parâmetros adicionais compatíveis com o objeto hpTreeView para XMLTemplate igual a 1 (um)
I Endereço do ícone definido nas propriedades
IconGallery e IconName do objeto de dados. Caso estas
propriedades não existam ou os valores sejam vazios,
usa-se o valor da propriedade DocString
S Nó selecionado
E Nó expandido
L Nível hierárquico do nó
C Nó selecionado com a seleção múltipla
Y Visibilidade do objeto filho ou objetos filhos do nó
FNP Valor da propriedade FriendlyNameProperty
FTP Valor da propriedade FriendlyTipProperty
Para um melhor desempenho do objeto hpTreeView, recomenda-se configurar o valor da propriedade

XMLTemplate com o valor 5 (cinco). A tabela a seguir contém a descrição dos parâmetros adicionados ao código
XML resultante.
Parâmetros adicionais compatíveis com o objeto hpTreeView para XMLTemplate igual a 5 (cinco)
S Nó selecionado
E Nó expandido
L Nível hierárquico do nó
C Nó selecionado com a seleção múltipla
Y Visibilidade do objeto filho ou objetos filhos do nó
CMP Armazena, de forma conjunta, o valor dos parâmetros

usados pelo objeto hpTreeView
5.14.1.7 Compatibilidade com o Objeto hpLyraMenu

Configure o valor da propriedade XMLTemplate com o valor 2 (dois) a fim de gerar um código XML compatível com
um objeto hpLyraMenu. A tabela a seguir contém a descrição dos parâmetros adicionados ao código XML resultante.
Objetos 206
Parâmetros adicionais compatíveis com o objeto hpLyraMenu
PARÂMETRO PROPRIEDADE DESCRIÇÃO

S StartScreen Tela inicial
CO scrContent Tela a ser aberta no Quadro Content
FO scrFooter Tela a ser aberta no Quadro Footer
HE scrHeader Tela a ser aberta no Quadro Header
LE scrLeft Tela a ser aberta no Quadro Left
MA scrMaster Tela a ser aberta no Quadro Master
ME scrMenu Tela a ser aberta no Quadro Menu
RI scrRight Tela a ser aberta no Quadro Right
5.14.1.8 Compatibilidade com a Tela Faceplate

Configure o valor da propriedade XMLTemplate com o valor 3 (três) a fim de gerar um código XML compatível com
a Tela Faceplate. A tabela a seguir contém a descrição dos parâmetros adicionados ao código XML resultante.
Parâmetros adicionais compatíveis com a Tela Faceplate
AC Propriedade Acronym do objeto Proteção
C Propriedade Caption
COP Propriedade ComparisonOperator do objeto

PowerInterlockUnit
CVC Propriedade ComparisonValueCaption do objeto

PowerInterlockUnit
EP Propriedade ElectricalPhase do objeto Proteção
F Propriedade FaceplateTemplate
IMS Propriedade IndexMultiState do objeto xfDiscreteInfo
M Propriedade Format
MS Propriedade MultiState do objeto xfDiscreteInfo
MSN Propriedade Name da Medida do objeto

PowerInterlockUnit
MSP Propriedade PathName da Medida do objeto

PowerInterlockUnit
OS Propriedade ShortName do objeto pai do objeto atual,

somente para objetos do Elipse Power
PN Propriedade Name do objeto pai do objeto atual,

somente para objetos do Elipse Power
207 Objetos
PPS Propriedade ShortName do objeto pai do objeto pai do
objeto atual, somente para objetos do Elipse Power
PT Resultado da função TypeName do VBScript do objeto

pai do objeto atual, somente para objetos do Elipse
Power
S0 Propriedade StateText0
SN Propriedade ShortName, somente para objetos do

Elipse Power
TV Propriedade TextValue dos objetos filhos do objeto

xfDiscreteInfo
VC Propriedade ValueCaption
5.14.1.9 Compatibilidade com a Função de Navegação

Configure o valor da propriedade XMLTemplate com o valor 6 (seis), a fim de gerar um código no formato XML
compatível com a função de navegação. A tabela a seguir contém a descrição dos parâmetros adicionados ao código
no formato XML resultante.
Parâmetros adicionais compatíveis com a função de navegação

MNID Valor calculado Identificador do monitor, configurado
no objeto hpNavMonitor
START StartupTemplateName Template de inicialização,

configurado no objeto
hpNavMonitor
CAPTION Valor calculado Legenda para navegação histórica,

configurada no objeto hpNavProfile
TIMESTAMP Valor calculado Chave primária para navegação

histórica, configurada no objeto
hpNavProfile
DVC AuthorizedComputers Lista de computadores autorizados a

acessar o perfil de navegação,
configurada no objeto hpNavProfile
MTRX MonitorsMatrix Matriz de monitores, configurada no

objeto hpNavProfile
VH ViewerHeight Altura do Viewer, em pixels
VW ViewerWidth Largura do Viewer, em pixels
Objetos 208
SCR SplitLink Link de abertura de Tela, configurado
no objeto hpNavFrameSet
SPVL SplitValue Valor do Divisor, configurado no

objeto hpNavFrameSet
RAW RawFrame Nome do FrameSet adaptativo,

hpNavFrameSet
ARG Valor calculado Argumento de abertura de Tela,

hpNavFrameSet
5.15 Logs
Esta seção contém informações sobre os objetos do tipo Log na Biblioteca HighPerformance Template.
5.15.1 hpLogEvent
O objeto hpLogEvent processa mensagens para registrá-las, de forma padronizada, no arquivo de logs do Elipse E3
ou Elipse Power, ou exibi-las em tela.
NOTA
Para mais informações sobre a configuração e funcionamento deste objeto, consulte o tópico Logs.
A tabela a seguir contém as propriedades do objeto hpLogEvent.
Propriedades do objeto hpLogEvent
hpLogParams Lista dos parâmetros de configuração. Para mais
informações sobre os parâmetros, consulte o tópico
Logs
RegisterLevel Número do nível inferior de mensagens a serem

processadas. Os valores possíveis são 0: Trace, 1: Debug,
2: Info, 3: Warn, 4: Error ou 5: Fatal
209 Objetos
CAPÍTULO
Novidades de Versão
6
Esta seção contém os pré-requisitos e as novidades da versão 2.5 da Biblioteca HighPerformance Template.
6.1 Pré-Requisitos
Este tópico contém informações sobre os principais pré-requisitos para utilização da Biblioteca HighPerformance
Template, conforme a tabela a seguir.
Pré-Requisitos
RECURSO DEPENDÊNCIA VERSÃO

Pacotes de bibliotecas usados pela Implementado sistema de pacote de Elipse Power ou Elipse E3 versão
Aplicação de Demonstração bibliotecas no Elipse E3 e Elipse 5.1.109
Power
Objeto E3Alarm sensível aos Temas Implementada uma forma de Elipse Power ou Elipse E3 versão
configurar as cores para os diversos 4.8.265
estados de alarme e severidade via
script
Objeto hpLyraMenu Criado um novo ElipseX, o XFolder, Elipse Power ou Elipse E3 versão
um objeto de servidor que permite a 4.8.58
livre inserção de objetos filhos
apenas em suas instâncias
Dimensionamento automático de Criados os métodos GetScreen no Elipse Power ou Elipse E3 versão

janelas pop-ups e modais Viewer e ShowScreen no Divisor, 4.7.78
para abertura de Telas modificadas
em tempo de execução
Objetos de texto com a propriedade Criados os métodos GetScreen no Elipse Power ou Elipse E3 versão
Behaviour configurada para 1: Viewer e ShowScreen no Divisor, 4.7.78
ScreenTitle para abertura de Telas modificadas
Indicadores de alarmes Criado o objeto AlarmFilter Elipse Power ou Elipse E3 versão

4.7.96
Histórico de navegação e objeto Criados os métodos GetScreen no Elipse Power ou Elipse E3 versão
hpScreenNav Viewer e ShowScreen no Divisor, 4.7.78
para abertura de Telas modificadas
6.2 Versão 2.5 Build 74

Esta seção contém as novidades da versão 2.5.74 da Biblioteca HighPerformance Template.
6.2.1 Novas Implementações

Esta seção contém as novas implementações da versão 2.5.74 da Biblioteca HighPerformance Template.
6.2.1.1 Alarmes
· Implementado o suporte à severidade Crítica.
Novidades de Versão 210

· Alterado o valor padrão da propriedade EnableClick dos objetos hpAlarmIndicator[Type].
· Criado o objeto E3AlarmToolbarV2, compatível com alarmes de severidade Crítica. O objeto E3AlarmToolbar foi
descontinuado.
6.2.1.2 Aplicação de Demonstração

· Removidos os links diretos nos objetos CustomDisplay1 e CustomDisplay2 da Biblioteca Custom.lib e
implementados links configurados pela propriedade DataObject.
· A Aplicação de Demonstração foi adequada aos novos temas.
· Atualizada a Biblioteca Scheduling.
6.2.1.3 Extensões
· Criada uma interface de pré-visualização de grade nos objetos hpXGridCalc e hpXContainer.
· Implementado um recurso de controle de autorização por estação na Biblioteca Extensions da Biblioteca

HighPerformance Template. Criado o objeto hpXAuthorization.PlantModel, atualizado para a versão 1.0.2.
· Criado um Botão de Comando hpXPowerCommandButton para operar objetos do Elipse Power a partir da Tela
Faceplate, que recebeu atualizações para possibilitar o uso deste novo Botão.
· Incluído o Manual do Usuário da Biblioteca PlantModel.
· Implementadas colunas secundária e terciária nos objetos hpXContainer e hpXGridCalc, através das propriedades
CellWidthSecondaryColumn e CellWidthTertiaryColumn.
· Especificada a unidade Himetric no texto de ajuda das propriedades de medida dos objetos hpXGridCalc e
hpXContainer.
· Revisados todos os textos de ajuda dos objetos da Biblioteca Extensions.
· Removidos objetos espúrios da pasta hpXObjects.
6.2.1.4 Faceplate
· A Tela Faceplate, junto com a Biblioteca Extensions, recebeu adequações para poder ler e exibir corretamente a
estrutura de dados da Biblioteca FlexControl.
· A Tela Faceplate teve a estrutura interna simplificada visando a integração com a Biblioteca FlexControl, maior
facilidade para manutenção e melhor desempenho.
· Atualizados os scripts das Telas Faceplate e Interlocks para uso de XML. Adicionalmente o objeto
hpXInterocksConfig ganhou a propriedade UseShortNames, e o XML para Faceplate recebeu novos parâmetros.
· Implementada compatibilidade da Tela Faceplate com objetos do Elipse Power. A Tela Interlocks teve o argumento
unificado tanto para objetos HighPerformance padrão ou extensão como para objetos do Elipse Power. O objeto
hpXProtection foi atualizado. Criados os objetos hpXPowerCommandButton e hpXPowerDynValueAnalog,
exclusivos para objetos do Elipse Power. Diversos ajustes e melhorias na Tela Faceplate.
· Criada uma condição que torna opcional a declaração de tip para grupos Custom no objeto
hpXFaceplateTemplate.
· Implementada a checagem de limites de valores nos controles associados a objetos do tipo xfParameter na Tela
Faceplate.
· Implementada a visualização da aba Status da Tela Faceplate por grupos MultiState.
· A largura da Tela Faceplate passou a ser calculada automaticamente com base no conteúdo da aba que está aberta.
Foram corrigidos erros, os códigos padronizados e melhorado o desempenho de abertura da Tela. O
comportamento da aba Protections foi alterado para seguir o padrão usado nas demais abas. O objeto
211 Novidades de Versão

~hpEventBridge recebeu as propriedades numColumnsNormal[Tab], dimGroupProtections3 e MultiState[Tab].
Os objetos hpXGridCalc e hpXContainer receberam a propriedade ContentRightEdge. O objeto ~hpXProtection
foi atualizado para ser compatível com esta implementação. O objeto ~hpXFaceplateConfig recebeu a
propriedade MarginRight.
· Implementado um modo de visualização por colunas das abas Discrete e Commands na Tela Faceplate.
· Melhorada a usabilidade para configurar o tamanho da grade de elementos na Tela Faceplate.
· Implementado um recurso de personalização dos objetos de Tela associados a dados para as abas nativas da Tela
Faceplate.
· Refeita a impressão de log contendo o código XML lido pela Tela Faceplate.
· Implementada uma opção para que a Tela Faceplate não exiba nenhum ícone de equipamento.
6.2.1.5 Formulários
· Padronizado o tamanho de textos nos objetos da Biblioteca hpForms.
· Criado objeto hpTabsBar que monta dinamicamente um menu de abas, tanto na orientação horizontal como na
vertical. Com isto os objetos hpTabBarHorizontal e hpTabBarVertical estão descontinuados.
6.2.1.6 Ícones
· Implementados os ícones hpIconAnalogInput, hpIconAnalogOutput, hpIconBinaryInput e hpIconBinaryInput na
Biblioteca hpIcons.
6.2.1.7 Menus e Navegação

· Implementados badges nos objetos hpLinkDetail, hpLinkIcon e hpLinkMain.
· Implementado um tip no objeto hpLyraMenu.
· Implementado suporte a tradução para tips no objeto hpLyraMenu.
· Criada a Biblioteca hpNavigationStruct com objetos de estrutura de dados de navegação. A Biblioteca Utilities
recebeu a implementação de um objeto que converte a estrutura de dados antiga para a nova.
· O repositório de Quadros foi atualizado com as implementações da nova função de navegação.
· O objeto hpPopupOpen foi adequado ao uso de múltiplos monitores. O objeto hpPopupTemplate recebeu
melhorias nos textos de ajuda.
· Implementado o objeto hpAccordion.
· Implementada a abertura de Quadro personalizado em um Template de navegação já existente.
6.2.1.8 Miscelânea
· Implementada a compatibilidade entre a Biblioteca HighPerformance Template e a Biblioteca FlexControl.
· Criada uma estrutura de sinalização e log padronizados.
· Criado o marcador de nome '~' para possibilitar a identificação dos objetos de uso exclusivo interno da Biblioteca
HighPerformance Template: ~hpScrollBar, ~hpSearchBox, ~hpTVArrow, ~hpTVLine, ~hpLyraMenuL1,
~hpLyraMenuL2, ~hpXProtection, ~hpXCollapseExpand, ~hpXEventBridge, ~hpXFaceplateConfig,
~hpXFaceplateVars, ~hpXInterlocksConfig e ~hpXLinkBridge. O objeto DataObjectBridge foi renomeado para
hpXDataObjectBridge.
· As Telas Faceplate e Interlocks foram adequadas ao novo padrão de logs e sinalizações da Biblioteca

· Criada a Biblioteca hpUtilities.
· Atualizada a documentação das propriedades EnableClick e EventClick para um melhor entendimento do

funcionamento.
· Removidos os objetos e propriedades descontinuados na versão 2.0 da Biblioteca HighPerformance Template.
6.2.1.9 Módulo XML

· O objeto hpXMLCatalog agora aceita XFolders cujo tipo seja diferente de xfPlantFolder.
· Implementada pesquisa exata nos filtros do objeto hpXMLCatalog.
· Implementada a opção de leitura das propriedades IconGallery e IconName para configuração do campo ícone
(parâmetro I) no objeto hpXMLCatalog quando a propriedade XMLTemplate é igual a 1 (um, TreeView).
· Atualizada a lista de atributos XML, xfFCDigitalPos e xfFCParameter, para a Biblioteca FlexControl. Os objetos
hpXMLCatalog e hpXMLCatalogV2 receberam esta atualização.
· Alterado o valor padrão da propriedade GetAllChildren do objeto hpXMLCatalog para Verdadeiro.
· Implementado o parâmetro User no código XML gerado para Template FlexControl no objeto hpXMLCatalog.
· Criado o Template XMLTemplate 6 para navegação.
· Implementada, no objeto hpXMLCatalog, a configuração do parâmetro C, para a propriedade XMLTemplate igual

a 1 (um) ou 5 (cinco), através do valor de uma propriedade declarada pelo usuário na propriedade ExtraProperties.
· As propriedades GetAllChildren e ShowRootFolder do objeto hpXMLCatalog deixaram de ter o preenchimento

obrigatório para a propriedade XMLTemplate igual a 3 (três, Tela Faceplate). Os valores agora são ajustados
automaticamente pela função para este valor da propriedade XMLTemplate.
· O objeto hpXMLCatalog foi otimizado internamente para melhor desempenho.
· Implementada a propriedade CustomParameters no objeto hpXMLCatalog para configuração de parâmetros

personalizados com base em um valor padrão definido pelo usuário.
6.2.1.10 Multi-Monitores
· Implementada uma nova função de navegação e configuração de monitores.
· Implementados os arranjos de matriz de monitores 2x1, 2x4, 2x5, 2x6, 3x1, 3x3, 3x4, 3x5, 3x6, 4x1, 4x4, 4x5 e 4x6.
O arranjo 1x4 foi removido.
· Implementada uma função de navegação com Quadros adaptativos (Adaptive Frames).
· Implementado um comando nativo no Viewer para abrir janelas pop-up e modais (Tag OpenPopup).
· Criados os acessos ao Assistente de Configuração de Navegação 1: Automaticamente ao iniciar uma aplicação sem
perfil de navegação, 2: Através de link na Tela de Apresentação e 3: Através da propriedade Behaviour igual a 5
(cinco) nos objetos hpLinkIcon, hpLinkDetail e hpLinkMain.
6.2.1.11 Temas
· Implementada uma configuração dos Temas no Viewer através do Studio, usando o método CustomConfig.
· Implementado o objeto ~hpColorPaletteGenerator na Biblioteca hpUtilities.
· Redesenhada a função Temas, contemplando a criação dos objetos hpTheme, ~hpColor, ~hpColorPalette,
~hpThemePublisher e hpThemePicker, além do Tag loadTheme na pasta Template do Viewer. Adicionalmente,
foram atualizados os objetos hpLinkToggleIcon, hpLyraMenu, ~hpLyraMenuL1 e ~hpLyraMenuL2.

· Criados os Temas Amethyst, Copper, Forest, Grayscale, IndianRed, Iris, MidnightBlue, Olive, PinkRed,
PurpleStar, Sage, SeaGreen e Teal.
· Implementada uma interface para o Theme Factory na Tela hpThemeConfig, com acesso através do menu de
seleção do objeto hpThemePicker.
6.2.1.12 Tradução
· Implementado um recurso que permite iniciar o Viewer com um idioma diferente do padrão.
· Padronizado o comportamento do modo extendido de tradução (XM) nos objetos hpLyraMenu e hpTreeView.
6.2.1.13 TreeView
· Implementadas denominação e dica (tip) amigáveis para os nós do objeto hpTreeView.
· Implementado um recurso que permite carregar, no objeto hpTreeView, valores pré-definidos para as caixas de
seleção múltipla.
· Removida a propriedade SelectionResetOnSourceChange do objeto hpTreeView.
6.2.1.14 Visualização de Dados

· Foi excluído o arquivo hpEPMChart.lib da distribuição da Biblioteca HighPerformance Template, incluindo os
objetos descontinuados hpChartFull, hpChartGroup, hpChartPen e os recursos imgChart e imgPen.
· Os objetos hpBarGraphAlarmLimHorizontal e hpBarGraphAlarmLimVertical tiveram as propriedades

UseXChartColor e XChartColor descontinuadas. No lugar foram criadas as propriedades UseCustomColor e
CustomColor, respectivamente, possuindo a mesma funcionalidade das anteriores.
6.2.2 Problemas Resolvidos

Esta seção contém os problemas resolvidos na versão 2.5.74 da Biblioteca HighPerformance Template.
6.2.2.1 Alarmes
· Corrigido o endereçamento interno nos objetos indicadores de Alarmes hpAlarmIndicatorAnalog,
hpAlarmIndicatorDeadBand, hpAlarmIndicatorDigital, hpAlarmIndicatorDiscrete, hpAlarmIndicatorGeneric e
hpAlarmIndicatorROC. Com esta correção estes objetos passaram a ser compatíveis com a modelagem de dados
da Biblioteca PlantModel.
· Corrigido um erro na posição das Áreas de Alarme para as severidades Lo e LoLo nos objetos
hpBarGraphAlarmZoneVertical, hpBarGraphAlarmZoneVerticalIO e ~hpCombinedBarLineGraph.
· Corrigida a indicação de severidade de Alarme na propriedade RetSeverity dos objetos indicadores de Alarme.
· Corrigido um erro em que as Zonas de Alarme do objeto hpBarGraphAlarmZoneVertical não eram exibidas
corretamente.

Corrigido um erro que causava um posicionamento incorreto no objeto hpLyraMenu, bem como um posicionamento
incorreto de ícone nos objetos hpLinkDetail, hpLinkIcon e hpLinkMain.
6.2.2.3 Extensões
· Implementada a compatibilidade com caracteres acentuados para o tip de grupos Custom declarados na
propriedade PopupCode do objeto hpXFacepltateTemplate.
· Criada a propriedade EnableLimits nos objetos hpManualValue, hpManualValueIO e hpXManualValueIO e

criadas as propriedades MaxLimit e MinLimit no objeto hpManualValue.

· Corrigido um erro de script que ocorria nos objetos hpXGridCalc e hpXContainer ao configurar o valor das
propriedades Rows ou Columns sem executar o comando Config após a configuração.
· A propriedade SwapMode do objeto ~hpXCollapseExpand foi descontinuada.
6.2.2.4 Faceplate
· Corrigido um erro em que a configuração de nome inválido para o ícone de equipamento no objeto
hpXFaceplateTemplate gerava um erro de script ao abrir a Tela Faceplate.
· Corrigido um erro em que um Setpoint em modo de edição permanecia visível após a troca de aba na Tela
Faceplate.
· Corrigido um erro de posicionamento dos Botões de Comando na aba Commands da Tela Faceplate.
· Implementada uma verificação que corrige parâmetros, coringas e modificadores redundantes na declaração da
propriedade PopupCode no objeto hpXFaceplateTemplate.
· Corrigido um erro no objeto hpComboBox em que não ocorria a seleção se houvesse apenas um item cadastrado.
· Corrigido o valor do parâmetro H no código XML gerado pelo objeto hpXMLCatalog.

· Corrigido um erro de script que ocorria na abertura de janelas pop-up com configuração inválida do link para o
respectivo objeto hpPopupTemplate.
· Corrigido um erro de script ao tentar carregar uma Tela inexistente na inicialização do Viewer. Adicionalmente foi
implementada uma verificação com sinalização e registro em log de todos os endereços iniciais cadastrados no
Viewer.
· Implementado um limite para a coordenada Y dos objetos L2 do objeto hpLyraMenu de forma que, mesmo que
seja especificado um valor maior na propriedade ShiftL2 dos objetos hpNavData, nenhum objeto L2 é posicionado
acima do objeto hpLyraMenu. A propriedade ShiftL2 não mais aceita números menores do que 0 (zero). A
atualização do ícone dos objetos L1 teve a condição de disparo otimizada. O recurso AutoScale foi corrigido e
passou a funcionar normalmente nos objetos L1.
· Corrigidos erros que ocorriam na atualização da versão 2.0 para 2.5 da Biblioteca HighPerformance Template.
Erro na tratativa de perfis de navegação com caracteres especiais no nome. Erro na tratativa de valor vazio na
propriedade StartupTemplateName do objeto hpNavMonitor. Erro no manejo dos registros históricos de
navegação ao abrir Perfil, Perfil histórico e Template. Os objetos corrigidos são hpNavProfile, Tag loadProfile, Tag
OpenEntity, hpLyraMenu, hpLabel0, hpLabel1, hpLabel2 e hpScreenNav.
· Corrigido um erro em que o objeto hpTreeView exibia uma mensagem de erro em um nó não cadastrado no
dicionário, mesmo que a propriedade EnableTranslation esteja desabilitada. Este bug ocorria desde a v2.0.38.
6.2.2.7 Miscelânea
· Padronizado o tipo Integer para os valores de retorno dos Tags Internos que simulam Tags de comunicação na
aplicação de demonstração da Biblioteca HighPerformance Template para normalização de exibição na Tela
Interlocks. Adicionalmente os valores exibidos nesta Tela passaram a ser dinâmicos.
· O posicionamento de objetos criados dinamicamente foi adequado às correções implementadas no Elipse E3 ou

Elipse Power versão 6.0.
· Corrigido um erro no objeto hpPageReference em que os componentes internos não eram posicionados
corretamente após mover um objeto com o mouse no Studio.

6.2.2.8 Módulo XML
· Corrigido um erro que não permitia a atualização dinâmica do código XML pelo objeto hpXMLCatalog.
Adicionalmente a propriedade privada Run foi tornada pública.
· Corrigido um erro em que o objeto hpXMLCatalog aceitava caracteres inválidos e gerava código XML com erro de
formatação. Criada a propriedade InvalidCharReplacement no objeto hpXMLCatalog.
· Corrigido um erro no objeto hpXMLCatalog que causava erro ao processar um objeto de Alarme contendo um
Campo de Usuário herdado.
· Implementado o recurso de lista de caminhos na propriedade InitialPath do objeto hpXMLCatalog quando a

propriedade OutputMode é igual a 0 (zero).
6.2.2.9 Tradução
· Padronizado o comportamento do módulo de tradução ao buscar por um termo não cadastrado previamente no
dicionário. Atualizados os objetos hpTranslatorAddLinkXM, hpTreeView, hpLyraMenu, Tags loadProfile,
OpenEntity e InlineTranslation.
6.2.2.10 TreeView
· Corrigido um erro no objeto hpTreeView em que o texto dos nós poderia sofrer deslocamentos indevidos
conforme a posição na Tela.
· Corrigido um erro de posicionamento do objeto hpTreeView na Tela.
· O objeto hpTreeView foi internamente reestruturado e otimizado para melhor desempenho.
· Corrigido um erro que gerava erro de script ao carregar um segundo objeto hpTreeView usando a mesma fonte
de dados usada pelo primeiro objeto.

· Corrigido um erro de script no objeto hpLineChart que ocorria após uma troca dinâmica do objeto de dados.
6.2.3 Roteiro para Atualização

Este roteiro foi elaborado com base na atualização da aplicação demo da Biblioteca HighPerformance Template,
onde não há objetos de biblioteca ou scripts personalizados juntos aos objetos nativos que devem receber esta
atualização.
No entanto, em uma aplicação real que possua elementos personalizados juntos aos objetos nativos da Biblioteca
HighPerformance Template, deve-se atentar para que sejam salvos com segurança antes de executar este roteiro.
Ao término destas instruções, os objetos personalizados podem ser novamente incorporados na aplicação.
Para atualizar a Biblioteca HighPerformance Template versão 2.5 em uma aplicação que contém uma versão
anterior à versão 2.0.92, recomenda-se primeiro atualizar para a versão 2.0.92 para em seguida atualizar para a
versão 2.5.
Para atualizar a Biblioteca HighPerformance Template em uma aplicação que contém a versão 2.0.92, proceda
conforme os tópicos a seguir.
6.2.3.1 Atualização Mínima

Os passos indicados neste tópico são necessários para a atualização da versão 2.5 mínima da Biblioteca
6.2.3.1.1 Operações com Arquivos
1. Atualize o arquivo do pacote de bibliotecas Libraries.e3pkg na pasta HighPerformance/Libraries.

2. Atualize o arquivo Dictionary.csv na pasta HighPerformance/Dictionaries.
3. Atualize o arquivo do repositório de Quadros hpFrames_Repository.prj na pasta HighPerformance/Projects.
6.2.3.1.2 Operações com Objetos
Os itens a seguir realizam a manipulação de objetos no Studio.
1. No Studio, abra a aplicação a ser atualizada.
2. Certifique-se de que o arquivo do pacote de bibliotecas Libraries.e3pkg foi adicionado ao Domínio. Caso
contrário, adicione-o.
3. Sem adicionar ao Domínio, abra o arquivo hpMain.prj da versão 2.5.
6.2.3.1.3 Função Logs
1. Copie a pasta hpObjects/Log da versão 2.5 para o mesmo caminho na aplicação.
2. Copie a pasta Viewer/hpControls/Log da versão 2.5 para o mesmo caminho na aplicação.
6.2.3.1.4 Formulários
Para usar os novos formulários dentro da função antiga de Temas, é necessário corrigir a cor de textos e marcadores.
Caso utilize os novos Temas, ignore estes passos.
1. Selecione o objeto Scheme01 em hpObjects - Theme01.
2. Altere o valor da propriedade ColorFormText para o valor RGB(0, 0, 0).
3. Repita este procedimento para os demais objetos Scheme instanciados na mesma pasta.
6.2.3.1.5 Tela hpDateTimePicker
1. Substitua a Tela hpDateTimePicker da versão 2.5, localizada na pasta hpScreens, para o mesmo caminho na
aplicação.
6.2.3.1.6 Objeto hpTranslatorController
1. Clique com o botão direito do mouse no objeto hpTranslatorController em hpObjects - Translator na aplicação
e selecione a opção Configurar.
2. Caso a propriedade ImportStatus do objeto sinalize o valor -1 (menos um, erro), configure a propriedade
Dictionary com o caminho completo do arquivo, como por exemplo "C:
\App\HighPerformance\Dictionaries\Dictionary.csv".
3. Copie a pasta Viewer/hpControls/Translator da versão 2.5 com todo o conteúdo para o mesmo caminho na
aplicação.
6.2.3.1.7 Objeto Viewer
1. Substitua o script do evento OnStartRunning do objeto Viewer da aplicação pelo novo script da versão 2.5.
2. No caso de atualizar os Temas para a nova função, substitua toda a pasta Viewer/hpControls/Template da
aplicação pela mesma pasta da versão 2.5. Para manter a função antiga de Temas, ignore este passo.
6.2.3.1.8 Código XML
Atualize todos os códigos XML gerados pelos objetos hpXMLCatalog na aplicação. A pasta padrão destes objetos
está em hpObjects - XML.
1. Clique com o botão direito do mouse em cada um destes objetos e selecione a opção Configurar.

6.2.3.2 Função de Navegação
Na versão 2.5 a função de navegação foi totalmente reformulada. Caso queira manter a função de navegação antiga,
ignore este tópico.
3. Sem adicionar ao Domínio, abra o arquivo hpFrames_Repository.prj, versão 2.5, e acesse a pasta
hpFrames_v2.5_Adaptive.
6.2.3.2.2 Quadros
1. Atualize os Quadros existentes na pasta hpFrames da aplicação conforme indicado na tabela a seguir. Não é
necessário alterar internamente nenhum Quadro, apenas o nome.
Quadros na pasta hpFrames
QUADROS LOCAL NA APLICAÇÃO LOCAL NO ARQUIVO

HPFRAMES_REPOSITORY.PRJ
hpInitialFrame hpFrames\ hpFrames_v2.5_Adaptive\
hpFrameHeader01, hpFrames\ hpFrames_v2.5_Adaptive\

hpFrameSingle01, etc.
hpInitialFrame1x1, hpFrames\ MatrixTemplates hpFrames_v2.5_Adaptive\
hpInitialFrame1x2, etc. MatrixTemplates
2. Feche o arquivo hpFrames_Repository.prj, versão 2.5.
6.2.3.2.3 Tela HighPerformanceScreen
1. Copie ou substitua a Tela HighPerformanceScreen da aplicação pela mesma Tela da versão 2.5 no mesmo
caminho na aplicação.
6.2.3.2.4 Tela hpNavConfig
1. Copie a Tela hpNavConfig da versão 2.5, localizada na pasta hpScreens, para o mesmo caminho na aplicação.
6.2.3.2.5 Estrutura de Dados
1. Expanda a pasta hpObjects - Navigation, versão 2.5.
2. Copie a pasta Profiles da versão 2.5 para o mesmo local na aplicação.
3. Certifique-se de que não exista nenhum conteúdo dentro da nova pasta Profiles na aplicação. Caso exista, este
deve ser removido.
6.2.3.2.6 Código XML
1. Expanda a pasta hpObjects - XML, versão 2.5.
2. Copie o objeto hpXMLCatalog_Navigation para o mesmo local na aplicação.

6.2.3.2.7 ScreenTemplates
1. Expanda a pasta hpObjects - ScreenTemplates, versão 2.5.
2. Copie o objeto NavigationConfig para o mesmo local na aplicação.
6.2.3.2.8 Viewer
1. Substitua a pasta Viewer - hpControls - Navigation da aplicação pela mesma pasta da versão 2.5.
6.2.3.2.9 Configurando a Navegação
2. Na janela Navigation Setup Wizard, selecione a opção Criar novo perfil.
3. Digite um nome para o novo perfil de navegação e clique em Save para criar um perfil minimamente executável.
4. Na aba Template do Template Editor, clique no ícone do lápis no quadro central e verifique que o campo
SplitLink já vem carregado com o valor da Tela de demonstração.
5. A partir deste ponto podem ser adicionados Quadros, Templates e Monitors com os valores de navegação já
usados na aplicação.
6. Ao término da configuração, clique em Save para salvar as configurações.
7. Após salvas as configurações, feche o Assistente e, em seguida, o Viewer.
8. No Organizer do Studio, clique com o botão direito do mouse no projeto HpMain e selecione a opção Atualizar
para que as alterações realizadas no Assistente possam ser visualizadas no ambiente de edição do Studio.
9. Selecione a pasta hpObjects - Navigation - Profiles e certifique-se que os dados criados correspondem
exatamente à configuração salva no Assistente.
NOTAS
· Nesta estrutura de dados, os objetos hpNavTemplate possuem a propriedade PanelsConfig, cujo valor é
configurado automaticamente pelo Assistente. Caso seja realizada alguma alteração na estrutura de dados sem
passar pelo Assistente, o valor desta propriedade pode estar defasado. Para corrigi-lo, execute o Viewer e abra o
Assistente, que se encarrega de atualizar o valor automaticamente.
· Alguns links da versão antiga de navegação podem não funcionar na nova versão. Consulte o tópico Abrindo uma
Entidade de Navegação para mais informações sobre como configurar os links na nova função de navegação.
· Para mais informações, siga a orientação de configuração do tópico Exemplo de Configuração.
6.2.3.3 Função Temas

Na versão 2.5 a função Temas foi totalmente reformulada. No entanto, é possível escolher entre usar a função antiga
de Temas ou usar a nova função.
6.2.3.3.2 Mantendo a Função Antiga de Temas
Para manter e usar a função antiga de Temas, execute os procedimentos a seguir.

1. Expanda a pasta hpObjects - Theme01 na aplicação.
2. Clique com o botão direito do mouse em qualquer objeto Scheme e selecione a opção Configurar.
6.2.3.3.3 Atualizando a Função de Temas
Para atualizar e usar a nova função de Temas, execute os procedimentos a seguir.
Atualizando o Viewer
1. Certifique-se de substituir a pasta Viewer - hpControls - Template da aplicação pela mesma pasta da versão 2.5,
conforme indicado no tópico Atualização Mínima.
Atualizando a Estrutura de Objetos e Publicando os Temas no Viewer
1. Copie a pasta hpObjects - Themes da versão 2.5 para o mesmo caminho na aplicação.
2. Clique com o botão direito do mouse no objeto ~hpThemePublisher em hpObjects - Themes da aplicação e
selecione a opção Configurar. Ao final da configuração é exibida uma janela indicando o sucesso da operação.
Atualizando a Tela do Assistente de Configuração de Temas (Theme Factory)
1. Expanda a pasta hpObjects - ScreenTemplates, versão 2.5.
2. Copie para o mesmo local na aplicação o objeto ThemeFactory.
3. Copie a Tela hpThemeConfig da versão 2.5, localizada na pasta hpScreens, para o mesmo caminho na aplicação.
Incluindo o Picker dos Temas
1. Abra a Tela onde vai ser realizada a seleção dos Temas pelo usuário.
2. Instancie nesta Tela um objeto hpThemePicker, localizado na biblioteca hpForms.
Usando os Temas pela Primeira Vez
1. Execute o Viewer.
2. Acesse a Tela onde foi instanciado o objeto hpThemePicker.
3. Clique na seta à direita no objeto para selecionar um dos Temas disponíveis.
4. Em seguida, clique no botão à esquerda no objeto para alternar entre os Modos Claro e Escuro do Tema
escolhido.
NOTA
Se o valor da propriedade ShowThemeFactoryLink é igual a Verdadeiro, é exibido um link para acessar o Assistente
de Configuração de Temas. Este recurso não funciona se a aplicação utilizar a função de navegação anterior à versão
2.5. Para este caso, é preciso configurar manualmente o link para abertura da Tela pop-up em hpScreens -
hpThemeConfig usando o Template ThemeFactory na pasta hpObjects - ScreenTemplates.

6.2.3.4 Telas Faceplate e Interlocks
Realize o roteiro abaixo caso use as Telas Faceplate e Interlocks.
6.2.3.4.1 Operações com Arquivos
1. Atualize o pacote de bibliotecas Extensions.e3pkg na pasta HighPerformance/Libraries.
2. Atualize o arquivo hpXMain.prj na pasta HighPerformance/Projects.
2. Certifique-se de que o pacote Extensions.e3pkg foi adicionado ao Domínio. Caso contrário, adicione-o.
3. Certifique-se de que o arquivo hpXMain.prj foi adicionado ao Domínio. Caso contrário, adicione-o.
Configurações Iniciais
1. Abra o Manual do Usuário da Biblioteca HighPerformance Extensions.
2. Siga as orientações no tópico Tela Faceplate.
6.2.3.5 Navegação do Objeto hpLyraMenu

Realize o roteiro a seguir no caso de utilizar o objeto hpLyraMenu.
2. Substitua as estruturas de dados construídas com o objeto hpNavData pelo objeto hpLyraData automaticamente.
Para isto, consulte o tópico Migrando uma Estrutura de Dados para o Objeto hpLyraData.
6.3 Versão 2.0 Build 88

Esta seção contém as novidades da versão 2.0.88 da Biblioteca HighPerformance Template.
6.3.1 Novas Implementações

Esta seção contém as novas implementações da versão 2.0.88 da Biblioteca HighPerformance Template.

· Corrigida a descrição do comando Desabilitar Bomba na caixa de diálogo de comandos de bomba da Tela
Tratamento de Água da aplicação de demonstração.
· Atualizada a biblioteca pmBasic.lib na aplicação de demonstração.
· Disponibilizado nativamente o Tag Interno CurrentTime nos arquivos de distribuição da Biblioteca

HighPerformance Template para uso dos objetos hpDateTimeDisplay1 e hpDateTimeDisplay2.
· Executada uma tratativa de erro de script no Tag manageTitle caso não encontrasse a Tela informada pelo usuário
em scrContent. Adicionalmente os quadros hpFrameHeader01 e hpFrameHeaderMenuLeft01 foram mantidos na
pasta hpFrames, em virtude de compatibilidade com a documentação da Biblioteca HighPerformance Template.

· Corrigidos diversos erros de baixa severidade na aplicação de demonstração.
· Criada a propriedade Format no objeto hpDateTimeCombo. A Tela Formulários da aplicação de demonstração foi
atualizada com esta nova propriedade.

· O objeto hpPageReference foi realocado para a biblioteca hpMenus. O objeto hpPageReference, da biblioteca
hpDisplayMedia, foi descontinuado. A indicação do valor máximo da propriedade Size, na Tela Meios de
Visualização, foi corrigida para o valor 8 (oito).
· Implementada uma opção que permite usar o recurso de títulos automáticos de Tela sem qualquer dependência do
módulo Translator.
6.3.1.4 Miscelânea
· Atualizado o tópico com o roteiro para importação da Biblioteca HighPerformance Template no Manual do
Usuário da Biblioteca HighPerformance Template.
· Criada a Tela HighPerformanceScreen, na raiz do arquivo hpMain.prj de distribuição, que teve algumas
configurações ajustadas para que possa abrir a nova Tela quando a Biblioteca HighPerformance Template é
importada para uma nova aplicação.
· Adicionado um texto sobre compatibilidade de versões na nota ao final do tópico Instalação da Biblioteca em
uma Aplicação do Manual do Usuário da Biblioteca HighPerformance Template.
· Implementada uma melhoria de compatibilidade na função de títulos automáticos.
· Implementadas bibliotecas para integração da Biblioteca HighPerformance Template com a Biblioteca

PlantModel.
· A aplicação de demonstração teve os dados remodelados dentro do padrão Plant Model, incluindo a
implementação das Telas Faceplate e Interlocks, totalmente integradas a este padrão.
· O objeto hpXMLCatalog foi atualizado para maior integração com objetos da Biblioteca PlantModel.
· A estrutura de pastas e arquivos sofreu alterações para permitir a inclusão dos novos arquivos de extensões da
Biblioteca HighPerformance Template, bem como os arquivos da Biblioteca PlantModel.
· Adicionado um tópico no Manual do Usuário da Biblioteca HighPerformance Template com informações sobre
Associações inválidas.
· Atualizada a biblioteca pmBasic.
· Atualizado o tópico Parâmetros Personalizados do Manual do Usuário da Biblioteca HighPerformance

Template.
6.3.1.5 Módulo Translator

· Atualizado o arquivo de dicionário com o termo "Desabilitar Bomba".
· O dicionário da aplicação de demonstração passou a estar disponível nos arquivos de distribuição da Biblioteca
6.3.1.6 Módulo TreeView

· As propriedades de uso interno DataSourceChange e ResettingView foram tornadas privadas.
· Implementada uma opção que permite usar o objeto hpTreeView sem qualquer dependência do módulo
Translator.

· Implementada uma melhoria de desempenho gráfico no objeto hpTreeView.
· Implementadas novas sinalizações de erro no objeto hpTreeView.
· Corrigida a perda de configuração do código XML ao trocar dinamicamente a fonte de dados.
6.3.1.7 Módulo XML

· Criado um template de código XML para a Tela Faceplate no objeto hpXMLCatalog.
· O objeto hpXMLCatalog foi atualizado para trabalhar com objetos do Elipse Power.
· Implementado o gerenciamento de referências externas no objeto hpXMLCatalog usando a propriedade

XRefMode.
· Implementado um template para FlexControl no objeto hpXMLCatalog.
· Implementada a verificação de valor na propriedade XMLTemplate do objeto hpXMLCatalog.
6.3.2 Problemas Resolvidos

Esta seção contém os problemas resolvidos na versão 2.0.88 da Biblioteca HighPerformance Template.
6.3.2.1 Alarmes
· Corrigido um erro de sinalização de alarmes normalizados e não reconhecidos nos objetos
hpAlarmIndicatorAnalog, hpAlarmIndicatorDeadBand, hpAlarmIndicatorDigital, hpAlarmIndicatorDiscrete e
hpAlarmIndicatorROC. Estes objetos foram reformulados internamente e ganharam a propriedade AlarmServer.
Adicionalmente foi criado o objeto hpAlarmIndicatorGeneric, que pode ser usado no lugar destes indicadores
para qualquer tipo de alarme.
· Corrigido um erro em que os objetos indicadores de alarme ficavam invisíveis no Studio.

· Corrigido um erro na aplicação de demonstração com o objeto hpTreeView das Telas Agenda Geral e Agenda
Lista, em que era exibido indevidamente um nó sem tradução.
· Atualizada a biblioteca Scheduling para corrigir um erro de script que ocorre toda vez que é criado um novo
agendamento.
· Corrigido um erro de script que ocorria ao alternar entre as Telas Agenda Geral e Agenda Lista da aplicação de
demonstração com um nó selecionado no objeto hpTreeView.
· Correções gerais na aplicação de demonstração e nas bibliotecas, contemplando a remoção de Associações

inválidas e objetos sem uso.
· Corrigido um erro em que os objetos hpLinkDetail e hpLinkMain não exibiam o nome do tema selecionado, além
de não exibir o nome do idioma selecionado no caso do objeto hpLinkMain.
· Corrigidos os parâmetros dos objetos hpXMLCatalog para geração de código XML na aplicação de
demonstração.
· Corrigido um problema em que as dimensões dos objetos hpDateTimeDisplay1, hpDateTimeDisplay2,
hpSliderHorizontal e hpToggleButton se alteravam conforme novas instâncias destes objetos eram coladas em
Tela.
· Corrigido um erro que impedia dois ou mais objetos hpDateTimeCombo instanciados na mesma Tela de
funcionarem corretamente.

· Implementado o recurso de posicionamento automático de janelas pop-ups e modais nos objetos hpLinkIcon,
hpLinkDetail e hpLinkMain.
· Corrigido um erro que ocorria ao tentar abrir uma janela pop-up vazia, sem objetos instanciados, usando o recurso
AutoSize.
· Corrigido um erro em que o objeto hpLinkDetail não exibia corretamente o ícone quando a propriedade
AutoScale era igual a Verdadeiro.
6.3.2.5 Módulo Translator

· Corrigido um erro de script que ocorria quando a propriedade Definitions do objeto hpTranslationController
não era preenchida. Os objetos afetados são hpLinkDetail, hpLinkIcon, hpLinkMain, hpLyraMenu e hpTreeView,
assim como scripts e Tags em Viewer - hpControls - Translator.
· Corrigido um erro em que o objeto hpTranslatorAddLinkXM retornava um erro de script ao tratar um termo
contendo aspa simples.
6.3.2.6 Módulo TreeView

· Corrigido um erro de visualização do objeto hpTreeView, que ocorria na troca da fonte de dados com a
propriedade MultipleSelection habilitada e dois ou mais nós expandidos.
· Corrigido um erro no objeto hpTreeView em que o último nó deixava de ser exibido sempre que uma condição
específica ocorria ao se recolher a árvore com a barra de rolagem visível.
· Corrigido um erro que provocava o desalinhamento entre a barra de rolagem e o primeiro nó do objeto
hpTreeView. Em virtude desta implementação, foi eliminada a distorção de objetos ao alterar as dimensões.
Adicionalmente a barra de filtro foi redesenhada para refletir o valor configurado na propriedade TreeWidth.
· Corrigido um erro no objeto hpTreeView onde, ao abrir uma janela pop-up contendo este objeto, o foco era
erroneamente atribuído a um objeto auxiliar da caixa de filtro.
· Corrigido um erro onde a cor dos ícones nativos da Biblioteca HighPerformance Template não era alterada ao
alterar o valor da propriedade InvertColors.
· Corrigido um erro que impedia os ícones de serem exibidos corretamente nos nós do objeto hpTreeView.
· Corrigido um erro em que a barra de rolagem não era atualizada com o número total de nós a serem rolados no
objeto hpTreeView.
· Os objetos hpTreeView e hpTVLine foram otimizados para apresentar melhor desempenho.
· Corrigido um erro que impedia a visualização dos ícones no objeto hpTreeView.
6.3.2.7 Módulo XML

· Corrigido um erro em que um valor do tipo de dados Date era gerado no código XML em um formato diferente
do original.

· Corrigido um erro em que o valor da propriedade HideObjectName era incrementado com uma String de uso
interno a cada execução do objeto.

Matriz Filial em São Paulo
Rua Mostardeiro, 322/Cj. 902, 1001 e 1002 Rua dos Pinheiros, 870/Cj. 141 e 142
90430-000 — Porto Alegre — RS 05422-001 — São Paulo — SP
Fone: (+55 51) 3346-4699 Fone: (+55 11) 3061-2828
Fax: (+55 51) 3222-6226 Fax: (+55 11) 3086-2338
E-mail: elipse-rs@elipse.com.br E-mail: elipse-sp@elipse.com.br
Filial no Paraná Filial em Minas Gerais

Av. Sete de Setembro, 4698/1708 Rua Antônio de Albuquerque, 156/705
80240-000 — Curitiba — PR 30112-010 — Belo Horizonte — MG
Fone: (+55 41) 4062-5824 Fone: (+55 31) 4062-5824
E-mail: elipse-pr@elipse.com.br E-mail: elipse-mg@elipse.com.br
Filial no Rio de Janeiro Filial em Taiwan

Av. José Silva de A. Neto, 200/Bl. 4/ Sl. 109B 9F., No.12, Beiping 2nd St., Sanmin Dist.
22775-056 — Rio de Janeiro — RJ 807 — Kaohsiung City — Taiwan
Fone Comercial: (+55 21) 2430-5912 Fone: (+886 7) 323-8468
Suporte Técnico: (+55 21) 2430-5963 Fax: (+886 7) 323-9656
E-mail: elipse-rj@elipse.com.br E-mail: evan@elipse.com.br
Elipse Software Knowledgebase
Integradores Youtube
Treinamentos e Certificações Fórum
Documentação Online Ensino à Distância
Gartner, Cool Vendors in Brazil 2014, April 2014.

Gartner does not endorse any vendor, product or service depicted in its
research publications, and does not advise technology users to select only
those vendors with the highest ratings. Gartner research publications
consist of the opinions of Gartner’s research organization and should not
be construed as statements of fact. Gartner disclaims all warranties,
expressed or implied, with respect to this research, including any warranties
of merchantability of fitness for a particular purpose.

Highperformancemanual PTB

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Highperformancemanual PTB

Enviado por

Direitos autorais:

Formatos disponíveis

Manual

Copyright © 2014-2023 Elipse Software Ltda. Todos os direitos reservados.

· Biblioteca HighPerformance Template: Contém os conceitos básicos e fundamentais para o entendimento da

· Objetos: Contém descrições detalhadas de cada objeto da Biblioteca HighPerformance Template

· Aumento da consciência situacional do usuário

· Maior efetividade na prevenção de falhas e redução de erros operativos

· Maior acessibilidade para os portadores de daltonismo

· Maior facilidade e velocidade de desenvolvimento

2.1 Arquivos da Biblioteca

Grupos de arquivos disponíveis na Biblioteca HighPerformance Template

GRUPO ARQUIVOS DESCRIÇÃO

Imagens hpArchitecture2d.lib, Contém imagens, logotipos e ícones

Menus e Navegação hpMenus.lib, hpNavigation.lib e Contém objetos para composição de

Projetos hpMain.prj Contém objetos necessários para o

Quadros hpFrames_Repository.prj Repositório de Quadros à parte do

Temas hpThemes.lib Temas de cores

Biblioteca HighPerformance Template 2

Utilidades hpUtilities.lib Contém objetos auxiliares que visam

Viewer hpViewer.lib Configuração de matrizes de

Visualização de Dados hpDisplayMedia.lib, hpTexts.lib, Contém objetos de visualização de

XML hpXMLIndexer.lib Geração de conteúdo no formato

Estrutura de pastas e arquivos da Biblioteca HighPerformance Template

Dictionaries Arquivo no formato CSV (Comma-Separated Values) com

Extensions Arquivos de extensão da Biblioteca HighPerformance

Help Arquivos de ajuda da Biblioteca HighPerformance

Libraries Arquivos de biblioteca (com a extensão .lib) com as

Packages Pacote somente de leitura com as bibliotecas usadas na

PlantModel Arquivos da Biblioteca PlantModel

Projects Arquivos de projeto, com a extensão .prj, com as

3 Biblioteca HighPerformance Template

2.2 Instalação da Biblioteca em uma Aplicação Nova

2. Em seguida, no Studio, insira no Domínio o arquivo libraries.e3pkg da pasta HighPerformance/Packages e o

Tela inicial do Assistente de Navegação

Biblioteca HighPerformance Template 4

6. Execute as alterações que julgar necessárias, salve-as e feche o Viewer.

5 Biblioteca HighPerformance Template

2.3 Atualização da Biblioteca em uma Instalação Existente

2.4 Objetos Internos

2.5 Objetos com Temas Nativos

2.6 Associação de Valores a Objetos de Dados

Biblioteca HighPerformance Template 6

2.7 Execução de Scripts em Objetos Instanciados

Janela de criação de eventos de usuário

2.8 Acesso a Propriedades, Métodos ou Eventos Não

7 Biblioteca HighPerformance Template

Criação de um evento personalizado OnEventClick

Já o evento KeyDown retorna o código das teclas pressionadas, KeyCode e Shift.

2.9 Avisos na Execução de um Domínio

Biblioteca HighPerformance Template 8

Arquivos e objetos com avisos na execução do Domínio

Building.lib Luminaria e Compressor

Dosage.lib XCValve, XCMotor, XCElevator e XCElevatorBase

Sanitation.lib XCBomb, XCMixer e XCValveS

hpXMain.prj Tela Faceplate e Pasta hpData.View

Root_View.prj Telas Alarms, AlarmsConfig, TreeView, Forms, WindRose

2.10 Valores Recomendados de Zoom e Barra de Rolagem

Valores dos parâmetros de zoom e barra de rolagem

TIPO DE TELA PARÂMETROS RECOMENDADOS

Normal, aberta usando o método OpenScreen ?1?0

9 Biblioteca HighPerformance Template

1. Crie uma estrutura de navegação utilizando o Assistente de Configuração de Navegação.

3. Certifique-se de que o conjunto de Quadros reflete a configuração realizada na estrutura de navegação.

3.2 Menu Lyra