4D Doc Center : SET FIELD TITLES

4D v14.3

SET FIELD TITLES


SET FIELD TITLES ( tabela ; titulosCampos ; numCampos {; *} )

tabela	Tabela	Tabela para a qual vai estabelecer os títulos dos campos
titulosCampos	Array cadeia	Nomes dos campos do jeito que eles vão aparecer nas caixas de diálogo
numCampos	Array inteiro longo	Números de campos atuais
*		Use os nomes personalizados no editor de fórmulas

Descrição

SET FIELD TITLES permite ocultar, renomear e reorganizar os campos de uma tabela ou de uma subtabela passada em tabela ou subtabela quando aparecem nos editores padrão de 4D, tal como o editor de pesquisas, em modo Aplicação (mais especificamente, quando os editores são chamados através dos comandos do linguagem de 4D).

Este comando permite igualmente renomear rapidamente as etiquetas dos campos em seus formulários, se tiver utilizado nomes dinâmicos. Para mais informação sobre a inserção de etiquetas de tabelas e campos dinâmicos nos formulários, consulte o Manual de Desenho 4D.

Os arrays titulosCampos e numCampos devem estar sincronizados. No array titulosCampos, passe o nome dos campos do jeito queira que eles apareçam. Se não desejar mostrar um campo em particular, não inclua seu nome ou novo título no array. Os campos aparecerão na ordem que especifique neste array. Em cada elemento do array numCampos, passe o número da tabela que corresponde ao nome, novo ou antigo, do campo passado no mesmo número de elemento que no array titulosCampos.

Por exemplo, você tem uma tabela ou subtabela composta pelos campos F, G, e H, criada nessa ordem. Você deseja que esses campos apareçam como M, N, e O. Além disso você não deseja mostrar o campo N. Por último, deseja mostrar O e M nessa ordem. Para fazer isso, passe O e M, no array de dois-elementos titulosCampos e passe 3 e 1, em um array de dois elementos, numCampos.

O parâmetro opcional * lhe permite indicar se os nomes personalizados definidos utilizando este comando pode ser utilizados ou não em fórmulas 4D.

Por padrão, quando este parâmetro for omitido, as fórmulas executadas em 4D não podem usar nomes personalizados; é necessário utilizar os nomes de tabela reais. Usar nomes personalizados dá grande liberdade para nomear campos já que o interpretador de linguagem não processa nomes personalizados.
Se for passado o parâmetro *, os nomes definidos por este comando podem ser utilizados nas fórmulas executadas por 4D. Tenha cuidado neste caso, os nomes personalizados não devem conter caracteres que são considerados como “proibidos” pelo interpretador da linguagem 4D, tais como -?*! (para maior informação, consulte a seção “Convenções”).

Nota: se sua aplicação der acesso ao editor de fórmulas (por exemplo pelo editor de Relatórios rápidos), é necessário passar o parâmetro * para garantir consistência na interface.

SET FIELD TITLES NO modifica a estrutura atual de sua tabela. Só afeta usos posteriores das caixas de diálogo padrão de 4D e dos formulários que utilizam nomes dinâmicos quando eles são chamados através de um comando de linguagem (a estrutura real do banco é mostrada quando o editor ou formulário se chama desde um comando de menu em modo Desenho). O alcance do comando SET FIELD TITLES é a sessão de trabalho. Um benefício em cliente/Servidor é que várias estações 4D cliente podem “ver” simultaneamente sua tabela de maneiras diferentes. Pode chamar SET FIELD TITLES tantas vezes quantas quiser.

Utilize o comando SET FIELD TITLES para:

Localizar dinamicamente seu banco.
Mostrar os campos na ordem que você queira, independentemente da definição atual de sua tabela.
Mostrar os campos de um jeito que dependam da identidade ou dos privilégios personalizados de um usuário.

AVISO:

SET FIELD TITLES NÃO anula o efeito da propriedade invisível de um campo. Quando um campo for definido para que seja invisível ao nivel Desenho do seu banco de dados, apesar de aparecer na chamada a SET FIELD TITLES não aparecerá em modo Aplicação.
Os plug-ins sempre acessam a estrutura "virtual" como está especificado por este comando.

Exemplo

Ver o exemplo do comando SET TABLE TITLES.