4D Doc Center : INSERT LISTBOX COLUMN FORMULA

4D v12.4

INSERT LISTBOX COLUMN FORMULA


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

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

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 LISTBOX INSERT 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 OS Serial Ports Manager Errors (-28)).

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 .

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 “”:

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 fórmula 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.

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 nomTitulo 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)