Adicionar controle de imagem em aplicativos de tela

Tira uma foto ou carrega imagens do dispositivo local.

Description

Com esse controle, os usuários podem tirar fotos ou fazer upload de arquivos de imagem de seus dispositivos e atualizar a fonte de dados com esse conteúdo. Em um dispositivo móvel, o usuário recebe a caixa de diálogo de escolha do dispositivo para escolher entre tirar uma foto ou selecionar uma já disponível.

Esse controle é um controle agrupado que contém dois controles: um Image e um botão Add picture. O controle Image mostra a imagem carregada ou um espaço reservado se nenhuma imagem tiver sido carregada. O botão Adicionar imagem solicita o carregamento de uma imagem.

Consulte a referência de controle Image para propriedades de image .

Limitações

O controle de imagem tem estas limitações:

• Ao usar o controle Adicionar Imagem no iOS, as imagens importadas usando a câmera ou a galeria não contêm metadados como orientação, informações de localização ou configurações da câmera.

Adicionar propriedades do botão de imagem

AccessibleLabel – Etiqueta para leitores de tela. Deve descrever a finalidade da adição de uma imagem.

Alinhar – A localização do texto em relação ao centro horizontal de seu controle.

BorderColor – A cor da borda de um controle.

BorderStyle – Se a borda de um controle é Sólida, Tracejada, Pontilhada ou Nenhuma.

BorderThickness – A espessura da borda de um controle.

ChangePictureText – Texto que aparece no botão quando uma imagem foi carregada.

Cor – A cor do texto em um controle.

DisabledBorderColor – A cor da borda de um controle se a propriedade DisplayMode do controle estiver definida como Disabled.

DisabledColor – A cor do texto em um controle se sua propriedade DisplayMode estiver definida como Disabled.

DisabledFill – A cor de plano de fundo de um controle se sua propriedade DisplayMode estiver definida como Disabled.

DisplayMode – Se o controle permite a entrada do usuário (Editar), exibe apenas dados (View) ou está desativado (Disabled).

Erro - Se houver um problema ao carregar uma imagem, essa propriedade conterá uma cadeia de erro apropriada.

Preenchimento – A cor de fundo de um controlo.

FocusedBorderColor – A cor da borda de um controle quando o controle está focado.

FocusedBorderThickness – A espessura da borda de um controle quando o controle está focado.

Fonte – O nome da família de fontes na qual o texto aparece.

FontWeight – O peso do texto em um controle: negrito, seminegrito, normal ou mais leve.

Altura – A distância entre as bordas superior e inferior de um controle.

HoverBorderColor – A cor da borda de um controle quando o usuário mantém o ponteiro do mouse nesse controle.

HoverColor – A cor do texto em um controle quando o usuário mantém o ponteiro do mouse sobre ele.

HoverFill – A cor de fundo de um controle quando o usuário mantém o ponteiro do mouse sobre ele.

Itálico – Se o texto em um controle está em itálico.

Mídia – Um identificador para o clipe que um controle de áudio ou vídeo reproduz.

OnChange – Ações a serem executadas quando o usuário altera o valor de um controle (por exemplo, ajustando um controle deslizante).

OnSelect – Ações a serem executadas quando o usuário toca ou clica em um controle.

Preenchimento – A distância entre o texto em um botão de importação ou exportação e as bordas desse botão.

PressedBorderColor – A cor da borda de um controle quando o usuário toca ou clica nesse controle.

PressedColor – A cor do texto em um controle quando o usuário toca ou clica nesse controle.

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

Redefinir – Se um controle reverte para seu valor padrão.

Tamanho – O tamanho da fonte do texto que aparece em um controle.

Tachado – Se uma linha aparece através do texto que aparece em um controle.

TabIndex – Ordem de navegação do teclado em relação a outros controles.

Texto – Texto que aparece no botão quando uma imagem não foi carregada.

Dica de ferramenta – Texto explicativo que aparece quando o usuário passa o mouse sobre um controle.

Sublinhado – Se uma linha aparece sob o texto que aparece em um controle.

UseMobileCamera – Se deve usar uma câmera móvel diretamente, quando disponível. Definir isso como TRUE força os usuários a tirar uma foto usando a câmera e desativa o upload de imagens existentes da galeria do dispositivo.

VerticalAlign – A localização do texto em um controle em relação ao centro vertical desse controle.

Visível – Se um controle aparece ou está oculto.

Largura – A distância entre as bordas esquerda e direita de um controle.

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 )

Examples

Adicionar imagens a um controle de galeria de imagens

1. Adicione um controle Adicionar imagem e clique três vezes nele.

   Não sabe como adicionar, nomear e configurar um controle?

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 controle Button , mova-o sob o controle Add picture e defina a propriedade OnSelect do controle Button para esta fórmula:
   Coletar(MyPix, AddMediaButton1.Media)

   Deseja obter mais informações sobre a função Coletar ou outras funções?

4. Adicione um controle de galeria vertical e defina sua propriedade Items como MyPix.

5. Selecione o controle Image na galeria e defina sua propriedade Image como ThisItem.Value.

6. Prima F5 e, em seguida, clique ou toque no controlo Button .

   A imagem do controle Add picture aparece no controle Galeria Vertical . Se sua imagem não tiver a mesma proporção que o controle Image no controle Galeria vertical , defina a propriedade ImagePosition do controle Image como Fit.

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 controle Galeria de imagens .

8. (facultativo) Repita a etapa anterior uma ou mais vezes e retorne ao espaço de trabalho padrão pressionando Esc.

Use a função SaveData para salvar as imagens localmente ou a função Patch para atualizar uma fonte de dados.

Diretrizes de acessibilidade

Aplicam-se as mesmas diretrizes para Button e Image . Além disso, considere o seguinte:

Contraste de cor

• O botão Adicionar imagem deve ter um contraste adequado entre o texto e o plano de fundo. Como a imagem carregada pode ter cores variadas, use um Preenchimento opaco no botão Adicionar imagem para garantir um contraste consistente.

Suporte a leitor de ecrã

• O botão Adicionar imagem deve ter Text e ChangePictureText que solicita que o usuário adicione ou altere uma imagem.

Suporte de teclado

• O botão Adicionar imagem deve ter TabIndex igual ou superior a zero para que os usuários do teclado possam navegar até ele.
• O botão Adicionar imagem deve ter indicadores de foco claramente visíveis. Use FocusedBorderColor e FocusedBorderThickness para conseguir isso.