Este tópico pretende explicar, os tipos de objetos que existem e a forma de os trabalhar tanto nos Ecrãs Personalizados como nos Paineis de Informação.

Tipos de Objetos

Contentor de Objetos
Os objetos do tipo "Contentor de Objetos" podem ser subdivididos em quatro tipos:

Contentor de Páginas
Este objeto encontra-se praticamente em todos os ecrãs principais.
Por exemplo, no ecrã de documentos de faturação é o objeto que contém as páginas Página Principal, Outros Dados, Regularizações, etc.
Este tipo de objeto só suporta outros objetos do tipo Páginas e no caso do desenho de personalizações de ecrã, para facilitar outros métodos de seleção e manipulação de objetos, é o único que não suporta a funcionalidade de Drag And Drop. Para mover este tipo de objeto, depois de ele estar selecionado, é necessário recorrer às teclas do cursor (teclas das setas).

Para adicionar páginas a um objeto deste tipo, deve fazer-se clique direito no objeto e no menu que aparece escolher Adicionar Página.

Para remover uma página, depois de a selecionar, deve fazer-se clique direito no objeto página, e no menu escolher Remover esta Página, ou ainda, selecionar a página desejada e depois pressionar a tecla Delete.


Página
Este objeto representa uma única página do objeto descrito acima, ou seja, no ecrã de documentos de faturação por exemplo, o objeto Página Principal é um objeto deste tipo. O objeto Outros Dados será outro objeto deste tipo e assim sucessivamente. Este tipo de objeto pode conter outros objetos de vários tipos como sejam campos, textos, botões, etc, embora este tipo de objeto só possa pertencer a um objeto do tipo Contentor de Páginas.

Para adicionar objetos a uma página, basta escolher o objeto da barra de objetos e depois clicar sobre a página desejada. Pode também fazer-se clique direito no objeto página e no menu que aparece na opção Adicionar um Objeto selecionar o objeto que se pretende adicionar.

Para remover objetos da página, depois de selecionar o objeto desejado e fazer clique direito sobre o mesmo, é necessário escolher a opção Remover do menu ou então pressionar a tecla Delete.


Contentor de Opções
Este objeto representa um novo objeto disponível para o desenho de personalizações de ecrã chamado Campos de Escolha Seletiva.
Os Campos de Escolha Seletiva podem conter outros, mas à semelhança do objeto do Contentor de Páginas, este apenas pode conter objetos do tipo Opções.
No entanto, ao contrário do objeto Contentor de Páginas, este objeto suporta a funcionalidade de Drag And Drop.
Para adicionar opções a um objeto deste tipo, deve fazer-se clique direito no objeto e no menu que aparece escolher Adicionar uma Opção. Para remover objetos primeiro deve-se selecionar o objeto que desejamos eliminar e depois fazer clique direito nesse objeto e selecionar a opção de menu Remover ou pressionar a tecla Delete.

Nota, só se pode adicionar ou remover opções a um objeto deste tipo se ele não for um objeto de sistema, e no caso de remover opções, o mínimo de opções permitidas num objeto deste tipo são duas.


Contentor
Este tipo de objeto é um objeto geral que pode conter objetos de vários tipos e é bastante semelhante ao objeto Página. No entanto, ao contrário deste, não necessita de pertencer apenas a objetos do tipo Contentor de Páginas podendo residir no próprio ecrã, em objetos do tipo Páginas ou ainda dentro de objetos do mesmo tipo, ou seja dentro de outros objetos do tipo Contentor.
Este tipo de objeto não se encontra disponível na barra de objetos para adicionar a um desenho de personalização de ecrãs, mas como em diversos ecrãs existem objetos de sistema deste tipo, se o utilizador selecionar um desses objetos, e fizer CTRL+COPY e CTRL+PASTE são criados objetos idênticos aos objetos selecionados.
Nestes casos, sendo objetos de utilizador, é possível adicionar ou remover objetos de dentro de um objeto deste tipo, já que no caso de objetos de sistema deste tipo, não é permitido adicionar ou remover objetos.

Para adicionar objetos num contentor, é necessário selecioná-lo primeiro e só depois escolher o objeto da barra de objetos a adicionar. Depois de selecionar o objeto do tipo contentor, ou de fazer clique direito no mesmo, basta selecionar a opção Adicionar um Objeto e selecionar o objeto que se pretende adicionar. Para remover objetos basta fazer clique direito sobre o objeto pretendido e no menu que aparece escolher Remover ou então pressionar a tecla Delete.



Como selecionar objetos ?

Para selecionar um objeto o método mais simples é fazer clique no objeto desejado para que ele fique automaticamente selecionado. Caso não se tenha a tecla Shift pressionada na altura em que se faz clique no objeto, outros objetos que estejam selecionados são automaticamente desselecionados, ficando apenas selecionado o objeto onde fizemos clique. Caso a tecla Shift esteja pressionada, são mantidos os outros objetos selecionados caso existam, e é adicionada mais uma seleção do objeto onde fizemos clique.
Outro método de selecionar objetos é através da janela Ecrã de Propriedades onde no topo existem 2 objetos, um do tipo lista que permite selecionar o objeto desejado e um botão que permite escolher o objeto desejado através da visualização dos objetos em estilo àrvore.

