4D Doc Center : SET LIST ITEM ICON

4D v14.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, cadeia	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 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.

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 se necessita 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 fizer 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.

O uso de ponteiros é particularmente recomendado já que as listas hierárquicas são minimizadas neste caso: uma só instância da imagem será criada na memória se o mesmo ícone são utilizadas em vários elementos da lista.

Nota: pelo contrário, o emprego direto de variáveis geradas pelos comandos GET ICON RESOURCE ou GET PICTURE RESOURCE não é recomendável porque o ícone serão duplicadas em memória para cada elemento da lista.

Exemplo

Este código foi otimizado através do uso de um ponteiro:

 vIcono:=[Params]Icono

 SET LIST ITEM ICON(milist;ref1;vIcon->)

 SET LIST ITEM ICON(milist;ref2;vIcon->)