Pennkontroll i PowerAppsPen input control in PowerApps

En kontroll som användaren kan använda till att rita, radera och markera områden i en bild.A control in which the user can draw, erase, and highlight areas of an image.

BeskrivningDescription

Användaren kan använda den här kontrollen som en whiteboard och rita diagram och skriva ord som kan konverteras till text.The user can use this control like a whiteboard, drawing diagrams and writing words that can be converted to typed text.

NyckelegenskaperKey properties

Color – Färgen på inmatade streck.Color – The color of input strokes.

Mode – Kontrollen är i läget Draw eller Erase.Mode – The control is in Draw or Erase mode. Det valda läget är inaktuellt.Select mode has been deprecated.

Ytterligare egenskaperAdditional properties

BorderColor – En kontrolls kantlinjefärg.BorderColor – The color of a control's border.

BorderStyle – Om en kontrolls kantlinje är solid, streckad, prickad eller ingen.BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness – Tjockleken på en kontrolls kantlinje.BorderThickness – The thickness of a control's border.

DisplayMode – Om kontrollen tillåter indata från användaren (Redigera), bara visar data (Visa) eller är inaktiverad (Inaktiverad).DisplayMode – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).

Fill – Bakgrundsfärgen i en kontroll.Fill – The background color of a control.

Height – Avståndet mellan kontrollens övre och nedre kanter.Height – The distance between a control's top and bottom edges.

Input – indata.Input – Input.

OnSelect – Hur appen reagerar när användaren trycker eller klickar på en kontroll.OnSelect – How the app responds when the user taps or clicks a control.

SelectionColor – Textfärgen för ett eller flera markerade objekt i en lista eller färgen för val av verktyget i en pennkontroll.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 – tjockleken hos markeringsverktyget för en pennkontroll.SelectionThickness – The thickness of the selection tool for a pen-input control.

ShowControls – Om en ljud- eller videospelare t.ex. ska visa en uppspelningsknapp och ett volymreglage eller om en pennkontroll ska visa t.ex. ikoner för att rita, radera och rensa.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 – Teckenstorleken för den text som visas i en kontroll.Size – The font size of the text that appears on a control.

Tooltip – Beskrivande text som visas när användaren för muspekaren över en kontroll.Tooltip – Explanatory text that appears when the user hovers over a control.

Visible – Om en kontroll visas eller är dold.Visible – Whether a control appears or is hidden.

Width – Avståndet mellan kontrollens högra och vänstra kanter.Width – The distance between a control's left and right edges.

X – Avståndet mellan kontrollens vänstra kant och den överordnade behållarens vänstra kant (skärmen om det inte finns någon överordnad behållare).X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).

Y – Avståndet mellan kontrollens övre kant och den överordnade behållarens övre kant (skärmen om det inte finns någon överordnad behållare).Y – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container).

Collect( CollectionName, DatatoCollect )Collect( CollectionName, DatatoCollect )

ExempelExample

Skapa en bilduppsättningCreate a set of images

  1. Lägg till kontroll för Penndata, namnge den MyDoodles och ange egenskapen ShowControls som sant.Add a Pen input control, name it MyDoodles, and set its ShowControls property to true.

    Vet du inte hur du lägger till, namnger och konfigurerar en kontroll?Don't know how to add, name, and configure a control?

  2. Lägg till en Knappkontroll , placera den nedanför MyDoodles och ange egenskapen Text för knappen så att Lägg till visas.Add a Button control, move it below MyDoodles, and set the Text property of the Button control to show Add.
  3. Ange egenskapen OnSelect för knappen enligt den här formeln:Set the OnSelect property of the Button control to this formula:
    Collect(Doodles, {Sketch:MyDoodles.Image})Collect(Doodles, {Sketch:MyDoodles.Image})
  4. Lägga till kontrollen Bildgalleri, flytta den under Knappen och minska bredden på Bildgalleriet så att den visar tre objekt.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. Ange egenskapen Items för Bildgalleriet som Doodles och tryck på F5.Set the Items property of the Image gallery control to Doodles, and then press F5.
  6. Ritar en bild i MyDoodles och klicka sedan på eller tryck på Knappkontrollen .Draw an image in MyDoodles, and then click or tap the Button control.

    Bilden som du har ritat visas i kontrollen Bildgalleri.The image that you drew appears in the Image gallery control.

  7. (valfritt) I kontrollen Penndata klickar eller pekar du på ikonen för att ta bort bilden som du har ritat. Rita sedan en annan bild och klicka sedan på eller tryck på Knappkontrollen .(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. I kontrollen Bildgalleri anger du egenskapen OnSelect för kontrollen Bild med den här formeln:In the Image gallery control, set the OnSelect property of the Image control to this formula:
    Remove(Doodles, ThisItem)Remove(Doodles, ThisItem)
  9. Ta bort en ritning genom att klicka eller peka på den i kontrollen Bildgalleriet.Remove a drawing by clicking or tapping it in the Image gallery control.

Använd funktionen SaveData för att spara dina ritningar lokalt eller funktionen Patch för att spara dem på en datakälla.Use the SaveData function to save your drawings locally or the Patch function to save them to a data source.