Contrôle Ajouter une image dans les applications canevas

Prend une photo ou charge des images à partir de l’appareil local.

Description

Avec ce contrôle, les utilisateurs peuvent prendre des photos ou charger des images à partir de leur appareil et mettre à jour la source de données avec ce contenu. Sur un appareil mobile, l’utilisateur voit une boîte de dialogue qui lui permet de choisir entre prendre une photo ou sélectionner une image déjà disponible.

Ce contrôle consiste en un contrôle groupé contenant deux contrôles : un contrôle Image et un Bouton Ajouter une image. Le contrôle Image affiche l’image chargée ou un espace réservé si aucune image n’a été chargée. Le Bouton Ajouter une image invite au chargement d’une image.

Consultez la référence sur le contrôle Image pour connaître les propriétés du contrôle Image.

Propriétés du bouton Ajouter une image

AccessibleLabel  : Étiquette pour les lecteurs d’écran. Doit décrire l’objectif d’ajout d’une image.

Align  : emplacement du texte par rapport au centre horizontal de son contrôle.

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.

ChangePictureText : texte qui apparaît sur le bouton lorsqu’une image a été chargée.

Color  : couleur du texte dans un contrôle.

DisabledBorderColor  : couleur de bordure d’un contrôle si sa propriété DisplayMode est définie sur Disabled.

DisabledColor  : couleur du texte d’un contrôle si sa propriété DisplayMode est définie sur Disabled.

DisabledFill  : couleur d’arrière-plan d’un contrôle si sa propriété DisplayMode est définie sur Disabled.

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

Error : s’il existe un problème de chargement d’une image, cette propriété contiendra une chaîne d’erreur appropriée.

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

FocusedBorderColor  : couleur de bordure d’un contrôle lorsque le contrôle est actif.

FocusedBorderThickness  : épaisseur de bordure d’un contrôle lorsque le contrôle est actif.

Font  : nom de la famille de polices dans laquelle le texte s’affiche.

FontWeight  : épaisseur du texte dans un contrôle : Gras, Semibold, Normal ou Plus claire.

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

HoverBorderColor  : couleur de bordure d’un contrôle lorsque l’utilisateur maintient le pointeur de la souris sur ce contrôle.

HoverColor  : couleur du texte d’un contrôle lorsque l’utilisateur maintient le pointeur de la souris sur ce contrôle.

HoverFill  : couleur d’arrière-plan d’un contrôle lorsque l’utilisateur maintient le pointeur de la souris sur ce contrôle.

Italic  : indique si le texte d’un contrôle est en italique.

Média : identificateur du clip qu’un contrôle Audio ou Vidéo lance.

OnChange – Actions à effectuer lorsque l’utilisateur modifie la valeur d’un contrôle (par exemple, en ajustant un curseur).

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

Padding  : distance entre le texte sur un bouton d’importation ou d’exportation et les bords de ce bouton.

PressedBorderColor  : couleur de bordure d’un contrôle lorsque l’utilisateur appuie ou clique dessus.

PressedColor  : couleur de texte d’un contrôle lorsque l’utilisateur appuie ou clique dessus.

PressedFill  : couleur d’arrière-plan d’un contrôle lorsque l’utilisateur appuie ou clique dessus.

Reset  : indique si un contrôle revient à sa valeur par défaut.

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

Barré  : indique si une ligne s’affiche sur le texte qui apparaît sur un contrôle.

TabIndex  : ordre de navigation à l’aide du clavier par rapport à d’autres contrôles.

Texte  : texte qui apparaît sur le bouton lorsqu’une image n’a pas été chargée.

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

Underline  : indique si une ligne s’affiche sous le texte qui apparaît sur un contrôle.

UseMobileCamera : indique s’il faut utiliser une caméra mobile directement, lorsqu’elle est disponible. Pour les périphériques Android, cette propriété nécessite le cadre expérimental Capture des médias améliorée activé.

VerticalAlign  : emplacement du texte sur un contrôle par rapport au centre vertical de celui-ci.

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

Patch( DataSource, BaseRecord, ChangeRecord )

Exemples

  1. Ajoutez un contrôle Ajouter une image et cliquez trois fois dessus.

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

  2. Dans la boîte de dialogue Ouvrir, cliquez ou appuyez sur un fichier image, puis cliquez ou appuyez sur Ouvrir.

  3. Ajoutez un contrôle Bouton, déplacez-le sous le contrôle Ajouter une image et définissez la propriété OnSelect du contrôle Bouton sur la formule suivante :
    Collect(MyPix, AddMediaBouton1.Media)

    Vous souhaitez obtenir davantage d’informations sur la fonction Collect ou d’autres fonctions ?

  4. Ajoutez un contrôle Galerie verticale et définissez sa propriété Items sur MyPix.

  5. Sélectionnez le contrôle Image dans la galerie et définissez la propriété Image sur ThisItem.Value.

  6. Appuyez sur F5, puis cliquez ou appuyez sur le contrôle Bouton.

    L’image issue du contrôle Ajouter une image s’affiche dans le contrôle Vertical Galerie. Si votre image n’a pas les mêmes proportions que le contrôle Image dans le contrôle Galerie verticale, définissez la propriété ImagePosition du contrôle Image sur Fit.

  7. Cliquez ou appuyez sur le contrôle Ajouter une image, cliquez ou appuyez sur un autre fichier image, cliquez ou appuyez sur Ouvrir, puis cliquez ou appuyez sur le contrôle Bouton que vous avez ajouté.

    Le deuxième image apparaît dans le contrôle Image gallery.

  8. (facultatif) Répétez l’étape précédente une ou plusieurs fois, puis revenez à l’espace de travail par défaut en appuyant sur Échap.

Utilisez la fonction SaveData pour enregistrer les images en local ou la fonction Patch pour mettre à jour une source de données.

Instructions d’accessibilité

Les mêmes instructions s’appliquent pour Bouton et Image. De plus, envisagez les scénarios suivants :

Contraste des couleurs

  • Le Bouton Ajouter une image doit avoir un contraste adéquat entre le texte et l’arrière-plan. Étant donné que l’image chargée peut avoir des couleurs différentes, utilisez un contrôle Fill opaque sur le Bouton Ajouter une image pour garantir la cohérence du contraste.

Prise en charge du lecteur d’écran

  • Le Bouton Ajouter une image doit avoir un contrôle Texte et un contrôle ChangePictureText qui invitent l’utilisateur à ajouter ou à modifier une image.

Prise en charge du clavier

  • Le Bouton Ajouter une image doit avoir un contrôle TabIndex qui est égal ou supérieur à zéro afin que les utilisateurs du clavier puissent y accéder.
  • Le Bouton Ajouter une image doit avoir des indicateurs de focus clairement visibles. Pour ce faire, utilisez FocusedBorderColor et FocusedBorderThickness.

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