Caso a seleção de um objeto seja feita através do clique do rato, é necessário ter em atenção que no caso de objetos do tipo Contentor de Objetos a opção de selecionar é um pouco mais variada, ou seja :

Clique num objeto que não esteja selecionado:

Se a tecla CTRL estiver pressionada - é selecionado o objeto onde foi efetuado o clique

.

Se a tecla Ctrl não estiver pressionada:

- Se o objeto onde foi efetuado o clique se encontra dentro de um objeto do tipo Contentor ou Contentor de Opções, o objeto que vai ser selecionado não é o objeto onde foi efetuado o clique, mas sim o seu contentor;
- Se o objeto onde foi efetuado o clique não se encontra dentro de um objeto do tipo Contentor ou Contentor de Opções é selecionado o objeto onde foi efetuado o clique.

Clique num objeto que esteja selecionado:

Se existir um objeto por baixo do ponteiro do rato que não seja o próprio objeto que está selecionado

:
- Se o objeto por baixo do ponteiro do rato for do tipo Contentor de Páginas ou Página é selecionado o objeto que está por baixo do ponteiro do rato;
- Se o objeto por baixo do ponteiro do rato não for do tipo Contentor de Páginas ou Página:

Se a tecla CTRL estiver pressionada é selecionado o objeto que está por baixo do ponteiro do rato

.

Se a tecla Ctrl não estiver pressionada e se o objeto selecionado for do tipo Contentor de Páginas ou Página é corrida a rotina Clique num objeto que não esteja selecionado com o objeto que está por baixo do ponteiro do rato;

Se o objeto que está selecionado não é do tipo Página e se o objeto por baixo do ponteiro do rato não pertence ao objeto que está selecionado é selecionado o que está por baixo do ponteiro do rato.

Nota: Quando clica num determinado objeto a aplicação verifica qual o seu objeto pai maior e tenta selecionar esse objeto pai em vez do objeto que clicou, isto porque na maioria dos casos é esse objeto pai onde estão as propriedades que se deseja alterar. Se ao clicar no objeto pressionar também a tecla CTRL, nesse caso a aplicação não efetua os passos descritos e seleciona de imediato o objeto que clicou. Por exemplo: Se colocar a propriedade "Páginas (Clique)" igual a "Não" os objetos filhos não são logo selecionados, apenas o objeto pai é selecionado, para selecionar os objetos filhos tem que fazer CTRL.

No desenho de personalizações de ecrã quando se seleciona um determinado objeto, é desenhado á volta desse objeto 8 pontos pretos, respetivamente em cada extermidade do objeto e no meio do seu comprimento e altura, para que se consiga distinguir facilmente que determinado objeto está ou não selecionado. Quando se alterar as propriedades na janela de propriedades esse valor será atribuido ao objeto ou a objetos que estiverem selecionados.
Se o objeto selecionado for simples, os pontos serão pretos como anteriormente, se for um objeto composto (objeto contentor) os pontos serão vermelhos, indicando talvez a necessidade de desselecionar o objeto e voltar a selecionar mas desta vez com a tecla CTRL pressionada.

Logo na entrada do desenho de ecrãs personalizados, caso a janela de propriedades esteja aberta, esta apresenta diversas propriedades e eventos do objeto Ecrã.
Agora pode-se modificar várias propriedades do ecrã logo no desenho sem ter que ir às opções Supervisor - Framework PHC - Propriedades de Ecrãs ou Supervisor - Framework PHC - Eventos do utilizador, com a vantagem de se ver o resultado logo que se modifica uma propriedade e de ter mais eventos disponíveis para configuração.

Existem também várias novas propriedades e Eventos disponíveis no objeto novo e nos já existentes, que possibilitam uma maior personalização dos mesmos.


CTRL+COPY e CTRL+PASTE

Quando se pretende copiar e colar objetos podem utilizar-se, como aliás já foi referido, os comandos CTRL+COPY e CTRL+PASTE.
Esta operação é feita inteiramente através do clipboard sem recorrer a nenhum ficheiro, o que permite copiar de uma personalização e fazer paste noutra personalização diferente, ou mesmo até noutra instância da aplicação que esteja aberta.
Relativamente às opções do menu Editar é possível criar um ficheiro com a informação dos objetos que se pretendem passar para outra personalização noutro ecrã ou noutra base de dados.

Como identificar a linha de erro no código de utilizador?
Sempre que o utilizador introduz código nas personalizações de ecrãs há o risco de o código poder ter algum tipo de erro e se isto acontecer é mostrada uma mensagem de erro ao utilizador que indica o nº da linha em que o erro ocorre. Esta mensagem de aviso do erro é importante para o utilizador ser informado que existe um erro no seu código, no entanto é preciso ter em conta que o nº da linha é referente ao nº da linha dentro do total de código de utilizador nos ecrãs personalizados.

Para se verificar a linha correta nos ecrãs personalizados deve-se abrir um dos ecrãs em que é possível introduzir código, por exemplo, no ecrã onde foi introduzido o último código, selecionar a opção "Ver o Código de todos os objetos" e aqui sim, procurar a linha que foi mencionada na mensagem de erro.