Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Tira uma foto ou carrega imagens do dispositivo local.
Description
Com esse controle, os usuários podem tirar fotos ou carregar arquivos de imagem de seu dispositivo 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: uma imagem e um botão Adicionar imagem. O controle Imagem mostra a imagem carregada ou um espaço reservado se nenhuma imagem tiver sido carregada. O botão Adicionar imagem solicita que uma imagem seja carregada.
Consulte a referência de controle de imagem para propriedades de imagem .
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 de câmera.
Adicionar propriedades do botão de imagem
AccessibleLabel – Rótulo para leitores de tela. Deve descrever a finalidade de adicionar uma imagem.
Alinhar – o local 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 é Solid, Dashed, Dotted ou None.
BorderThickness – A espessura da borda de um controle.
ChangePictureText – Texto que aparece no botão quando uma imagem é 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 Desabilitada.
DisabledColor – A cor do texto em um controle se sua propriedade DisplayMode estiver definida como Desabilitada.
DisabledFill – A cor da tela de fundo de um controle se sua propriedade DisplayMode estiver definida como Desabilitada.
DisplayMode – se o controle permite a entrada do usuário (Editar), exibe apenas dados (Exibição) ou está desabilitado (Desabilitado).
Erro – 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 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 em que o texto é exibido.
FontWeight – O peso do texto em um controle: Negrito, Semiaberto, 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 da tela 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 é 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 da tela de fundo de um controle quando o usuário toca ou clica nesse controle.
Redefinição – se um controle é revertido para seu valor padrão.
Tamanho – o tamanho da fonte do texto que aparece em um controle.
Tachado – se uma linha aparece por meio 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 exibido 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 desabilita o carregamento de imagens existentes da galeria de dispositivos.
VerticalAlign – o local 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 a borda esquerda de um controle e a borda esquerda de seu contêiner pai (tela, se nenhum contêiner pai).
Y – a distância entre a borda superior de um controle e a borda superior do contêiner pai (tela, se nenhum contêiner pai).
Funções relacionadas
Patch( DataSource, BaseRecord, ChangeRecord )
Exemplos
Adicionar imagens a um controle da 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 clique ou toque em Abrir.
Adicione um controle Button , mova-o sob o controle Adicionar imagem e defina a propriedade OnSelect para o controle Button para esta fórmula:
Collect(MyPix, AddMediaButton1.Media)Deseja obter mais informações sobre a função Coletar ou outras funções?
Adicione um controle de galeria vertical e defina sua propriedade Items como MyPix.
Selecione o controle Imagem na galeria e defina sua propriedade Image como ThisItem.Value.
Pressione F5 e clique ou toque no controle Botão .
A imagem do controle Adicionar imagem é exibida no controle Galeria Vertical . Se sua imagem não tiver a mesma taxa de proporção que o controle Imagem no controle da galeria vertical , defina a propriedade ImagePosition do controle Image como Fit.
Clique ou toque no controle Adicionar imagem , clique ou toque em outro arquivo de imagem, clique ou toque em Abrir e, em seguida, clique ou toque 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 retorne ao workspace 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 deve ter um contraste adequado entre o texto e a tela 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 ao leitor de tela
- O botão Adicionar imagem deve ter Texto e ChangePictureText que solicita ao usuário que adicione ou altere uma imagem.
Suporte ao teclado
- O botão Adicionar imagem deve ter TabIndex igual ou superior a zero para que os usuários de 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.