GE - Como Fazer - Personalização de Tela

De CIGAM WIKI

Voltar

Como Fazer > Utilidades/Diversos > Personalização de Tela

Com a Personalização de tela você agora pode fazer alterações nos formulários. Ele fornece as seguintes funcionalidades:

  • Mover controles na tela arrastando e soltando, usando o teclado. Você pode inclusive mover controles de uma guia para outra.
  • Redimensionar controles.
  • Ocultar (e restaurar) controles.
  • Alterar algumas das propriedades dos controles, como cor e fonte.

Para utilizar essa funcionalidade a versão do magic xpa deverá ser superior a 4.9.1. [Versão 230502 1]

Como personalizar telas

O recurso pode ser acessado através do atalho (Ctrl+Shift+P).

Também é possível acessar o recurso pelo menu do topo em ‘Acesso Rápido’, conforme imagem abaixo.

Personalizar Tela


Ao acessar o recurso, inicialmente será apresentada a tela com os controles no estado atual configurado.

Personalizar Tela


A guia ‘Propriedades’ apresentará os campos com as definições do controle em foco.
A guia ‘Controles ocultos’ apresentará os controles que foram retirados da tela. Ao clicar em um controle oculto com o botão direito ele poderá ser adicionado novamente à tela pela opção ‘Add to form’.
O campo ‘Configuration file’ apresentará o caminho do arquivo de configuração definido para a tela acessada. Esta opção pode ser visualizada toda vez que é efetuado um clique em uma área livre da tela que não possua controles.

Personalizar Tela


Ao clicar sobre um controle o mesmo apresentará suas definições e poderá ser retirado da tela utilizado a tecla ‘<Delete>’.
Os campos ‘BackColor’, ‘Font’ e ‘ForeColor’ alteram questões da aparência do controle como cor de fundo, fonte e cor da fonte.
O campo ‘Text’ permite editar o texto apresentado em tela.
Os campos ‘Height’, ‘Left’, ‘Top’ e ‘Width’ alteram questões do posicionamento do controle na tela. Ao clicar sobre o controle o mesmo também pode ser deslocado e dimensionado com auxílio do mouse.
O campo ‘Name’ apresenta o texto original do controle em tela ou o nome interno dos campos de edição, que pode ser utilizado para customizações.
O menu ‘Arquivo - Salvar’ realiza o salvamento da personalização atualmente definida.
O menu ‘Arquivo - Restaurar padrão’ retorna a tela ao seu estado original.
O menu ‘Arquivo - Sair’ encerra a personalização de telas.
O menu ‘Alinhar’ fornece opções para alinhamento do controle em relação aos demais existentes na tela.

Ao encerrar a personalização de telas, caso houverem alterações não salvas, será questionado sobre o salvamento das mesmas.

A Personalização em telas que possuem várias guias com telas diferentes como por exemplo o cadastro de empresas é indicado que se selecione exatamente o form e se exclua até chegar no desejado.

Personalizar Tela


Ao deletar até chegar as guias pode se ver que fique no seguinte formato:

Personalizar Tela


Observação: Ao montar um modelo é possível repassar o arquivo com a personalização para outro usuário desde que este tenha a mesma versão.


É possível parametrizar o sistema para que as personalizações feitas sejam utilizadas por todos os usuários. Para tal deve ser adicionado o nome lógico ControlsPersistencyPath na seção [MAGIC_ENV] do arquivo Magic.ini do ambiente. Exemplo:

[MAGIC_ENV]
       ControlsPersistencyPath = O:\CIGAM11\Modelos\Telas_personalizadas

Não escopo

Esta funcionalidade não permite a configuração de campos como obrigatórios.
Para saber mais como personalizar um campo, acesse:

Versão 230502

  1. Liberado a partir da OS 650489/83.