Controle Pen input 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.

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 das 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 Pen input, nomeie-o MyDoodles e defina sua propriedade ShowControls como true.

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

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

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

4. Adicione um controle Image gallery, mova-o abaixo do controle Button e reduza a largura do controle Image gallery até que ele mostre três itens.

5. Defina a propriedade Items do controle Image gallery como Doodles e pressione F5.

6. Desenhe uma imagem em MyDoodles e clique ou toque no controle Button.

   A imagem que você desenhou aparece no controle Image gallery.

7. (opcional) No controle Pen input, clique ou toque no ícone para limpar a imagem que você desenhou, desenhe outra imagem e clique ou toque no controle Button.

8. No controle Image gallery, defina a propriedade OnSelect do controle Image como esta fórmula:
   Remove(Doodles, ThisItem)

9. Remova um desenho clicando ou tocando no controle Image gallery.

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

  Pen input 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 Add picture 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

Pen input 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 Text input 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).