Controlo Entrada de caneta no Power Apps

Um controlo no qual o utilizador pode desenhar, apagar e realçar as áreas de uma imagem.

Descrição

O utilizador pode utilizar este controlo como um quadro, desenhar diagramas e escrever palavras que podem ser convertidas em texto escrito.

Limitações

O controlo de introdução com caneta tem as seguintes limitações:

• O controlo de caneta só tem suporte parcial para desenhar com um rato ou através do toque na aplicação para Windows. As linhas poderão ser intermitentes. Para um desenho com linhas suaves, utilize uma caneta ou execute a aplicação num browser.

Propriedades chave

Image – propriedade de saída que representa a imagem desenhada pelo utilizador final.

Color – a cor dos traços de introdução.

Mode – o controlo está no modo Desenhar ou Apagar. O modo de seleção foi preterido.

Propriedades adicionais

AccessibleLabel – a etiqueta para os leitores de ecrãs. Pode ser utilizado para descrever a finalidade do controlo, bem como métodos alternativos de introdução.

BorderColor – a cor do limite de um controlo.

BorderStyle – se o limite do controlo é Sólido, Tracejado, Com pontos ou Nenhum.

BorderThickness – a espessura do limite de um controlo.

DisplayMode – se o controlo permite a intervenção do utilizador (Editar), apenas apresenta os dados (Visualizar), ou está desativado (Desativado).

Fill – a cor de fundo de um controlo.

Height – a distância entre as margens superiores e inferiores de um controlo.

Input – Preterido. Se a introdução suporta introduções através do rato, caneta ou toque. O valor predefinido (7) suporta os três.

OnSelect– Ações a realizar quando o utilizador toca ou clica num controlo.

SelectionColor – a cor do texto de um item ou itens selecionados numa lista ou a cor da ferramenta de seleção num controlo de caneta.

SelectionThickness – a espessura da ferramenta de seleção de um controlo de introdução a caneta.

ShowControls – se um leitor de vídeo ou áudio mostra, por exemplo, um botão de reprodução e um controlo de deslize do volume, e um controlo de caneta mostra, por exemplo, ícones para desenhar, apagar e limpar.

Size – o tamanho do tipo de letra do texto que é apresentado num controlo.

Tooltip – o texto explicativo que aparece quando o rato passa por cima de um controlo.

Visible – se um controlo é apresentado ou está oculto.

Width – a distância entre as margens esquerda e direita de um controlo.

X – a distância entre o limite esquerdo de um controlo e o limite esquerdo do respetivo recipiente principal (do ecrã, se não existir um recipiente principal).

Y – a distância entre o limite superior de um controlo e o limite superior do recipiente principal (do ecrã, se não existir um recipiente principal).

Funções relacionadas

Collect( CollectionName, DatatoCollect )

Exemplo

Criar um conjunto de imagens

1. Adicione um controlo Entrada de caneta, dê-lhe o nome MyDoodlese defina a respetiva propriedade ShowControls para verdadeiro.

   Não sabe como adicionar, atribuir um nome e configurar um controlo?

2. Adicione um controlo Botão, mova-o para baixo de MyDoodlese defina a propriedade Text do controlo Botão para que mostre Adicionar.

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

4. Adicione um controlo Galeria de imagens, mova-o para baixo do controlo Botão e reduza a largura do controlo Galeria de imagens até que mostre os três itens.

5. Defina a propriedade Items do controlo Galeria de imagens para Doodles, e, em seguida, prima F5.

6. Desenhe uma imagem em MyDoodlese, em seguida, clique ou toque no controlo Botão.

   A imagem que desenhou aparece no controlo Galeria de imagens.

7. (opcional) No controlo Entrada de caneta, clique ou toque no ícone para limpar a imagem que desenhou, desenhe outra imagem e, em seguida, clique ou toque no controlo Botão.

8. No controlo Galeria de imagens, defina a propriedade OnSelect do controlo Imagem para esta fórmula:
   Remover (Doodles, ThisItem)

9. Remova um desenho ao clicar ou tocar no controlo Galeria de imagens.

Utilize a função SaveData para guardar os desenhos localmente, ou a função Patch para os guardar numa origem de dados.

Diretrizes de acessibilidade

Contraste de cor

Tem de existir contraste de cor adequado entre:

• BorderColor e a cor fora do controlo (se existir um limite)
• Fill e a cor fora do controlo (se não existir um limite)

Suporte a leitor de ecrã

• AccessibleLabel tem de estar presente.

  Importante

  Entrada de caneta não está acessível a utilizadores de leitores de ecrã. Forneça sempre uma forma alternativa de introdução. Por exemplo, se for necessário um esboço, considere adicionar um controlo Adicionar imagem para que os utilizadores possam carregar uma imagem. Ambos os métodos podem ser oferecidos e o utilizador escolhe aquele com que se sente mais confortável.

Suporte de teclado