Os ElipseX são as Bibliotecas de objetos do E3. Podem conter, além de um desenho, variáveis internas passíveis de serem exportadas para a aplicação, além de lógicas de programação (scripts) presentes em todas as cópias do objeto criado, diminuindo a necessidade de repetição de código em diversas partes do aplicativo.
Os ElipseX permanecem encapsulados em um arquivo com extensão .lib. Pode-se criar todos os ElipseX que são utilizados em um determinado projeto no mesmo arquivo de Biblioteca (.lib) ou então dividir entre vários arquivos.
Para criar uma nova Biblioteca no E3, siga estes procedimentos:
1.Selecione o menu Arquivo - Novo Projeto e clique em Próximo.
2.Na opção Tipo de Aplicação, selecione a opção Biblioteca de componentes do E3.
Criação de uma biblioteca do usuário (ElipseX)
3.Digite um nome para a Biblioteca e clique em Avançar.
4.Configure as especificações referentes ao Domínio.
5.Clique em Concluir.
Dentro de uma Biblioteca ElipseX, pode-se inserir três tipos de objetos: os XControls, os XFolders e os XObjects.
Os seguintes itens podem ser inseridos em um XControl: primitivas de desenho (Retas, Retângulos, Círculos, etc.), objetos gráficos vetoriais, incluindo objetos da Biblioteca de símbolos (WMF, EMF, etc.), objetos gráficos não vetoriais (BMP, JPEG, GIF, etc.), controles ActiveX do E3 (E3Alarms, E3Browsers, E3Charts e E3Playbacks), controles ActiveX de terceiros, Consultas, Filtros de Alarmes, Impressoras de Linha e outros XControls.
Um XFolder é um objeto que permite inserir objetos filhos em suas instâncias. Desta forma é possível organizar ou criar hierarquias de objetos em uma aplicação. Pode-se inserir em instâncias de XFolders itens como Pastas de Dados, Tags de Comunicação, Consultas, Filtros de Alarmes e instâncias de XFolders e XObjects.
Já os XObjects podem conter quaisquer tipos de objetos não gráficos executados no E3 Server, como Bancos de Dados, Configurações de Alarmes, Fórmulas, Históricos, Storages, Servidores de Dados, Drivers de Comunicação e Alarmes.
NOTA |
A Janela de Propriedades dos ElipseX no Editor de objetos pode ser aberta utilizando os atalhos de teclado ALT + ENTER ou ALT + Duplo-clique do mouse. |
Dentro de um mesmo arquivo .lib pode existir qualquer número de componentes ElipseX, sejam eles XControls, XFolders ou XObjects. Pode-se também ter várias Bibliotecas diferentes dentro do mesmo Domínio.
Note que para cada ElipseX criado em uma Biblioteca são criadas internamente duas interfaces, uma para declarar as propriedades do objeto e outra para declarar os eventos do objeto. Estas interfaces têm seus nomes gerados automaticamente, acrescentando o prefixo "D" a este nome (a interface de eventos adiciona o sufixo "Events" ao nome automático). Se, por exemplo, o objeto se chama "XObject1", sua interface de propriedades tem o nome "DXObject1" e a interface de eventos, "DXObject1Events". Uma tentativa de usar estes nomes em outras classes na mesma Biblioteca gera um código de erro 8002802D, que corresponde a Name already exists in the library.