Controle de entrada de caneta no Power Apps

Um controle no qual o usuário pode desenhar, apagar e realçar áreas de uma imagem.

Description

O usuário pode usar esse controle como um quadro de comunicações, diagramas de desenho e palavras de escrita que podem ser convertidas em texto digitado.

Limitações

O controle de entrada de caneta tem estas limitações:

• O controle de caneta só tem suporte parcial para desenho usando uma entrada de mouse ou toque no aplicativo do Windows. Traços podem ser intermitentes. Para desenho suave, use uma caneta ou execute o aplicativo em um navegador.

Principais propriedades

Imagem – Propriedade de saída que representa a imagem desenhada pelo usuário final.

Cor – a cor dos traços de entrada.

Modo – O controle está no modo Desenhar ou Apagar . O modo de seleção 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 de um controle.

BorderStyle – se a borda de um controle é Solid, Dashed, Dotted ou None.

BorderThickness – A espessura da borda de um controle.

DisplayMode – se o controle permite a entrada do usuário (Editar), exibe apenas dados (Exibição) ou está desabilitado (Desabilitado).

Fill – a cor da tela de fundo de um controle.

Altura – a distância entre as bordas superior e inferior de um controle.

Entrada – preterida. Se a entrada dá suporte a entradas de mouse, caneta ou toque. O valor padrão (7) dá suporte aos três.

OnSelect – Ações a serem executadas quando o usuário toca ou clica em um controle.

SelectionColor – A cor do texto de um item ou itens selecionados em uma lista ou na 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 – se um player de áudio ou vídeo mostra, por exemplo, um botão de reprodução e um controle deslizante de volume, e um controle de caneta mostra, por exemplo, ícones para desenho, apagamento e limpeza.

Tamanho – o tamanho da fonte do texto que aparece em um controle.

Dica de ferramenta – texto explicativo exibido quando o usuário passa o mouse sobre um 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 (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( CollectionName, DatatoCollect )

Example

Criar um conjunto de imagens

1. Adicione um controle de entrada de caneta , nomeie-o como 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 da galeria de imagens, mova-o abaixo do controle Button e reduza a largura do controle da galeria de imagens até que ele mostre três itens.

5. Defina a propriedade Items do controle da galeria deimagens 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 de 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 Image como esta fórmula:
   Remove(Doodles, ThisItem)

9. Remova um desenho clicando ou tocando nele no controle galeria de imagens .

Use a função SaveData para salvar seus desenhos localmente ou a função Patch para salvá-los em uma fonte de dados.

Diretrizes de acessibilidade

Contraste de cores

Deve haver contraste de cores adequado entre:

• BorderColor e a cor fora do controle (se houver uma borda)
• Preencher e a cor fora do controle (se não houver borda)

Suporte ao leitor de tela

• AccessibleLabel deve estar presente.

  Importante

  A entrada de caneta não é acessível aos usuários do leitor de tela. Sempre forneça uma forma alternativa de entrada. Por exemplo, se um esboço for necessário, considere adicionar um controle Adicionar imagem para os usuários carregarem uma imagem. Ambos os métodos podem ser oferecidos e o usuário pode escolher aquele com o qual está mais confortável.

Suporte ao teclado