Contrôle Pen-input dans Power Apps

  • Article

Un contrôle dans lequel l’utilisateur peut dessiner, effacer et surligner les zones d’une image.

Description

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é.

Propriétés clés

Image : propriété Output qui représente l’image dessinée par l’utilisateur final.

Color  : couleur de saisie du texte.

Mode : le contrôle est en mode Dessiner ou Effacer. Le mode Sélectionner est déconseillé.

Propriétés supplémentaires

AccessibleLabel  : Étiquette pour les lecteurs d’écran. Peut être utilisé pour décrire l’objectif du contrôle, ainsi que des méthodes alternatives d’entrée.

BorderColor  : couleur de bordure du contrôle.

BorderStyle  : indique si la bordure d’un contrôle est unie, discontinue, en pointillés ou s’il n’y en a aucune.

BorderThickness  : épaisseur de bordure d’un contrôle.

DisplayMode  : indique si le contrôle autorise l’entrée utilisateur (Edit), affiche uniquement les données (View) ou est désactivé (Disabled).

Fill  : couleur d’arrière-plan d’un contrôle.

Height  : distance entre le haut et le bas d’un contrôle.

Input : dépréciée. Indique si les entrées tactiles, de souris et de stylet sont prises en charge. La valeur par défaut (7) prend en charge ces trois types d’entrée.

OnSelect – Actions à effectuer lorsque l’utilisateur appuie ou clique sur un contrôle.

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.

SelectionThickness : épaisseur de l’outil de sélection d’un contrôle Pen-input.

ShowControls : indique si un lecteur audio ou vidéo montre, par exemple, un bouton de lecture et un curseur de volume, et un contrôle Pen montre, par exemple, des icônes pour dessiner, effacer et supprimer.

Size  : taille de police du texte qui apparaît sur un contrôle.

Info-bulle  : texte explicatif qui s’affiche lorsque l’utilisateur pointe sur un contrôle.

Visible  : indique si un contrôle est visible ou est masqué.

Width  : distance entre les côtés droit et gauche d’un contrôle.

X  : distance entre le bord gauche d’un contrôle et le bord gauche de son conteneur parent (ou de l’écran à défaut de conteneur parent).

Y  : distance entre le bord supérieur d’un contrôle et le bord supérieur du conteneur parent (ou de l’écran à défaut de conteneur parent).

Fonctions connexes

Collect( CollectionName, DatatoCollect )

Exemple

Créer un ensemble d’images

  1. Ajoutez un contrôle Saisie effectuée à l’aide du stylet, nommez-le MyDoodles et définissez sa propriété ShowControls sur true.

    Vous ne savez pas comment ajouter, nommer et configurer un contrôle ?

  2. Ajoutez un contrôle Bouton, déplacez-le sous MyDoodles et définissez la propriété Texte du contrôle Bouton pour qu’il affiche Ajouter.

  3. Définissez la propriété OnSelect du contrôle Bouton sur la formule suivante :
    Collecter (Doodles, {Sketch:MyDoodles.Image})

  4. Ajoutez un contrôle Image gallery, déplacez-le sous le contrôle Bouton et réduisez la largeur du contrôle Image gallery jusqu’à ce qu’il affiche trois éléments.

  5. Définissez la propriété Items du contrôle Image Galerie sur Doodles, puis appuyez sur F5.

  6. Dessinez une image dans MyDoodles, puis cliquez ou appuyez sur le contrôle Bouton.

    L’image que vous avez dessinée apparaît dans le contrôle Image gallery.

  7. (facultatif) Dans le contrôle Saisie effectuée à l’aide du stylet, 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 Bouton.

  8. Dans le contrôle Image gallery, définissez la propriété OnSelect du contrôle Image sur la formule suivante :
    Remove(Doodles, ThisItem)

  9. Supprimez un dessin en cliquant ou en appuyant sur le contrôle Image gallery.

Utilisez la fonction SaveData pour enregistrer vos dessins en local ou la fonction Patch pour les enregistrer dans une source de données.

Instructions d’accessibilité

Contraste des couleurs

Il doit exister un contraste des couleurs adéquat entre :

  • BorderColor et la couleur en dehors du contrôle (s’il y a une bordure)
  • Fill et la couleur en dehors du contrôle (s’il n’y a pas de bordure)

Prise en charge du lecteur d’écran

  • AccessibleLabel doit être présent.

    Important

    Le contrôle Saisie effectuée à l’aide du stylet n’est pas accessible aux utilisateurs de lecteur d’écran. Toujours fournir une autre forme d’entrée. Par exemple, si un schéma est requis, envisagez d’ajouter un contrôle Ajouter une image permettant aux utilisateurs de charger une image. Les deux méthodes peuvent être proposées et l’utilisateur peut choisir celle qui lui convient le mieux.

Prise en charge du clavier

Important

Le contrôle Saisie effectuée à l’aide du stylet n’est pas accessible aux utilisateurs du clavier. Toujours fournir une autre forme d’entrée. Par exemple, si une signature est requise, envisagez d’ajouter un contrôle Saisie de texte pour que les utilisateurs entrent leur nom. Les deux méthodes peuvent être proposées et l’utilisateur peut choisir celle qui lui convient le mieux.

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).