4D Doc Center : GET LISTBOX ARRAYS

4D v14.3

GET LISTBOX ARRAYS


GET LISTBOX ARRAYS ( {* ;} objeto ; arrNomsCols ; arrNomsTitulos ; arrVarCols ; arrVarTitulos ; arrColsVisiveis ; arrEstilos {; arrFooterNames ; arrFootersVars} )

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 * for omitido)
arrNomsCols	Array cadeia	Nomes de objetos de colunas
arrNomsTitulos	Array cadeia	Nomes dos objetos títulos cabeçalhos
arrVarCols	Array ponteiro	Ponteiros para variáveis de colunas ou Ponteiros para campos coluna ou Nil
arrVarTitulos	Array ponteiro	Ponteiros para variáveis de título
arrColsVisiveis	Array booleano	Visibilidade de cada coluna
arrEstilos	Array ponteiro	Ponteiros para arrays ou estilos, cores e variáveis de visibilidade ou Nil
arrFooterNames	Array cadeia	Nomes de objetos do rodapé da coluna
arrFootersVars	Array ponteiro	Ponteiros para variáveis de rodapé de coluna

Descrição

O comando LISTBOX GET ARRAYS devolve um conjunto de arrays sincronizados oferecendo informação sobre cada coluna (visível ou invisível) do list box designado pelos parâmetros objeto e *.

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 .

Quando se executa o comando:
• o array arrNomsCols contém a lista dos nomes dos objetos para cada coluna da list box.
• o array arrNomsTitulos contém a lista dos nomes dos objetos para cada título de coluna do list box.
• o array arrVarCols contém os ponteiros até as variáveis (arrays) associadas a cada coluna da list box. Para um listbox de tipo seleção, arrColVars contém:
- Para uma coluna associada a um campo, um ponteiro ao campo associado,
- Para uma coluna associada a uma variável, um ponteiro a variável,
- Para uma coluna associada a uma expressão, um ponteiro Nil.
• o array arrVarTitulos contém ponteiros até as variáveis associadas a cada título de coluna do list box.
• o array arrColVisiveis contém um valor Booleano para cada coluna, indicando se a coluna é visível (True) ou oculta (False) no list box.
• o array arrEstilos contém os três ponteiros até os três arrays que permitem aplicar um estilo específico, uma cor de fonte e uma cor de fundo a cada fila da list box. Estes arrays são associados no list box na Lista de propriedades do ambiente Desenho. Se um array não for especificado para a list box, o elemento correspondente em arrEstilos conterá um ponteiro Nil.

Para uma list box de tipo seleção, arrStyles contém:
- Por cada configuração definida através de uma variável, um ponteiro a variável,
- Por cada configuração definida através de uma expressão, um ponteiro Nil.