Controle de Entrada à caneta no PowerAppsPen input control in PowerApps

Um controle no qual o usuário pode desenhar, apagar e destacar áreas de uma imagem.A control in which the user can draw, erase, and highlight areas of an image.

DescriçãoDescription

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.The user can use this control like a whiteboard, drawing diagrams and writing words that can be converted to typed text.

Propriedades-chaveKey properties

Cor – a cor dos traços de entrada.Color – The color of input strokes.

Modo – o controle está no modo Desenhar ou Apagar.Mode – The control is in Draw or Erase mode. O modo Selecionar foi preterido.Select mode has been deprecated.

Propriedades adicionaisAdditional properties

BorderColor – a cor da borda do controle.BorderColor – The color of a control's border.

BorderStyle – se a borda do controle é Solid, Dashed, Dotted ou None.BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness – a espessura da borda do controle.BorderThickness – The thickness of a control's border.

DisplayMode – se o controle permite entrada do usuário (Edição), apenas exibe dados (Exibição) ou está desabilitado (Desabilitado).DisplayMode – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).

Fill – a cor da tela de fundo de um controle.Fill – The background color of a control.

Height – a distância entre a parte superior do controle e as bordas inferiores.Height – The distance between a control's top and bottom edges.

Input – Entrada.Input – Input.

OnSelect – como o aplicativo responde quando o usuário toca ou clica em um controle.OnSelect – How the app responds when the user taps or clicks a control.

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.SelectionColor – The text color of a selected item or items in a list or the color of the selection tool in a pen control.

SelectionThickness – a espessura da ferramenta de seleção para um controle de entrada de caneta.SelectionThickness – The thickness of the selection tool for a pen-input control.

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.ShowControls – Whether an audio or video player shows, for example, a play button and a volume slider, and a pen control shows, for example, icons for drawing, erasing, and clearing.

Size – o tamanho da fonte do texto que aparece em um controle.Size – The font size of the text that appears on a control.

Tooltip – um texto explicativo aparece quando o usuário passa o mouse sobre um controle.Tooltip – Explanatory text that appears when the user hovers over a control.

Visible – se um controle é exibido ou está oculto.Visible – Whether a control appears or is hidden.

Width – a distância entre das bordas esquerda e direita de um controle.Width – The distance between a control's left and right edges.

X – a distância entre a borda esquerda de um controle e a borda esquerda de seu contêiner pai (tela, se não houver contêiner pai).X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).

Y – a distância entre a borda superior de um controle e a borda superior de seu contêiner pai (tela, se não houver contêiner pai).Y – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container).

Collect( Nome da coleção, Dados para coleta )Collect( CollectionName, DatatoCollect )

ExemploExample

Criar um conjunto de imagensCreate a set of images

  1. Adicione um controle Entrada à caneta, nomeie-o MyDoodles e defina sua propriedade ShowControls como true.Add a Pen input control, name it MyDoodles, and set its ShowControls property to true.

    Não sabe como adicionar, nomear e configurar um controle?Don't know how to add, name, and configure a control?

  2. Adicione um controle Botão, mova-o abaixo de MyDoodles e defina a propriedade Text do controle Botão para mostrar Adicionar.Add a Button control, move it below MyDoodles, and set the Text property of the Button control to show Add.
  3. Defina a propriedade OnSelect do controle Button como esta fórmula:Set the OnSelect property of the Button control to this formula:
    Collect(Doodles, {Sketch:MyDoodles.Image})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.Add an Image gallery control, move it below the Button control, and shrink the width of the Image gallery control until it shows three items.
  5. Defina a propriedade Items do controle Galeria de imagens como Doodles e pressione F5.Set the Items property of the Image gallery control to Doodles, and then press F5.
  6. Desenhe uma imagem em MyDoodles e clique ou toque no controle Botão.Draw an image in MyDoodles, and then click or tap the Button control.

    A imagem que você desenhou aparece no controle Galeria de imagens.The image that you drew appears in the Image gallery control.

  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.(optional) In the Pen input control, click or tap the icon to clear the image that you drew, draw another image, and then click or tap the Button control.
  8. No controle Galeria de imagens, defina a propriedade OnSelect do controle Imagem como esta fórmula:In the Image gallery control, set the OnSelect property of the Image control to this formula:
    Remove(Doodles, ThisItem)Remove(Doodles, ThisItem)
  9. Remova um desenho clicando ou tocando no controle Galeria de imagens.Remove a drawing by clicking or tapping it in the Image gallery control.

Use a função SaveData para salvar os desenhos localmente ou a função Patch para salvá-los em uma fonte de dados.Use the SaveData function to save your drawings locally or the Patch function to save them to a data source.