4D v14.3

INSERT LISTBOX COLUMN FORMULA

Página Inicial

 
4D v14.3
INSERT LISTBOX COLUMN FORMULA

INSERT LISTBOX COLUMN FORMULA 


 

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

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

 
PROPRIEDADES 

Produto: 4D
Tema: List Box
Número 970

 
HISTÓRIA 

Criado por: 4D v11 SQL
Renomear: 4D v12
Modificado: 4D v13

 
VER TAMBÉM 

INSERT LISTBOX COLUMN

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)

Inherited from : INSERT LISTBOX COLUMN FORMULA ( 4D v12.4)
Parent of : INSERT LISTBOX COLUMN FORMULA ( 4D v14 R3)