4D Doc Center : INSERT LISTBOX COLUMN FORMULA

4D v14.3

INSERT LISTBOX COLUMN FORMULA


INSERT LISTBOX COLUMN FORMULA ( {* ;} objeto ; posiçaoCol ; nomeColuna ; formula ; tipoDados ; nomeCabe ; varTitulo {; nomeRodape ; varRodape} )

Parâmetro	Tipo	Descrição
*	Operador	Se especificado, objeto é um nome de objeto (string), se omitido, objeto é uma variável
objeto	Objeto de formulário	Nome objeto (se * for especificado) ou Variável (se * é omitido)
posiçaoCol	Inteiro longo	Localização da coluna a inserir
nomeColuna	cadeia	Nome do objeto de coluna
formula	cadeia	Fórmula 4D associada com a coluna
tipoDados	Inteiro longo	Tipo de resultado da fórmula
nomeCabe	cadeia	Nome do objeto título da coluna
varTitulo	Variável inteira	Variável título de coluna
nomeRodape	cadeia	Nome do rodapé da coluna
varRodape	Variável	Variável de rodapé da coluna

Descrição

O comando INSERT LISTBOX COLUMN FORMULA insere uma coluna no listbox designado pelos parâmetros objeto e *.

O comando INSERT LISTBOX COLUMN FORMULA é similar ao comando INSERT LISTBOX COLUMN exceto que pode ser utilizada para introduzir uma fórmula como conteúdo de uma coluna.

Este tipo de conteúdo só pode ser utilizado quando a propriedade “Fonte de dados” do list box é Seleção atual ou Seleção temporária (para maior informação a respeito, consulte a seção Gestão de objetos List Box Texto multi estilo).

Nota: este comando não faz nada se for aplicado à primeira coluna de um list box mostrado em modo hierárquico.

Se passa o parâmetro opcional *, indica que o parâmetro objeto é um nome de objeto (string). Se omitir este parâmetro, indica que o parâmetro objeto é uma variável. Nesse caso, não passa uma string, mas uma referência de variável. Para maior informação sobre nomes de objetos, consulte a seção Propriedades dos objetos.

A nova coluna é inserida justo antes da coluna designada pelo parâmetro posicionCol. Se o parâmetro posicionCol é superior ao número total de colunas, a coluna será adicionada depois da última coluna.

Passe no parâmetro nomCol o nome do objeto da coluna inserida.

O parâmetro fórmula pode conter qualquer expressão válida:

Uma instrução,
Uma fórmula gerada utilizando o editor de fórmulas,
Uma chamada a um comando 4D,
Uma chamada a um método de projeto.

No momento da chamada do comando, a formula é analizada e depois é executada.

Nota: utilize o comando Command name para definir as fórmulas independentes da linguagem da aplicação (quando chamam a comandos 4D).

O parâmetro tipoDados pode ser utilizado para designar o tipo de dados resultantes da execução da formula. Deve passar neste parâmetro uma das seguintes constantes do tema Tipos de campos e variáveis:

Constante	Tipo	Valor
Is Boolean	Inteiro longo	6
Is date	Inteiro longo	4
Is picture	Inteiro longo	3
Is real	Inteiro longo	1
Is text	Inteiro longo	2
Is time	Inteiro longo	11

Se o resultado da formula não corresponde ao tipo de dados esperado, é gerado um erro.

Passe nos parâmetros nomTitulo e varTitulo o nome de objeto e a variável do título coluna inserida.

Nos parâmetros nomRodape e varRodape, você também pode passar o nome do objeto e variável do rodapé da coluna inserida. Se você omitir o parâmetro varRodape, 4D usa uma variável dinâmica.

Nota: os nomes de objeto devem ser únicos em um formulário. Deve ter certeza de que os nomes passados nos parâmetros nomCol e nomRodape não tenham sido utilizados. Do contrário, a coluna no é criada e um erro é gerado.

Exemplo

Se queremos adicionar uma nova coluna à direita do listbox que conterá uma fórmula que calcula a idade de um empregado:

 vIdade:="Data atual-[Empregados]DataNascimento)\365"

 $ultima:=LISTBOX Get number of columns(*;"ListBox1")+1

 LISTBOX INSERT COLUMN FORMULA(*;"ListBox1";$ultima;"ColFormula";Is real;vIdade;"Idade";varTitulo)