FieldDisplayNames

Retorna os nomes de exibição de um campo como dados JSON.

Formato 

FieldDisplayNames ( fileName ; fieldName )

Parâmetros

nomeDoArquivo - o nome de um arquivo de banco de dados aberto (local ou remoto). Consulte Funções de design.

fieldName - uma expressão de texto para o nome de um campo. O nome do campo deve estar no formato nomedatabela::nomedocampo para especificar um campo existente em uma tabela diferente da tabela atual.

Tipo de dados retornado 

texto

Originada na versão 

26.0

Descrição

Retorna um objeto JSON contendo todos os nomes de exibição configurados para o campo especificado na opção Personalizar nomes de exibição de campo. Consulte Definição de opções avançadas de campo.

Exemplo 1

FieldDisplayNames ( "" ; "Clientes::Nome" ) retorna os nomes de exibição para o campo Nome na tabela Clientes no arquivo atual. Se os nomes de exibição para o padrão e para a Exibição em tabela estiverem definidos como Nome e Nome próprio respectivamente, a função retorna:

{"fm_common":"Nome","fm_table_view":"Nome próprio"}

Exemplo 2

JSONGetElement ( FieldDisplayNames ( "" ; "Clientes::Nome" ) ; "fm_table_view" ) retorna o nome de exibição da Exibição em tabela para o campo Nome, que é Nome próprio.

Exemplo 3

Retorna um nome de exibição personalizado em um cálculo de layout para um rótulo de campo em um layout com espaço limitado. Na caixa de diálogo Opções de campo avançadas do campo IDcliente, para Personalizar nomes de exibição de campo, especifique uma chave personalizada chamada meu_nome_curto com o valor ID:

JSONSetElement ( "{}" ; [ "meu_nome_curto" ; "ID" ; JSONString ] )

No cálculo de layout para o rótulo do campo, esse cálculo recupera o nome curto:

JSONGetElement ( FieldDisplayNames ( "" ; "Clientes::IDcliente" ) ; "meu_nome_curto" )

Isso retorna o ID como o rótulo do campo.

Tópicos relacionados