Contrôle Pen-input dans PowerAppsPen input control in PowerApps

Un contrôle dans lequel l’utilisateur peut dessiner, effacer et surligner les zones d’une image.A control in which the user can draw, erase, and highlight areas of an image.

DescriptionDescription

L’utilisateur peut utiliser ce contrôle comme un tableau blanc, en dessinant des diagrammes et en écrivant des mots qui peuvent être convertis en texte dactylographié.The user can use this control like a whiteboard, drawing diagrams and writing words that can be converted to typed text.

Principales propriétésKey properties

Color : couleur de saisie du texte.Color – The color of input strokes.

Mode : le contrôle est en mode Dessiner ou Effacer.Mode – The control is in Draw or Erase mode. Le mode Sélectionner est déconseillé.Select mode has been deprecated.

Propriétés supplémentairesAdditional properties

BorderColor : couleur de bordure du contrôle.BorderColor – The color of a control's border.

BorderStyle : indique si la bordure d’un contrôle est unie, discontinue, en pointillés ou s’il n’y en a aucune.BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness : épaisseur de bordure d’un contrôle.BorderThickness – The thickness of a control's border.

DisplayMode : indique si le contrôle autorise l’entrée d’un utilisateur (Edit), affiche uniquement les données (View) ou est désactivé (Disabled).DisplayMode – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).

Fill : couleur d’arrière-plan d’un contrôle.Fill – The background color of a control.

Height : distance entre le haut et le bas d’un contrôle.Height – The distance between a control's top and bottom edges.

Input : entrée.Input – Input.

OnSelect : comment l’application répond quand l’utilisateur appuie ou clique sur un contrôle.OnSelect – How the app responds when the user taps or clicks a control.

SelectionColor : couleur de texte des éléments sélectionnés dans une liste ou couleur de l’outil de sélection dans un contrôle Pen.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 : épaisseur de l’outil de sélection d’un contrôle Pen-input.SelectionThickness – The thickness of the selection tool for a pen-input control.

ShowControls : indique si un lecteur audio ou vidéo montre, par exemple, un bouton de lecture et un curseur de volume, et si un contrôle Pen montre, par exemple, des icônes pour dessiner, effacer et supprimer.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 : taille de police du texte qui apparaît sur un contrôle.Size – The font size of the text that appears on a control.

Tooltip : texte explicatif qui s’affiche lorsque l’utilisateur pointe sur un contrôle.Tooltip – Explanatory text that appears when the user hovers over a control.

Visible : indique si un contrôle est visible ou est masqué.Visible – Whether a control appears or is hidden.

Width : distance entre les côtés droit et gauche d’un contrôle.Width – The distance between a control's left and right edges.

X : distance entre le bord gauche d’un contrôle et le bord gauche de son conteneur parent (ou l’écran s’il n’y a pas de conteneur parent).X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).

Y : distance entre le bord supérieur d’un contrôle et le bord supérieur du conteneur parent (ou l’écran s’il n’y a pas de conteneur parent).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 )

ExempleExample

Créer un ensemble d’imagesCreate a set of images

  1. Ajoutez un contrôle Pen-input, nommez-le MyDoodles et définissez sa propriété ShowControls sur true.Add a Pen input control, name it MyDoodles, and set its ShowControls property to true.

    Vous ne savez pas comment ajouter, nommer et configurer un contrôle ?Don't know how to add, name, and configure a control?

  2. Ajoutez un contrôle Button, déplacez-le sous MyDoodles et définissez la propriété Text du contrôle Button pour qu’il affiche Ajouter.Add a Button control, move it below MyDoodles, and set the Text property of the Button control to show Add.
  3. Définissez la propriété OnSelect du contrôle Button sur la formule suivante :Set the OnSelect property of the Button control to this formula:
    Collect(Doodles, {Sketch:MyDoodles.Image}) Collect(Doodles, {Sketch:MyDoodles.Image})
  4. Ajoutez un contrôle Image gallery, déplacez-le sous le contrôle Button et réduisez la largeur du contrôle Image gallery jusqu’à ce qu’il affiche trois éléments.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. Définissez la propriété Items du contrôle Image Gallery sur Doodles, puis appuyez sur F5.Set the Items property of the Image gallery control to Doodles, and then press F5.
  6. Dessinez une image dans MyDoodles, puis cliquez ou appuyez sur le contrôle Button.Draw an image in MyDoodles, and then click or tap the Button control.

    L’image que vous avez dessinée apparaît dans le contrôle Image gallery.The image that you drew appears in the Image gallery control.

  7. (facultatif) Dans le contrôle Pen-input, cliquez ou appuyez sur l’icône pour effacer l’image que vous avez dessinée, dessinez une autre image, puis cliquez ou appuyez sur le contrôle 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. Dans le contrôle Image gallery, définissez la propriété OnSelect du contrôle Image sur la formule suivante :In the Image gallery control, set the OnSelect property of the Image control to this formula:
    Remove(Doodles, ThisItem) Remove(Doodles, ThisItem)
  9. Supprimez un dessin en cliquant ou en appuyant sur le contrôle Image gallery.Remove a drawing by clicking or tapping it in the Image gallery control.

Utilisez la fonction SaveData pour enregistrer vos dessins en local ou la fonction Patch pour les enregistrer dans une source de données.Use the SaveData function to save your drawings locally or the Patch function to save them to a data source.