Controle Entrada à caneta no Power Apps
Um controle no qual o usuário pode desenhar, apagar e destacar áreas de uma imagem.
Descrição
O usuário pode usar esse controle como um quadro de comunicações, desenhar diagramas e escrever palavras que podem ser convertidas em texto digitado.
Limitações
O controle da entrada de caneta tem estas limitações:
- O controle de caneta só tem suporte parcial para desenho usando um mouse ou uma entrada por toque no aplicativo do Windows. Os traços podem ser intermitentes. Para um desenho contínuo, use uma caneta ou execute o aplicativo em um navegador.
Principais propriedades
Image – propriedade de saída que representa a imagem extraída pelo usuário final.
Color – a cor dos traços de entrada.
Mode – o controle está no modo Desenhar ou Apagar. O modo Selecionar foi preterido.
Propriedades adicionais
AccessibleLabel – rótulo para leitores de tela. Pode ser usado para descrever a finalidade do controle, bem como métodos alternativos de entrada.
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.
DisplayMode – se o controle permite entrada do usuário (Edição), apenas exibe dados (Exibição), ou está desabilitado (Desabilitado).
Fill – a cor da tela de fundo de um controle.
Height – a distância entre a parte superior do controle e as bordas inferiores.
Input – preterida. Se a entrada é compatível com entradas de mouse, caneta ou toque. O valor padrão (7) é compatível com todos os três.
OnSelect – Ações a serem executadas quando o usuário tocar ou clicar em um controle.
SelectionColor – a cor do texto de um item ou itens selecionados em uma lista ou a cor da ferramenta de seleção em um controle de caneta.
SelectionThickness – a espessura da ferramenta de seleção para um controle de entrada de caneta.
ShowControls – especifica se um player de áudio ou de vídeo mostra, por exemplo, um botão Reproduzir e um controle deslizante de volume, bem como se um controle de caneta mostra, por exemplo, ícones para desenhar, apagar e limpar.
Size – o tamanho da fonte do texto que aparece em um controle.
Tooltip – texto explicativo exibido quando o usuário passa o mouse sobre um 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
Collect( Nome da coleção, Dados para coleta )
Exemplo
Criar um conjunto de imagens
Adicione um controle Entrada à caneta, nomeie-o MyDoodles e defina sua propriedade ShowControls como true.
Não sabe como adicionar, nomear e configurar um controle?
Adicione um controle Botão, mova-o abaixo de MyDoodles e defina a propriedade Text do controle Botão para mostrar Adicionar.
Defina a propriedade OnSelect do controle Botão como esta fórmula:
Collect(Doodles, {Sketch:MyDoodles.Image})Adicione um controle Galeria de imagens, mova-o abaixo do controle Botão e reduza a largura do controle Galeria de imagens até que ele mostre três itens.
Defina a propriedade Items do controle Galeria de imagens como Doodles e pressione F5.
Desenhe uma imagem em MyDoodles e clique ou toque no controle Botão.
A imagem que você desenhou aparece no controle Galeria de imagens.
(opcional) No controle Entrada à caneta, clique ou toque no ícone para limpar a imagem que você desenhou, desenhe outra imagem e clique ou toque no controle Botão.
No controle Galeria de imagens, defina a propriedade OnSelect do controle Imagem como esta fórmula:
Remove(Doodles, ThisItem)Remova um desenho clicando ou tocando no controle Galeria de imagens.
Use a função SaveData para salvar os desenhos localmente ou a função Patch para salvá-los em uma fonte de dados.
Diretrizes de acessibilidade
Contraste de cores
É necessário haver um contraste de cores adequado entre:
- BorderColor e a cor fora do controle (se houver borda)
- Fill e a cor fora do controle (se não houver borda)
Suporte ao leitor de tela
AccessibleLabel deve estar presente.
Importante
Entrada à caneta não está acessível para os usuários de leitores de tela. Sempre forneça uma forma de entrada alternativa. Por exemplo, se um esboço for necessário, considere adicionar um controle Adicionar imagem para que os usuários possam carregar uma imagem. Ambos os métodos podem ser oferecidos e o usuário pode escolher aquele que mais lhe agradam.
Suporte de teclado
Importante
Entrada à caneta não está acessível para os usuários de teclado. Sempre forneça uma forma de entrada alternativa. Por exemplo, se uma assinatura for necessária, adicione uma Entrada de texto para os usuários inserirem seu nome. Ambos os métodos podem ser oferecidos e o usuário pode escolher aquele que mais lhe agradam.
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).