Controle Adicionar imagem em aplicativos de tela
Tira uma foto ou carrega imagens a partir do dispositivo local.
Descrição
Com esse controle, os usuários podem tirar fotos ou carregar arquivos de imagem a partir de seu dispositivo e atualizar a fonte de dados com esse conteúdo. Em um dispositivo móvel, o usuário é apresentado com o diálogo de escolha do dispositivo para escolher entre tirar uma foto ou selecionar uma já disponível.
Esse é um controle agrupado que contém dois controles: um Imagem e um Adicionar imagem button. O controle Imagem mostra a imagem carregada ou um espaço reservado, se nenhuma imagem foi carregada. O botão Adicionar imagem solicita que uma imagem seja carregada.
Consulte a Referência de controle Imagem para as propriedades Image.
Limitações
O controle de imagem tem estas limitações:
- Durante o uso do 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 sobre localização ou configurações da câmera.
Propriedades do botão Adicionar imagem
AccessibleLabel – rótulo para leitores de tela. Deve descrever a finalidade de adicionar uma imagem.
Align – a localização do texto em relação ao centro horizontal do respectivo controle.
BorderColor – a cor da borda do controle.
BorderStyle – se a borda do controle é Sólida, Tracejada, Pontilhada ou Nenhuma.
BorderThickness – a espessura da borda do controle.
ChangePictureText – texto que aparece no botão quando uma imagem foi carregada.
Color – a cor do texto em um controle.
DisabledBorderColor – a cor da borda de um controle se a propriedade DisplayMode do controle estiver definida como Desabilitado.
DisabledColor – a cor do texto em um controle se sua propriedade DisplayMode estiver definida como Desabilitado.
DisabledFill – a cor da tela de fundo de um controle se sua propriedade DisplayMode estiver definida como Desabilitado.
DisplayMode – se o controle permite entrada do usuário (Edição), apenas exibe dados (Exibição), ou está desabilitado (Desabilitado).
Error – se houver um problema ao carregar uma imagem, essa propriedade conterá uma cadeia de caracteres de erro apropriada.
Fill – a cor da tela de fundo de um controle.
FocusedBorderColor – a cor da borda do controle quando ele está focalizado.
FocusedBorderThickness – A espessura da borda de um controle quando ele está focalizado.
Font – o nome da família de fontes em que o texto é exibido.
FontWeight – o peso do texto em um controle: Negrito , Seminegrito, Normal ou Mais claro.
Height – a distância entre a parte superior do controle e as bordas inferiores.
HoverBorderColor – a cor da borda do 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 da tela de fundo de um controle quando o usuário mantém o ponteiro do mouse sobre ele.
Italic – se o texto em um controle está em itálico.
Media – um identificador para o clipe que um controle Áudio ou Vídeo reproduz.
OnChange – ações a serem executadas quando o usuário alterar o valor de um controle (por exemplo, ajustando um controle deslizante).
OnSelect – Ações a serem executadas quando o usuário tocar ou clicar em um controle.
Padding – a distância entre o texto em um botão de importação ou exportação e as bordas do botão.
PressedBorderColor – a cor da borda do 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 da tela de fundo de um controle quando o usuário toca ou clica nesse controle.
Reset – se um controle é revertido para seu valor padrão.
Size – o tamanho da fonte do texto que aparece em um controle.
Strikethrough – se uma linha é exibida cortando o texto que aparece em um controle.
TabIndex – ordem de navegação do teclado em relação a outros controles.
Text – texto que aparece no botão quando uma imagem não foi carregada.
Tooltip – texto explicativo exibido quando o usuário passa o mouse sobre um controle.
Underline – se uma linha é exibida sob o texto que aparece em um controle.
UseMobileCamera – se você deseja usar uma câmera móvel diretamente, quando disponível. Por dispositivos Android, essa propriedade requer a configuração experimental Captura de Mídia Aprimorada ativada.
VerticalAlign – a localização do texto em um controle em relação ao centro vertical desse controle.
Visible – se um controle é exibido ou está oculto.
Width – a distância entre as bordas esquerda e direita de um controle.
X – a distância entre a borda esquerda de um controle e a borda esquerda de seu contêiner pai (ou a tela, se não houver contêiner pai).
Y – a distância entre a borda superior de um controle e a borda superior de seu contêiner pai (ou a tela, se não houver contêiner pai).
Funções relacionadas
Patch( DataSource, BaseRecord, ChangeRecord )
Exemplos
Adicionar imagens a um controle Galeria de imagens
Adicione um controle Adicionar imagem e clique três vezes nele.
Não sabe como adicionar, nomear e configurar um controle?
Na caixa de diálogo Abrir, clique ou toque em um arquivo de imagem e depois clique ou toque em Abrir.
Adicione um controle Botão, mova-o no controle Adicionar imagem e defina a propriedade OnSelect para o controle Botão como esta fórmula:
Collect(MyPix, AddMediaButton1.Media)Deseja obter mais informações sobre a função Collect ou outras funções?
Adicione um controle Galeria vertical e defina sua propriedade Items como MyPix.
Selecione o controle Imagem na galeria e configure sua propriedade Image como ThisItem.Value.
Pressione F5 e clique ou toque no controle Botão.
A imagem do controle Adicionar imagem aparece no controle Galeria Vertical. Se a imagem não tiver a mesma proporção que o controle Imagem no controle Galeria vertical, defina a propriedade ImagePosition do controle Imagem como Ajustar.
Clique ou toque no controle Adicionar imagem, clique ou toque em outro arquivo de imagem, clique ou toque em Abrir e, em seguida, no controle Botão que você adicionou.
A segunda imagem aparece no controle Galeria de imagens.
(opcional) Repita a etapa anterior uma ou mais vezes e, em seguida, 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
As mesmas diretrizes para Botão e Imagem se aplicam. Além disso, considere o seguinte:
Contraste de cores
- O botão Adicionar imagem precisa ter contraste suficiente entre o texto e a tela de fundo. Como a imagem carregada pode ter cores diferentes, use Fill (preenchimento) opaco no botão Adicionar imagem para garantir a consistência do contraste.
Suporte ao leitor de tela
- O botão Adicionar imagem precisa ter Text e ChangePictureText que solicitam que o usuário adicione ou altere uma imagem.
Suporte de teclado
- O botão Adicionar imagem precisa ter TabIndex de zero ou maior para que os usuários de teclado possam navegar para ele.
- O botão Adicionar imagem precisa ter indicadores de foco evidentes. Use FocusedBorderColor e FocusedBorderThickness para fazer isso.
Observação
Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)
A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).