4D Doc Center : INSERT LISTBOX COLUMN

4D v12.4

INSERT LISTBOX COLUMN


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

Parâmetro	Tipo	Descrição
*		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

Descrição

O comando LISTBOX INSERT 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 .

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 contenido da coluna será então o valor do campo ou da variável, evaluado 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 ). 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, LISTBOX INSERT 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 LISTBOX INSERT 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).

O nome da variável deve corresponder ao nome do array cujo conteúdo será mostrado na coluna.

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

Nota: os nomes dos objetos 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 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)