SET LIST ITEM ICON

4D v16.3

SET LIST ITEM ICON


SET LIST ITEM ICON ( {* ;} lista ; refElem \| * ; icone )

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, String	Número de referência de lista (se omitida ) ou Nome do objeto de tipo lista (se passada )
refElem \| *	Inteiro longo, Operador	Número de referencia do elemento, ou 0 para o último elemento adicionado à lista ou * para o elemento da lista atualmente selecionada
icone	Imagem	Ícone a associar ao elemento

Descrição

O comando SET LIST ITEM ICON permite modificar o ícone associado ao elemento especificado pelo parâmetro refElem da lista cujo número de referência o nome de objeto se passa em lista

Nota: é possível modificar o ícone associado com um elemento utilizando o comando SET LIST ITEM PROPERTIES. Entretanto, o comando aceita unicamente as referências de imagens estáticas (referências de recursos ou imagens da biblioteca de imagens).

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 é requerida já que cada representação pode ter seu próprio elemento atual.

Pode passar um número de referência em refElem. Se este número não corresponde a nenhum elemento da lista, o comando não faz nada. Também pode passar 0 em refElem para obter a fonte do último elemento adicionado à lista (utilizando APPEND TO LIST).

Por último, pode passar * em refElem: neste caso, o comando será aplicado ao elemento atual da lista. Se for selecionados vários elementos manualmente, o elemento atual é o último selecionado. Se nenhum elemento estiver selecionado, o comando não faz nada.

Passe no parâmetro icone uma expressão de imagem 4D válida (campo, variável, ponteiro, etc.). A imagem será colocada a direita do elemento.

Exemplo

Queremos atribuir a mesma imagem a dois elementos diferentes. O seguinte código se otimiza já que a imagem é carregada na memória só uma vez:

 C_PICTURE($picture)

 READ PICTURE FILE("myPict.png";$picture)

 SET LIST ITEM ICON(mylist;ref1;$picture)

 SET LIST ITEM ICON(mylist;ref2;$picture)

Ver também

SET LIST ITEM PROPERTIES