4D Doc Center : SET LIST ITEM PROPERTIES

4D v14.3

SET LIST ITEM PROPERTIES


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

Parâmetro	Tipo	Descrição
*	Operador	If specified, list is an object name (string) If omitted, list is a list reference number
lista	ListRef, cadeia	List reference number (if * omitted) or Name of list type object (if * passed)
refElem \| *	Operador, Inteiro longo	Item reference number, or 0 for last item appended to the list, or * for the current list item
editavel	Booleano	TRUE = Enterable, FALSE = Non-enterable
styles	Inteiro longo	Font style for the item
icone	Inteiro longo	‘cicn’ Mac OS-based resource ID, or 65536 + ‘PICT’ Mac OS-based resource ID, or 131072 + Picture Reference Number
cor	Inteiro longo	RGB color value or -1 = reset to original color

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 facer 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.

O estilo de fonte do elemento é especificado no parâmetro estilos. Se passar uma ou uma combinação das seguintes constantes predefinidas:

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

Para associar um ícone ao elemento, passe um dos seguintes valores numéricos:

N, onde N é o número de um recurso Mac OS ‘cicn’
Use PICT resource+N, onde N é o número de um recurso Mac OS ‘PICT’
Use PicRef+N, onde N é o número de referência de uma imagem armazenada na biblioteca de imagens de 4D, no ambiente Desenho.

Passe zero (0), se não quiser uma imagem para o elemento.

Nota:

Use PICT resource e Use PicRef são constantes predefinidas ubicadas en el 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)