Controlo Adicionar imagem em aplicações de tela

Tira uma fotografia ou carrega imagens do dispositivo local.

Descrição

Com este controlo, os utilizadores podem tirar fotografias ou carregar ficheiros de imagem dos seus dispositivos e atualizar a origem de dados com este conteúdo. Num dispositivo móvel, é apresentada ao utilizador uma caixa de diálogo de escolha do dispositivo para escolher entre tirar uma fotografia ou selecionar uma já disponível.

Este controlo é um controlo agrupado que contém dois controlos: Imagem e botão Adicionar imagem. O controlo Imagem mostra a imagem carregada ou um marcador de posição se nenhuma imagem tiver sido carregada. O botão Adicionar imagem solicita que uma imagem seja carregada.

Veja a Image control reference para as propriedades Image.

Limitações

O controlo da imagem tem as seguintes limitações:

• Ao utilizar o controlo Adicionar imagem no iOS, as imagens importadas através da câmara ou da galeria não contêm metadados, como orientação, informações de localização e definições da câmara.

Propriedades do botão Adicionar imagem

AccessibleLabel – a etiqueta para os leitores de ecrãs. Deve descrever a finalidade de adicionar uma imagem.

Align – a localização de texto em relação ao centro horizontal do seu controlo.

BorderColor – a cor do limite de um controlo.

BorderStyle – se o limite do controlo é Sólido, Tracejado, Com pontos ou Nenhum.

BorderThickness – a espessura do limite de um controlo.

ChangePictureText – o texto que aparece no botão quando uma imagem tiver sido carregada.

Color – a cor do texto num controlo.

DisabledBorderColor – a cor do limite de um controlo se a propriedade DisplayMode do controlo estiver definida como Desativada.

DisabledColor – a cor do texto num controlo se a respetiva propriedade DisplayMode estiver definida como Desativada.

DisabledFill – a cor de fundo de um controlo se a respetiva propriedade DisplayMode estiver definida como Desativada.

DisplayMode – se o controlo permite a intervenção do utilizador (Editar), apenas apresenta os dados (Visualizar), ou está desativado (Desativado).

Error - se houver um problema ao carregar uma imagem, esta propriedade irá conter uma cadeia de erro adequada.

Fill – a cor de fundo de um controlo.

FocusedBorderColor – a cor do limite de um controlo quando o controlo é destacado.

FocusedBorderThickness – a espessura do limite de um controlo quando o controlo é destacado.

Font – o nome da família dos tipos de letra que aparecem no texto.

FontWeight – a espessura do texto num controlo: Negrito, Seminegrito, Normal ou Mais leve.

Height – a distância entre as margens superiores e inferiores de um controlo.

HoverBorderColor – a cor do limite de um controlo quando o utilizador mantém o ponteiro do rato nesse controlo.

HoverColor – a cor do texto num controlo quando o utilizador mantém o ponteiro do rato no mesmo.

HoverFill – a cor de fundo de um controlo quando o utilizador mantém o ponteiro do rato no mesmo.

Italic – se o texto num controlo estiver em itálico.

Media – um identificador do clip reproduzido por um controlo Áudio ou Vídeo.

OnChange – Ações a realizar quando o utilizador altera o valor de um controlo (por exemplo, ao ajustar um controlo de deslize).

OnSelect– Ações a realizar quando o utilizador toca ou clica num controlo.

Padding – a distância entre o texto num botão de importação ou exportação e as margens desse botão.

PressedBorderColor – a cor do limite de um controlo quando o utilizador toca ou clica nesse controlo.

PressedColor – a cor do texto num controlo quando o utilizador toca ou clica nesse controlo.

PressedFill – a cor de fundo de um controlo quando o utilizador toca ou clica nesse controlo.

Reset – se um controlo é revertido para o valor predefinido.

Size – o tamanho do tipo de letra do texto que é apresentado num controlo.

Strikethrough – se é apresentada uma linha no meio do texto que aparece num controlo.

TabIndex – a ordem de navegação no teclado em relação a outros controlos.

Text – o texto que aparece no botão quando uma imagem não tiver sido carregada.

Tooltip – o texto explicativo que aparece quando o rato passa por cima de um controlo.

Underline – se é apresentada uma linha sob o texto que aparece num controlo.

UseMobileCamera – se deve utilizar uma câmara fotográfica móvel diretamente, quando disponível. Para dispositivos Android, esta propriedade necessita da definição experimental Captura de Multimédia Melhorada ativada.

VerticalAlign – a localização de texto num controlo em relação ao centro vertical desse controlo.

Visible – se um controlo é apresentado ou está oculto.

Width – a distância entre as margens esquerda e direita de um controlo.

X – a distância entre o limite esquerdo de um controlo e o limite esquerdo do respetivo recipiente principal (do ecrã, se não existir um recipiente principal).

Y – a distância entre o limite superior de um controlo e o limite superior do recipiente principal (do ecrã, se não existir um recipiente principal).

Funções relacionadas

Patch( DataSource, BaseRecord, ChangeRecord )

Exemplos

Adicionar imagens a um controlo Galeria de imagens

1. Adicione um controlo Adicionar imagem e, em seguida, clique três vezes nele.

   Não sabe como adicionar, atribuir um nome e configurar um controlo?

2. Na caixa de diálogo Abrir, clique ou toque num ficheiro de imagem e, em seguida, clique ou toque em Abrir.

3. Adicione um controlo Botão, mova-o para baixo do controlo Adicionar imagem e defina a propriedade OnSelect do controlo Botão para esta fórmula:
   Collect(MyPix, AddMediaButton1.Media)

   Pretende obter mais informações sobre a função Collect ou outras funções?

4. Adicione um controlo Galeria vertical e defina a respetiva propriedade Items para MyPix.

5. Selecione o controlo Imagem na galeria e defina a propriedade Image como ThisItem.Value.

6. Prima F5 e, em seguida, clique ou toque no controlo Botão.

   A imagem do controlo Adicionar imagem aparece no controlo Vertical Galeria. Se a imagem não tiver a mesma proporção do controlo Imagem no controlo Galeria vertical, defina a propriedade ImagePosition e o controlo Imagem para Ajustar.

7. Clique ou toque no controlo Adicionar imagem, clique ou toque noutro ficheiro de imagem, clique ou toque em Abrir e, em seguida, clique ou toque no controlo Botão que adicionou.

   A segunda imagem aparece no controlo Galeria de imagens.

8. (opcional) Repita o passo anterior uma ou várias vezes e, em seguida, regresse à área de trabalho predefinida, premindo Esc.

Utilize a função SaveData para guardar as imagens localmente, ou a função Patch para atualizar uma origem de dados.

Diretrizes de acessibilidade

Aplicam-se as mesmas diretrizes para Botão e Imagem. Além disso, considere o seguinte:

Contraste de cor

• botão Adicionar imagem tem de ter um contraste adequado entre o texto e o fundo. Uma vez que a imagem carregada pode ter cores variáveis, utilize um Fill opaco no botão Adicionar imagem para garantir um contraste consistente.

Suporte a leitor de ecrã

• O botão Adicionar imagem tem de ter Text e ChangePictureText que pede ao utilizador para adicionar ou alterar uma imagem.

Suporte de teclado

• O botão Adicionar imagem tem de ter TabIndex igual a zero ou superior para que os utilizadores do teclado possam navegar nele.
• O botão Adicionar imagem tem de ter indicadores de foco claramente visíveis. Utilize FocusedBorderColor e FocusedBorderThickness para o conseguir.