Imagem

Com este componente torna-se possível exibir imagens no formulário.

Imagem:

Propriedades em comum:

Propriedade	Descrição	Tipo	Exemplo
Altura	Define a altura do componente	Inteiro	250
Código	Informa o código gerado pelo Maker ao qual o componente/formulário foi associado. De forma geral, não interfere nas características do componente.	Inteiro	5
Container	Informa em qual container o componente irá ser inserido.	Indefinido
Dica	Armazena uma dica para o componente, o qual se torna acessível no modo de inserção ou alteração.	Letras	"Digite o CPF do cliente"
Habilitado	Torna o componente possível ser editado ou manipulado.	Lógico	Sim
PosiçãoX e PosiçãoY	O "X" determina a posição do componente em relação à esquerda do formulário, e o "Y" em relação ao topo.	Inteiro	100
Tabulação	Indica a ordem de tabulação do componente em relação aos outros que compõem a aba do formulário na qual está posto. Essa ordem pode ser observada quando o usuário altera o estado do formulário/grade para o modo de inclusão ou edição e navega entre os componentes/campos usando a tecla Tab.	Inteiro	2
Tabular	Selecionando a opção Sim, quando o usuário estiver navegando entre os componentes, como foi descrito no item anterior, o componente receberá foco (observada a ordem de tabulação).	Lógico	Sim
Tamanho	Aplicado a todos - determina a largura do componente ou formulário.	Inteiro	100
Visível	Aplicada a todos os componentes, com exceção da Moldura e do objeto formulário - Selecionando a opção Sim, o componente aparece no formulário.	Lógico	Sim
Nome	Aplicada a todos os componentes e para o objeto formulário - apresenta o nome do componente. O Maker sugere um nome diferente dos nomes dos componentes existentes no formulário para evitar que mais de um componente possua o mesmo nome.	Letras	"Tabela de Consumidores"
Descrição	Aplicada a todos os componentes exceto para os componentes Árvore, Grade, Moldura, Imagem e para o objeto formulário - É a legenda que aparece sobre o componente para identificar (resumidamente) qual a sua função. Observação: Ao selecionar um determinado campo o Maker irá sugerir uma descrição obtida no dicionários de dados, caso o usuário deseje deixar o campo da descrição em branco basta apagá-lo e clicar fora do componente.	Letras	"Insira aqui a idade do consumidor"

Propriedades específicas do componente Imagem:

Propriedade	Descrição	Tipo	Exemplo
Lente de Aumento	Possibilita a vinculação de uma lente de aumento ao componente imagem.	Lógico	Não
Altura do Zoom	Determina o zoom da altura da imagem. Só é visível quando a propriedade Tipo de Exibição está configurada como Galeria.	Inteiro	0
Largura do Zoom	Determina o zoom da Largura da imagem. Só é visível quando a propriedade Tipo de Exibição está configurada como Galeria.	Inteiro	0
Exibição da Imagem	Essa propriedade altera o tamanho da imagem na área do componente. Selecionando a opção: - Normal: Exibe a imagem em seu tamanho original. - Estender: Redimensiona a imagem de modo que ocupe todo o espaço do componente, esticando a imagem caso necessário. - Ajustar: Redimensiona a imagem preenchendo todo o espaço do componente, preservando sua proporção. - Preencher: Redimensiona a imagem preenchendo todo o espaço do componente, ajustando ou cortando a proporção. - Repetir: Repete a imagem em todo o espaço do componente. - Repetir na Horizontal: Repete a mesma imagem lado a lado até o limite horizontal do componente.	Lista	Estender
Posição da Imagem	Essa propriedade altera a posição da imagem dentro da área do componente. Valores possíveis para essa propriedade: - Centralizado: Centraliza a imagem no centro do componente. - Esquerda: Altera a posição da imagem para a esquerda do componente. - Direita: Altera a posição da imagem para a direita do componente. - Topo: Altera a posição da imagem para o topo do componente. - Base: Altera a posição da imagem para a base do componente.	Lista	Centralizado
Redimensionar Imagem	Essa propriedade determinará o tamanho e a altura máxima que uma imagem poderá ter. As dimensões precisarão ser separadas por (;). Quando a imagem selecionada for maior que as dimensões definidas no parâmetro, a imagem será redimensionada para os valores definidos.	Letras	100;50
Impressão Digital	Utilizada para informar o campo (fonte de dados vinculada ao formulário) no qual será gravado o código da impressão digital.	Letras	campo_digital
Tipo de Exibição	Disponibiliza as opções: - Desktop: Quando marcada esta opção e tendo sido informado o nome do campo (propriedade Campo) ao qual o componente Imagem está associado, após a efetuação de dois cliques sobre o componente, será possível a seleção de uma imagem contida em qualquer parte do computador. - Galeria: Quando marcada esta opção, o Webrun coderánsiderará a imagem escolhida na propriedade Imagem. Ao clicar sobre o componente, será aberta uma nova janela contendo a imagem, a qual po ser redimensionada (através da borda da janela), fornecendo suporte para uma melhor visualização. - Nenhum: Quando marcada esta opção, será possível a sobreposição de outros componentes sobre o componente Imagem.	Lista	Desktop
URL	Utilizada para apresentar uma imagem contida em qualquer site, bastando para isso que o usuário informe o endereço no qual ela pode ser encontrada.	Letras	imagem.png
Imagem	Permite a seleção de uma imagem da Galeria de Imagens para exibição. A imagem a ser selecionada deve existir na Galeria de Imagens. Para vincular uma imagem, selecione a imagem (a imagem ficará com a borda laranjada) e clique no botão Selecionar (imagens podem ser gravadas no Maker pela opção Galeria de Imagens do menu Projeto). Para desvincular uma imagem do formulário, clique no botão Nenhum.	Imagem	imagem.png

