Lista de imagem

Nome	Lista de imagem
Tecla de atalho	Nenhuma
Ícone
Objeto gráfico	Sim

Esta página apresenta descrição e propriedades do item ImageList.

ImageList

Este objeto pode ser utilizado para criar uma lista de itens do tipo “Image” associada ou não a um Tag. Quando não associado a um Tag dispõe de recursos para apresentação sequencial de itens, ideal para animação de imagens.

Propriedades de identificação do objeto
Propriedade	Descrição	Default
Nome do item	Define o nome do item que será exibido na árvore do painel de projeto e será utilizado quando necessário referenciar o mesmo.	Item_NNN
Comentário	Permite a inclusão de um comentário acerca do objeto. Este campo não é obrigatório.	(Nenhum)
Argumentos	Neste campo pode-se inserir uma string que será o valor da propriedade Argument do item. A string fornecida é uma forma geral de passagem de parâmetros para os scripts associados ao objeto durante sua execução.	(Nenhum)

Propriedades Comuns
Propriedade	Descrição	Default
Descrição	Pode-se acrescentar uma breve descrição sobre o objeto. Este campo é apenas documental não sendo utilizado no projeto. Este campo não é obrigatório.	(Nenhuma)
Título	Neste campo é possível definir um título para este objeto.	Depende
Dica	Texto a ser apresentado quando o mouse é posicionado sobre o objeto. Este campo não é obrigatório.	(Nenhuma)
Topo	Define a distância, em pixels, entre a borda superior do objeto e a borda superior da tela.	Depende
Esquerda	Define a distância, em pixels, entre a borda esquerda do objeto e a borda esquerda da tela.	Depende
Largura	Largura, em pixels, do objeto.	Depende
Altura	Altura, em pixels, do objeto.	Depende
Habilitado	Define se o objeto pode responder a interação do usuário.	Sim
Grupo com permissão de execução	Neste campo é possível selecionar qual grupo de usuários terá permissão para executar a imagem na tela da aplicação.	Todos os grupos
Visível	Define se o objeto será ou não exibido na tela.	Sim
Grupo com permissão de visualização	Neste campo é possível selecionar qual grupo de usuários terá permissão para executar imagem na tela da aplicação.	Todos os grupos

As propriedades Topo, Esquerda, Largura, Altura e Título tem seus valores default definidos no momento da criação do objeto. Então, esses valores podem variar para os diferentes tipos de objeto.

Propriedades Específicas
Propriedade	Descrição	Default
Utiliza lista de imagem global	Define se o objeto utilizará lista de imagem global ou não. Opções: Sim - Um novo campo “Lista Imagem” será apresentado no lugar do campo “Imagem default”. Não - O usuário pode inserir itens do tipo Image para serem utilizados pelo objeto. É apresentado o campo “Imagem default” no lugar de “Lista Imagem”.	Não
Imagem default	Define uma imagem que será apresentada no objeto, se o valor do Tag associado não for definido em nenhum item Image.	(Nenhuma)
Lista imagem	Neste campo deve-se inserir o nome da Listas de imagens globais a ser utilizada pelo objeto.	(Nenhum)
Transparente	Define a transparência da imagem para a cor determinada no pixel localizado no canto inferior esquerdo da figura. Se o valor do atributo “Transparente” for definido como “sim”, em toda a imagem a cor em questão não será apresentada.	Não
Alinhamento	Define o alinhamento da imagem dentro da tela corrente. Opções: Nenhum – Sem alinhamento. Parte Superior – Posiciona a imagem na parte superior da tela corrente. Parte Inferior – Posiciona a imagem na parte inferior da tela corrente. Lateral Esquerda – Posiciona a imagem junto à margem esquerda da tela. Lateral Direita – Posiciona a imagem junto à margem direita da tela. Ao cliente – Ajusta-se a imagem ao tamanho datela corrente.	Nenhum
Dimensão da imagem	Define a apresentação da imagem na tela em relação ao tamanho do controle. Opções: Mantém tamanho do controle - Apresenta conteúdo referente à área do controle independente do tamanho da imagem. Mantém tamanho da imagem. Mantém o tamanho da imagem - Apresenta a imagem completa independente do tamanho do controle. Ajusta imagem ao controle - Redimensiona a imagem ao tamanho do controle.	Mantém o tamanho da imagem
Intervalo(ms) de animação	Define o intervalo de tempo em milissegundos utilizado para alterar a imagem corrente a ser apresentada ao usuário durante a animação. O valor “zero” desabilita a animação da imagem. Valores entre 1 e 20 ms são tratados como 20 ms (intervalo mínimo permitido para animação).	0

