Saltar para o conteúdo principal
Versão: Próximo

LISTBOX GET ARRAYS

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

ParâmetroTipoDescrição
*Operadorse especificado, objeto é um nome de objeto (string), se omitido, objeto é uma variável
objetoanyNome objeto (se * for especificado) ou Variável (se * for omitido)
arrNomsColsText arrayNomes de objetos de colunas
arrNomsTitulosText arrayNomes dos objetos títulos cabeçalhos
arrVarColsPointer arrayPonteiros para variáveis de colunas ou Ponteiros para campos coluna ou Nil
arrVarTitulosPointer arrayPonteiros para variáveis de título
arrColsVisiveisBoolean arrayVisibilidade de cada coluna
arrEstilosPointer arrayPonteiros para arrays ou estilos, cores e variáveis de visibilidade ou Nil
arrFooterNamesText arrayNomes de objetos do rodapé da coluna
arrFootersVarsPointer arrayPonteiros 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.

Ver também

LISTBOX Get array
LISTBOX Get property
LISTBOX SET ARRAY