Este componente possui quatro Propriedades que controlam a forma de exibição da imagem:

Associe a um campo da origem do formulário para armazenar uma imagem (podendo ser uma foto) por meio da propriedade Campo;
Associe a um campo da origem do formulário para armazenar uma imagem (da digital, utilizando um leitor biométrico) por meio da propriedade Impressão digital;
Associe a uma imagem fixa, por meio da propriedade Imagem;
Associe a uma imagem fixa, informado o endereço e nome na Web, por meio da propriedade URL.

Estando o Formulário em modo de inclusão ou alteração:

Ao posicionar o mouse sobre o componente, aparecem dois botões na parte inferior direita dele. Com relação ao:
- Primeiro botão - ao receber um clique, aparece a tela Webrun Digital Capture. Nela consta a área da imagem capturada por uma webcam (instalada no computador em que está sendo usado o Webrun) e o botão Capturar Imagem. Ao clicar nele, será capturada a imagem que estava sendo transmitida pela webcam. Por fim, é necessário fechar a tela para que a imagem capturada apareça no componente Imagem;
- Segundo botão - ao receber um clique, aparece a tela Ampliar imagem (na janela que envolve esta tela pode-se utilizar o botão Maximizar da barra de título, a fim de que a imagem seja visualizada em tamanho maior).
- Tendo sido preenchida a propriedade Campo deste componente no Maker, ao ser efetuado um clique sobre ele, aparecerá a tela Escolha a imagem, na qual consta:
- - Campo Caminho da Imagem - local no qual deve ser informado manualmente o caminho da imagem que será armazenada no campo;
  - Botão Procurar - ao receber um clique, aparece a tela Escolher Arquivo, a partir da qual se pode escolher a imagem (caminho do arquivo) que será armazenada no campo;
  - Botão Modificar - tendo sido definido o local em que se encontra a imagem (campo Caminho da Imagem), ao receber um clique, a imagem é carregada no componente, mas a sua gravação no campo só se efetiva após a gravação da inserção ou da alteração do registro no formulário;
  - Botão Webcam - ao receber um clique, aparece a tela Webrun Digital Capture. Nela consta a área da imagem capturada por uma webcam (instalada no computador em que está sendo usado o Webrun) e o botão Capturar Imagem. Ao clicar nele, será capturada a imagem que estava sendo transmitida pela webcam. Por fim, é necessário fechar a tela para que a imagem capturada apareça no componente Imagem;
  - Botão Nenhuma - remove a imagem que estava carregada no componente.

Caso o componente seja alterado dinamicamente, os dois botões que apareciam ao posicionar o mouse sobre o componente não serão exibidos.

Associando o caminho da imagem na consulta SQL

A partir da versão 3, é possível acrescentar o caminho relativo de uma imagem em uma consulta SQL e associá-la ao componente Imagem, desta forma, o Webrun buscará a imagem no caminho descrito. Ex.:

Para o SQL abaixo:

Select
   fr_acao.aco_codigo,
   fr_acao.aco_nome,
   'Skins/Default/advanced\_query.gif' As "Imagem"
From
   fr_acao

Se associarmos o componente Imagem ao campo "Imagem" do SQL acima, o Webrun exibirá a imagem 'advanced_query.gif' relativa ao seu contexto.

Observações:

Ao obter uma imagem em um fluxo na camada servidor, a mesma não pode ser passada para um fluxo na camada cliente.
As imagens capturadas através da Webcam são armazenadas na pasta Upload no contexto do Webrun.
A propriedade Descrição não tem efeito para o componente Imagem.
Para que a imagem fique atrás de outro componente clique com o botão direito do mouse sobre o componente Imagem e em Propriedade selecione a opção Tipo de Exibição como Nenhum e, em seguida, selecione a opção Controles e clique em Trazer para frente.
Quando um componente imagem está vinculado a um campo não é possível definir seu modo de exibição, sendo que por padrão o modo de exibição será "Estendido”.
Não é possível obter o valor de um campo Imagem e atribuir diretamente a um componente imagem, pois o valor gravado no banco é do tipo binário, assim sendo necessário que o valor seja guardado em um arquivo, como mostra o exemplo.
O componente imagem é um componente que não recebe foco.

A partir da versão 3 do Webrun, é possível acrescentar o caminho relativo de uma imagem em uma consulta SQL e associá-la ao componente Imagem, desta forma, o Webrun buscará a imagem no caminho descrito. Ex.:

Para o SQL abaixo:

Select
   fr_acao.aco_codigo,
   fr_acao.aco_nome,
   'Skins/Default/advanced\_query.gif' As "Imagem"
From
   fr_acao

Ao associar o componente Imagem ao campo "Imagem" do SQL acima, o Webrun exibirá a imagem 'advanced_query.gif' relativa ao seu contexto.

Propriedades e Eventos em comum aos Objetos