4D v14.3

GET LIST ITEM PROPERTIES

Página Inicial

 
4D v14.3
GET LIST ITEM PROPERTIES

GET LIST ITEM PROPERTIES 


 

GET LIST ITEM PROPERTIES ( {* ;} lista ; refElem | * ; editavel {; estilos {; icone {; cor}}} ) 
Parâmetro Tipo   Descrição
Operador in Se especificada, lista é um nome de objeto (cadeia) Se omitida, lista é um número de referência de lista
lista  ListRef, cadeia in Número de referência de lista (se omitida *) ou Nome do objeto de tipo lista (se passada *)
refElem | *  Operador, Inteiro longo in Número de referencia do elemento, ou 0 para o último elemento adicionado à lista ou * para o elemento da lista atualmente selecionada
editavel  Booleano in TRUE = Editável, FALSE = Não editável
estilos  Inteiro longo in Estilo de fonte do elemento
icone  Inteiro longo in 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 in Valor de cor RGB

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.

 
PROPRIEDADES 

Produto: 4D
Tema: Listas Hierárquicas
Número 631

 
HISTÓRIA 

Modificado: 4D v11 SQL

 
VER TAMBÉM 

GET LIST ITEM
GET LIST ITEM ICON
SET LIST ITEM
SET LIST ITEM PROPERTIES

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v12.4)
Manual de linguagem 4D ( 4D v11 SQL Release 6)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)