LISTBOX GET ARRAYS

4D v20 R7

LISTBOX GET ARRAYS


LISTBOX GET 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 texto	Nomes de objetos de colunas
arrNomsTitulos	Array texto	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 texto	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 Propriedades dos objetos.

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.
O quarto ponteiro corresponde seja a um array booleano (array de linhas ocultas), ou a um array inteiro longo (array utilizado para definir as linhas ocultas, desativadas e não selecionáveis), em função da implementação utilizada para o array de controle de linhas (ver Propriedades específicas dos list Box).

Para seleção de registro, list boxes do tipo coleção ou seleção de entidade 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.

Ver também

LISTBOX Get array
LISTBOX Get property
LISTBOX SET ARRAY