4D Doc Center : GET LISTBOX ARRAYS

4D v12.4

GET LISTBOX ARRAYS


GET LISTBOX ARRAYS ( {* ;} objeto ; arrNomsCol ; arrNomsTitulos ; arrVarCol ; arrVarTitulos ; arrColVisivel ; arrEstilos )

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 * for omitido)
arrNomsCol	Array cadeia	Nomes de objetos de colunas
arrNomsTitulos	Array cadeia	Nomes dos objetos títulos cabeçalhos
arrVarCol	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
arrColVisivel	Array booleano	Visibilidade de cada coluna
arrEstilos	Array ponteiro	Ponteiros para arrays ou estilos, cores e variáveis de visibilidade ou Nil

Descrição

O comando LISTBOX GET ARRAYS devolve um conjunto de arrays sincronizados oferecendo informação sobre cada coluna (visible ou invisible) 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 arrNomsCol 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 arrVarsCol 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 arrVarsTitulos contém ponteiros até as variáveis associadas a cada título de coluna do list box.
• o array arrVisibles 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.