4D Doc Center : INSERT LISTBOX COLUMN

4D v14.3

INSERT LISTBOX COLUMN


INSERT LISTBOX COLUMN ( {* ;} objeto ; posiçaoCol ; nomeColuna ; variavelCol ; nomeCabe ; varTitulo {; nomRodapé ; nomeVar} )

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 coluna
variavelCol	Array, Campo, Variável	Nome de coluna do array ou campo ou variável
nomeCabe	cadeia	Nome do objeto título da coluna
varTitulo	Variável inteira	Variável título da coluna
nomRodapé	cadeia	Nome do rodapé da coluna
nomeVar	Variável	Variável do rodapé da coluna

Descrição

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

Nota: este comando não faz nada se aplica à primeira coluna de um lisbox 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 se insere justo em frente da coluna definida pelo parâmetro posiçãoCol. Se o parâmetro posiçãoCol é superior ao número total de colunas, a coluna é adicionada depois da última coluna.

Passe o nome do objeto e da variable da coluna inserida nos parâmetros nomCol e variávelCol.

Com um array tipo list box, o nome da variável deve coincidir com o nome do array cujo conteúdo se mostrará na coluna.
Com uma seleção tipo list box, deve passar um campo ou variável no parâmetro variávelCol. O conteúdo da coluna será então o valor do campo ou da variável, avaliado para cada registro da seleção associada ao list box. Este tipo de conteúdos só pode ser utilizado quando a propriedade "Fonte de dados" do list box é Seleção atual ou Seleção temporária (ver a seção Gestão de objetos List Box). Pode utilizar os campos ou as variáveis de tipo string, numérico, Data, Hora, Imagem e Booleano.

No contexto de list boxes baseadas em seleções, INSERT LISTBOX COLUMN pode ser utilizado para inserir elementos simples (campos ou variáveis). Se quer manipular expressões mais complexas (tais como fórmulas ou métodos), deve utilizar o comando INSERT LISTBOX COLUMN FORMULA.

Nota: não é possível combinar em um mesmo list box colunas de tipo array (fonte de dados array) e colunas de tipo campo ou variável (fonte de dados seleção).

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

Pode passar nos parâmetros nomRodapé e nomVar, o nome do objeto e a variável do rodapé da coluna inserida.

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

Exemplo 1

Imagine que queira adicionar uma coluna ao final do list box:

 C_LONGINT(NomVarTitulo;$Ultimo;RecNum)

 ALL RECORDS([Tabela 1])

 $RecNum:=Records in table([Tabela 1])

 ARRAY PICTURE(Imagem;$RecNum)

 

 $Ultimo:=Get number of listbox columns(*;"ListBox1")+1

 LISTBOX INSERT COLUMN(*;"ListBox1";$Ultimo;"ColumnImagem";Imagem;"imagemTitulo";NomVarTitulo)

Exemplo 2

Imagine que gostaria de adicionar uma coluna à direita do list box e associar-lhe os valores do campo [Transporte]Tarifas:

 $Ultimo:=Get number of listbox columns(*;"ListBox1")+1

 LISTBOX INSERT COLUMN(*;"ListBox1";$Ultimo;"CampoCol";[Transporte]Tarifas;"nomTitulo";varTitulo)