Controlo de entrada por caneta nas 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 branco, desenhando diagramas e escrevendo palavras que podem ser convertidas em texto digitado.

Limitações

O controlo de entrada da caneta tem estas limitações:

• O controle de caneta tem suporte parcial apenas para desenhar usando uma entrada de mouse ou toque no aplicativo do Windows. Os acidentes vasculares cerebrais podem ser intermitentes. Para um desenho suave, use uma caneta ou execute o aplicativo em um navegador.

Propriedades chave

Image – 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 – Etiqueta para leitores de tela. Pode ser usado para descrever o objetivo do controle, bem como métodos alternativos de entrada.

BorderColor – A cor da borda de um controle.

BorderStyle – Se a borda de um controle é Sólida, Tracejada, Pontilhada ou Nenhuma.

BorderThickness – A espessura da borda de um controle.

DisplayMode – Se o controle permite a entrada do usuário (Editar), exibe apenas dados (View) ou está desativado (Disabled).

Preenchimento – A cor de fundo de um controlo.

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

Entrada – Preterida. Se a entrada suporta entradas por rato, caneta ou toque. O valor padrão (7) suporta todos os 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 selecionado ou itens 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 por 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 desenhar, apagar e limpar.

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

Dica de ferramenta – Texto explicativo que aparece 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 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 )

Example

Criar um conjunto de imagens

1. Adicione um controle de entrada Pen , 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 Add.

3. Defina a propriedade OnSelect do controle Button para esta fórmula:
   Collect(Doodles, {Esboço:MyDoodles.Image})

4. Adicione um controle de galeria de imagens , mova-o abaixo do controle Button e reduza a largura do controle de galeria de imagens até mostrar três itens.

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

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

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

7. (facultativo) No controlo de 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 Button .

8. No controle Galeria de imagens , defina a propriedade OnSelect do controle Image para esta fórmula:
   Remover(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 cor

Deve haver um contraste de cor adequado entre:

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

Suporte a leitor de ecrã

• AccessibleLabel deve estar presente.

  Importante

  A entrada por caneta não está acessível aos utilizadores de leitores de ecrã. Forneça sempre uma forma alternativa de entrada. Por exemplo, se um esboço for necessário, considere adicionar um controle Adicionar imagem para que os usuários carreguem uma imagem. Ambos os métodos podem ser oferecidos e o usuário pode escolher aquele com o qual se sente mais confortável.

Suporte de teclado