4D Doc Center : GET LIST ITEM PROPERTIES

4D v14.3

GET LIST ITEM PROPERTIES


GET LIST ITEM PROPERTIES ( {* ;} lista ; refElem \| * ; editavel {; estilos {; icone {; cor}}} )

Parâmetro	Tipo	Descrição
*	Operador	Se especificada, lista é um nome de objeto (cadeia) Se omitida, lista é um número de referência de lista
lista	ListRef, cadeia	Número de referência de lista (se omitida ) ou Nome do objeto de tipo lista (se passada )
refElem \| *	Operador, Inteiro longo	Número de referencia do elemento, ou 0 para o último elemento adicionado à lista ou * para o elemento da lista atualmente selecionada
editavel	Booleano	TRUE = Editável, FALSE = Não editável
estilos	Inteiro longo	Estilo de fonte do elemento
icone	Inteiro longo	Número de recurso Mac OS ‘cicn’, ou 65536 + número de recurso Mac OS ‘PICT’, ou 131072 + número de referência de imagem
cor	Inteiro longo	Valor de cor RGB

Descrição

O comando GET LIST ITEM PROPERTIES retorna o nome da fonte do caractere atual do elemento especificado pelo parâmetro refElem da lista cujo número de referência o nome de objeto se passa em lista.

Se passa o primeiro parâmetro opcional *, indica que o parâmetro lista é um nome de objeto (cadeia) correspondente a uma representação da lista no formulário. Se não passar este parâmetro, indica que o parâmetro lista é uma referência de lista hierárquica (RefLista). Se utiliza uma só representação de lista ou trabalha com elementos estruturais (o segundo * é omitido), pode utilizar indiferentemente uma ou outra sintaxe. Pelo contrário, se utiliza várias representações de uma mesma lista e trabalha com o elemento atual (se passa o segundo *), a sintaxe baseada no nome do objeto se necessita já que cada representação pode ter seu próprio elemento atual.

Nota: se utiliza o caractere @ no nome de objeto da lista e o formulário contém várias listas que correspondem a este nome, ou GET LIST ITEM PROPERTIES se aplicará ao primeiro objeto cujo nome corresponda.

Em refElem, pode passar um número de referência, ou o valor 0 com o objetivo de designar o último elemento adicionado à lista, ou * para designar o elemento atual da lista. Se vários elementos forem selecionados, o elemento atual é o último a ser selecionado.

Se passa * e nenhum elemento for selecionado ou se o número de referência do elemento não corresponde a nenhum elemento da lista, o comando deixa os parâmetros sem mudanças.

Se trabalhar com números de referência dos elementos, construa uma lista na qual os elementos tenham números de referencia únicos, do contrário não poderá diferenciar os elementos. Para maior informação, consulte a descrição do comando APPEND TO LIST.

Depois de a chamar:

editavel retorna TRUE se o elemento é editável.
estilos retorna o estilo de fonte do elemento.
icone retorna o ícone ou a imagem associada ao elemento, 0 se não houver nenhum.
cor retorna a cor do texto do elemento especificado.

Nota: pode recuperar, em uma variável imagem, o ícone associado com um elemento utilizando o comando GET LIST ITEM ICON.

Para maior informação sobre estas propriedades, consulte a descrição do comando SET LIST ITEM PROPERTIES.