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

LISTBOX Get array

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

ParâmetroTipoDescrição
*OperadorSe for especificado, objeto é um nome de objeto (cadeia) Se for omitido, objeto é uma variável
objetoanyNome de objeto (se * for especificado) ou
Variável (se * for omitido)
tipoArrayIntegerTipo de array
ResultadoPointerPonteiro ao array associado a propriedade

Esse comando não é seguro para thread e não pode ser usado em código adequado.

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":

ConstanteTipoValorComentário
lk background color arrayInteiro longo1
lk control arrayInteiro longo3
lk font color arrayInteiro longo0
lk row height arrayInteiro longo4(licença 4D View Pro exigida)
lk style arrayInteiro longo2

O comando devolve um dos seguintes valores:

  • Is nil pointer 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";lk font color array)
  // Devolve um ponteiro ao array de cores de fonte
  // Associado ao list box "MyLB"
 
 vPtr:=LISTBOX Get array(*;"Col4";lk style array)
  // Devolve um ponteiro ao array de estilos de fonte
  // Associado a coluna de list box "Col4"

Ver também

LISTBOX GET ARRAYS
LISTBOX SET ARRAY