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 | any | → | Nome objeto (se * for especificado) ou Variável (se * for omitido) |
| arrNomsCols | Text array | ← | Nomes de objetos de colunas |
| arrNomsTitulos | Text array | ← | Nomes dos objetos títulos cabeçalhos |
| arrVarCols | Pointer array | ← | Ponteiros para variáveis de colunas ou Ponteiros para campos coluna ou Nil |
| arrVarTitulos | Pointer array | ← | Ponteiros para variáveis de título |
| arrColsVisiveis | Boolean array | ← | Visibilidade de cada coluna |
| arrEstilos | Pointer array | ← | Ponteiros para arrays ou estilos, cores e variáveis de visibilidade ou Nil |
| arrFooterNames | Text array | ← | Nomes de objetos do rodapé da coluna |
| arrFootersVars | Pointer array | ← | Ponteiros para variáveis de rodapé de coluna |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
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.