SET LIST ITEM PROPERTIES

4D v16.3


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

Parâmetro	Tipo	Descrição
*	Operador	Se for especificado, lista é um nome de objeto (string). Se omitido, lista é um número de referência de lista
lista	ListRef, String	Número lista referência (se* for omitido) ou Nome do objeto tipo lista (se * for passado)
refElem \| *	Operador, Inteiro longo	Número referência Item, ou 0 para o último item anexado a lista, ou * para o item de lista atual
editavel	Booleano	True = editável, False = não editável
estilos	Inteiro longo	Estilo de fonte para o item
icone	Inteiro longo	131072 + Número de referência de Imagem, ou 0
cor	Inteiro longo	Valor de cor RGB ou -1 = volta para a cor original

Descrição

O comando SET LIST ITEM PROPERTIES modifica o elemento designado pelo parâmetro refElem da lista cujo número de referência ou nome de objeto se passa em lista.

Se passa o primeiro parâmetro opcional *, indica que o parâmetro lista é um nome de objeto (string) 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.).

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

Se trabalha com os números de referência dos elementos, construa uma lista na qual os elementos tenham números de referência únicos, do contrário não poderá diferenciar os elementos. Para maior informação, consulte

Nota: para modificar o texto do elemento ou sua sublista, utilize o comando SET LIST ITEM.

Para fazer com que um elemento seja editável, passe TRUE em editavel; ou do contrário, passe FALSE.

Importante

Para que um elemento seja editável, deve pertenecer a uma lista que seja editável. Para fazer que uma lista seja editável, utilize o comando OBJECT SET ENTERABLE . Para fazer que um item individual seja editável, utilize SET LIST ITEM PROPERTIES. . A modificação da propriedade editável a nível da lista não afeta as propriedades individuais de cada elemento. Entretanto, um item pode ser editável só se sua lista for editável.

Para especificar o estilo de fonte do item use os parâmetros de estilo. Pase uma combinação (uma ou uma soma) das constantes pré-definidas abaixo tema (Estilos de fonte) :

Constante	Tipo	Valor
Bold	Inteiro longo	1
Italic	Inteiro longo	2
Plain	Inteiro longo	0
Underline	Inteiro longo	4

Para associar um ícone ao elemento, passe Use PicRef+N no parâmetro ícone, onde N é o número de referência de imagem da Biblioteca de Imagens do ambiente Desenho. Passe zero (0), se não quiser uma imagem para o elemento.

Nota:

Use PicRef é uma constante predefinida localizada no tema
Se deseja utilizar expressões imagem 4D (campos, variáveis, etc.) para definir os ícones dos elementos, utilize o comando SET LIST ITEM ICON .

O parâmetro cor (opcional) lhe permite modificar a cor do texto do elemento. A cor deve ser especificada em forma de cor RGB, ou seja um inteiro longo de 4 bytes em formato 0x00RRGGBB. Para maior informação sobre este formato, consulte a descrição do comando OBJECT SET RGB COLORS Passe -1 no parâmetro cor para restabelecer a cor original do elemento.

Exemplo 1

Ver o exemplo do comando APPEND TO LIST.

Exemplo 2

O exemplo a seguir modifica o texto do elemento atual de lista negrito e vermelho vivo:

SET LIST ITEM PROPERTIES(list;*;True;Bold;0;0x00FF0000)

Ver também

GET LIST ITEM PROPERTIES
Listas hierárquicas
SET LIST ITEM
SET LIST ITEM ICON