Stifteingabe-Steuerelement in PowerAppsPen input control in PowerApps

Ein Steuerelement, mit dem der Benutzer Bereiche eines Bildes zeichnen, löschen oder markieren kann.A control in which the user can draw, erase, and highlight areas of an image.

BeschreibungDescription

Benutzer können dieses Steuerelement wie ein Whiteboard verwenden. Sie können Diagramme zeichnen und Wörter schreiben, die in eingegebenen Text konvertiert werden können.The user can use this control like a whiteboard, drawing diagrams and writing words that can be converted to typed text.

HaupteigenschaftenKey properties

Color – Die Farbe der Eingabestriche.Color – The color of input strokes.

Mode – Das Steuerelement ist im Modus Draw oder Erase.Mode – The control is in Draw or Erase mode. Der Modus „Select“ ist veraltet.Select mode has been deprecated.

Zusätzliche EigenschaftenAdditional properties

BorderColor – Die Farbe des Rahmens eines Steuerelements.BorderColor – The color of a control's border.

BorderStyle – Legt fest, ob der Rahmen eines Steuerelements Solid (Durchgehend), Dashed (Gestrichelt), Dotted (Gepunktet) oder None (Keiner) ist.BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness – Die Stärke des Rahmens eines Steuerelements.BorderThickness – The thickness of a control's border.

DisplayMode: Legt fest, ob das Steuerelement Benutzereingaben zulässt (Edit, Bearbeiten), ob nur Daten angezeigt werden (View, Anzeigen) oder ob das Steuerelement deaktiviert ist (Disabled, Deaktiviert).DisplayMode – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).

Fill – Die Hintergrundfarbe eines Steuerelements.Fill – The background color of a control.

Height – Die Entfernung zwischen dem oberen und unteren Rand eines Steuerelements.Height – The distance between a control's top and bottom edges.

Input: EingabeInput – Input.

OnSelect – Legt fest, wie die App reagiert, wenn der Benutzer auf ein Steuerelement tippt oder klickt.OnSelect – How the app responds when the user taps or clicks a control.

SelectionColor: Die Textfarbe des ausgewählten Elements oder der Elemente in einer Liste oder die Farbe des Auswahltools in einem Stift-Steuerelement.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: Die Stärke des Auswahltools für ein Stifteingabe-Steuerelement.SelectionThickness – The thickness of the selection tool for a pen-input control.

ShowControls: Gibt beispielsweise an, ob für einen Audio- oder Videoplayer eine Schaltfläche für die Wiedergabe und ein Lautstärkeregler und für ein Stift-Steuerelement Symbole zum Zeichnen oder Löschen angezeigt werden.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 – Der Schriftgrad des Texts, der in einem Steuerelement angezeigt wird.Size – The font size of the text that appears on a control.

QuickInfo: Erklärender Text, der angezeigt wird, wenn der Benutzer auf ein Steuerelement zeigt.Tooltip – Explanatory text that appears when the user hovers over a control.

Visible – Legt fest, ob ein Steuerelement angezeigt wird oder ausgeblendet ist.Visible – Whether a control appears or is hidden.

Width – Der Abstand zwischen dem linken und rechten Rand eines Steuerelements.Width – The distance between a control's left and right edges.

X – Der Abstand zwischen dem linken Rand eines Steuerelements und dem linken Rand des übergeordneten Containers (bzw. des Bildschirms, wenn kein übergeordneter Container vorhanden ist).X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).

Y – Der Abstand zwischen dem oberen Rand eines Steuerelements und dem oberen Rand des übergeordneten Containers (bzw. des Bildschirms, wenn kein übergeordneter Container vorhanden ist).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 )

BeispielExample

Erstellen Sie einen Satz von BildernCreate a set of images

  1. Fügen Sie ein Pen input-Steuerelement hinzu, benennen Sie es MyDoodles und legen Sie seine Eigenschaft ShowControls auf TRUE fest.Add a Pen input control, name it MyDoodles, and set its ShowControls property to true.

    Möchten Sie wissen, wie Sie ein Steuerelement hinzufügen, benennen und konfigurieren?Don't know how to add, name, and configure a control?

  2. Fügen Sie ein Steuerelement Button hinzu, verschieben Sie es unter MyDoodles, und legen Sie die Eigenschaft Text des Steuerelements Button so fest, dass Add angezeigt wird.Add a Button control, move it below MyDoodles, and set the Text property of the Button control to show Add.
  3. Legen Sie die Eigenschaft OnSelect des Steuerelements Button auf die folgende Formel fest:Set the OnSelect property of the Button control to this formula:
    Collect(Doodles, {Sketch:MyDoodles.Image}) Collect(Doodles, {Sketch:MyDoodles.Image})
  4. Fügen Sie ein Steuerelement Image gallery hinzu, verschieben Sie es unter das Steuerelement Button, und verkleinern Sie die Breite des Image gallery, bis drei Elemente angezeigt werden.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. Legen Sie die Eigenschaft Items des Steuerelements Image gallery auf Doodles fest, und drücken Sie anschließend F5.Set the Items property of the Image gallery control to Doodles, and then press F5.
  6. Zeichnen Sie ein Bild in MyDoodles, und klicken oder tippen Sie anschließend auf das Steuerelement Button.Draw an image in MyDoodles, and then click or tap the Button control.

    Das Bild, das Sie gezeichnet haben, wird im Steuerelement Image gallery angezeigt.The image that you drew appears in the Image gallery control.

  7. (optional) Klicken oder tippen Sie im Steuerelement Pen input auf das Symbol, um das gezeichnete Bild zu löschen, zeichnen Sie ein anderes Bild, und klicken oder tippen Sie auf das Steuerelement Button.(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. Legen Sie im Steuerelement Image gallery die Eigenschaft OnSelect des Steuerelements Image auf diese Formel fest:In the Image gallery control, set the OnSelect property of the Image control to this formula:
    Remove(Doodles, ThisItem) Remove(Doodles, ThisItem)
  9. Entfernen Sie eine Zeichnung, indem Sie auf das Steuerelement Image gallery klicken oder tippen.Remove a drawing by clicking or tapping it in the Image gallery control.

Verwenden Sie die SaveData-Funktion, um Ihre Zeichnungen lokal zu speichern, oder die Patch-Funktion zur Speicherung in einer Datenquelle.Use the SaveData function to save your drawings locally or the Patch function to save them to a data source.