Intervalo de animação: Pode ser utilizado quando não há Tag associado à lista de imagens e os itens do tipo “Image” estão com o atributo valor igual a zero. Neste caso, se o intervalo de animação for maior ou igual a 20, os itens do tipo “Image” serão apresentados sequencialmente respeitando o tempo definido.

Tags
Propriedade	Descrição	Default
Nome Tag	Nome do Tag associado ao objeto.	(Nenhum)
Índice	Offset para o valor do Tag associado caso ele seja um vetor.	1

Eventos
Propriedade	Descrição	Default
On Click	Ação a ser executada após o evento de um clique simples sobre o objeto. Necessita do nome do script a ser executado. Este campo não é obrigatório.	(Nenhum)
On MouseDown	Compativel com HIscada Pro versão >= 1.2.08. Executa uma ação após o evento de mouse pressionado. Necessita do nome do script a ser executado publicando as propriedades X, Y, Button e Shift. Este campo não é obrigatório. (Clique em Eventos: OnMouseDown e OnMouseUp para mais informações)	(Nenhum)
On MouseUp	Compativel com HIscada Pro versão >= 1.2.08. Executa uma ação após o evento de mouse solto publicando as propriedades X, Y, Button e Shift. Necessita do nome do script a ser executado. Este campo não é obrigatório. (clique em Eventos: OnMouseDown e OnMouseUp para mais informações).	(Nenhum)

Propriedade compatível a partir da versão 1.2.08

Image

Item utilizado para definição da imagem a ser apresentada dentro do item ImageList. Válido somente quando não há definição de lista de imagem.

Identificação
Propriedade	Descrição	Default
Nome do item	Define o nome do item que será exibido na árvore do painel de projeto e será utilizado quando necessário referenciar o mesmo.	Item_NNN
Comentário	Permite a inclusão de um comentário acerca do objeto. Este campo não é obrigatório.	(Nenhum)

Propriedades Específicas do objeto
Propriedade	Descrição	Default
Sem Imagem	Define se o item contém ou não imagem. Pode ser utilizado como parâmetro nulo durante uma animação, onde, neste caso o tempo de transição do item será contabilizado mas nenhuma imagem será apresentada. Exemplo: Animação para piscar um item na tela. Opções: Sim - Define item sem imagem Não - Define item com imagem e apresenta um campo para definição do arquivo de imagem.	Não
Imagem	Nome do arquivo de imagem a ser carregado. Para localizar o arquivo clique no botão (…) disponível à direita do campo.	(Nenhum)
Valor	Valor associado ao texto.	0

Imagem: Os arquivos de imagem devem ser armazenados no diretório do projeto em (…publ\res\images). Caso o arquivo selecionado esteja em um outro local uma mensagem será exibida solicitando ao usuário a permissão para que a imagem seja copiada para o diretorio de imagens do projeto corrente.

---

API Lua

A lista das propriedades e atributos deste e outros componentes estão documentadas em Scripts e Acesso a atributos e funções de Componentes de Tela. A seguir apresentamos as tabelas com as propriedades e atributos de gerenciamento que podem ser utilizados via scripts, para o objeto descrito nessa página:

Atributos Comuns

São apresentados neste item os atributos que são comuns à grande maioria dos componentes de tela.

Atributos Comuns
Nome da Propriedade	Descrição
Visible	Torna o componente visível ou não.
Enabled	Habilita ou não a interação com o componente.
Top	Distância em pixels do topo do componente ao topo da tela em que está contido.
Left	Distância em pixels da lateral esquerda do componente à lateral esquerda da tela em que está contido.
Width	Largura em pixels do componente.
Height	Altura em pixels do componente.
Arguments	Texto preenchido no IDE na propriedade Argumentos.

ImageList

Edit
Propriedades Específicas	Descrição
TimeInterval	Especifica o intervalo de tempo em milissegundos utilizado pelo objeto para alterar as imagens ativas. O valor mínimo para este parâmetro é de 20 milissegundos. Quando especificado o valor “zero” para este parametro, o objeto para de atualizar as imagens, mantendo na tela a última imagem selecionada. Este atributo pode ser lido ou escrito.

Exemplo de uso:

-- Obtem a tela corrente
local screen = Sender.Screen

-- Imprime o valor corrente do atributo
print('Valor atual= ' .. tostring(screen.ImageList_001.TimeInterval))

-- Define um novo intervalo de alteração das imagens de 250 milissegundos
screen.ImageList_001.TimeInterval = 250

Ver também

• Telas Sinópticas

• Lista completa dos objetos de tela