4D Doc Center : LISTBOX Get array

4D v14.3

LISTBOX Get array


LISTBOX Get array ( {* ;} objeto ; tipoArray ) -> Resultado

Parâmetro	Tipo	Descrição
*	Operador	Se for especificado, objeto é um nome de objeto (cadeia) Se for omitido, objeto é uma variável
objeto	Objeto de formulário	Nome de objeto (se * for especificado) ou Variável (se * for omitido)
tipoArray	Inteiro longo	Tipo de array
Resultado	Ponteiro	Ponteiro ao array associado a propriedade

Descrição

Nota: Este comando só funciona com os list box de tipo array.

O comando LISTBOX Get array devolve um ponteiro ao array associado ao estilo ou a cor do list box ou da coluna de list box designada pelos parâmetros objeto e * .

Os arrays de estilo, cor ou cor de fundo podem estar associados aos list box de tipo de array usando a lista de propriedades em modo Desenho ou o comando LISTBOX SET ARRAY.

Se passar o parâmetro opcional *, indica que o parâmetro objeto é um nome de objeto (cadeia). Se não passar este parâmetro, indica que o parâmetro objeto é uma variável. Neste caso, passa uma referência de variável no lugar de uma cadeia. Pode designar um list box ou uma coluna de list box como parâmetro objeto.

Passe em tipoArray, o tipo de array de propriedade a obter. Pode utilizar uma das seguintes constantes, do tema "List box":

Constante	Tipo	Valor
Listbox background color array	Inteiro longo	1
Listbox font color array	Inteiro longo	0
Listbox style array	Inteiro longo	2

O comando devolve um dos seguintes valores:

Nil Se nenhum array da propriedade solicitada está associado a coluna ou ao list box.
Um ponteiro ao array da propriedade solicitada, definido pelo usuário.
Um ponteiro ao array da propriedade solicitada, definido dinamicamente quando se chama ao comando LISTBOX SET ROW COLOR ou LISTBOX SET ROW FONT STYLE

Exemplo

Exemplos típicos de uso:

 vPtr:=LISTBOX Get array(*;"MyLB";Listbox font color array)

  // Devolve um ponteiro ao array de cores de fonte

  // Associado ao list box "MyLB"

 

 vPtr:=LISTBOX Get array(*;"Col4";Listbox style array)

  // Devolve um ponteiro ao array de estilos de fonte

  // Associado a coluna de list box "Col4"