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

1. 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?

2. Adicione um controle Botão, mova-o abaixo de MyDoodles e defina a propriedade Text do controle Botão para mostrar Adicionar.

3. Defina a propriedade OnSelect do controle Botão como esta fórmula:
   Collect(Doodles, {Sketch:MyDoodles.Image})

4. 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.

5. Defina a propriedade Items do controle Galeria de imagens como Doodles e pressione F5.

6. Desenhe uma imagem em MyDoodles e clique ou toque no controle Botão.

   A imagem que você desenhou aparece no controle Galeria de imagens.

7. (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.

8. No controle Galeria de imagens, defina a propriedade OnSelect do controle Imagem como esta fórmula:
   Remove(Doodles, ThisItem)

9. 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