Liste personnalisée

Liste personnalisée est un contrôle dynamique basé sur un modèle, qui intègre divers contrôles avec une flexibilité exceptionnelle. Contrairement à un contrôle de liste standard, la liste personnalisée permet encore plus de contrôles dans la mise en page, ce qui le rend idéal pour les tâches telles que la création d'une grille efficace de liste d'e-mails.

Propriétés

La liste personnalisée a deux ensembles de propriétés : un pour la commande principale et un pour le modèle qu'il contient.

Pour basculer entre les propriétés d'une liste personnalisée et de son modèle, cliquez simplement sur la commande dans la zone de dessin ou sélectionnez-la dans l'arborescence sur la gauche.

Cette ligne

Utilisez le mot clé ThisRow pour représenter chaque ligne des données de la liste personnalisée.

Pour lier les valeurs de la Source de données aux commandes individuelles dans la Liste personnalisée, utilisez le mot clé ThisRow .

Limitations

• Pour des raisons de performances, plusieurs contrôles ne peuvent pas être inclus dans une liste personnalisée :

  • Modifier la grille
  • Table
  • Liste personnalisée
  • HTML personnalisé
  • Onglets
  Remarque :

  Pour les commandes basées sur des listes qui dépassent quatre éléments, nous vous recommandons d'utiliser des commandes Liste déroulante .

• Le référencement direct des contrôles Liste personnalisée , tels que MainPage.Header, n’est pas autorisée, bien que le nom du contrôle ait été trouvé par IntelliSense.

• Le fait de faire glisser des commandes entre le contexte d’une liste personnalisée et d’autres commandes de conteneur peut entraîner des expressions non valides, certaines visibles uniquement lorsque vous prévisualisez l'application. En effet, les liaisons dans le contexte de la liste personnalisée deviennent invalides en dehors ThisRow la liste personnalisée.

Démo

Utilisation d'une liste personnalisée

Introduction

Cette application montre la fonctionnalité Liste personnalisée .

Application de démonstration - essayez-la vous-même

Pour essayer vous-même la liste personnalisée , utilisez l'application de démonstration.

Télécharger l’application de démonstration depuis GitHub
Aperçu de l’application de démonstration dans le cloud

Application de démonstration - instructions d'utilisation

1. Dans UiPath Apps, créez une nouvelle application et importez l'application de démonstration téléchargée.
2. Vous remarquerez peut-être des erreurs. Pour les corriger, remplacez les entités référencées « Country », « EmailInbox », « Employees », « Employees2 » et « System Users » par des entités dans votre locataire.
3. Pour interagir avec les champs de la liste personnalisée , prévisualisez votre application.

Général

Liste personnalisée

• Masqué : si défini sur Vrai, masque la commande pendant le runtime.
• Désactivé : si défini sur false, les utilisateurs de l'application peuvent interagir avec la liste. Si défini sur Vrai, la liste est dans un état en lecture seule.

Modèle

• Info-bulle : info-bulle à afficher sur le modèle. Utilisez-la pour fournir des informations supplémentaires sur le modèle.
• Masqué : si défini sur Vrai, masque la commande pendant le runtime.
• Désactivé : si défini sur false, les utilisateurs de l'application peuvent interagir avec le modèle. S'il est défini sur true, le modèle est dans un état en lecture seule.

Events

Liste personnalisée

• Ligne sélectionnée : configurez ce qui se passe lorsque l'utilisateur de l'application sélectionne une ligne dans la Liste personnalisée. Configurez ce qui se passe lorsque la valeur est modifiée.

Modèle

• Cliqué (Clicked On) : configurez ce qui se passe lorsqu'un clic est effectué sur le modèle.

Style

Liste personnalisée

• Alignement de commande (Control Alignment) : hérite de l'alignement parent par défaut. Un autre alignement que le parent peut être défini. Pour revenir par défaut à l'alignement parent, désélectionnez les options remplacées.
  Remarque :

  L'alignement dépend de la mise en page sélectionnée pour le parent.

• Mise en page - Personnalisez la position des modèles dans la liste personnalisée :
  • Horizontal : les modèles sont disposés verticalement
  • Horizontal : les modèles sont disposés horizontalement
  • Grille : les modèles sont organisés au format grille
  • Espace intermédiaire (pixels uniquement) : l'espacement entre les modèles lorsqu'ils sont disposés dans une disposition verticale ou horizontale .
  • Écart horizontal / vertical : l'espacement horizontal et vertical entre les modèles lorsqu'ils sont disposés dans une disposition de grille .
  • Largeur du modèle : la largeur du modèle.
  • Hauteur du modèle : la hauteur du modèle.
  Remarque :

  • Dans une mise en page horizontale , la Largeur est définie en pixels et la Hauteur en pixels, %, em, ou auto.
  • Dans une mise en page verticale , la hauteur est en pixels et la largeur peut être en pixels, %, em, ou auto.
  • Dans une mise en page Grille , la hauteur et la largeur doivent être en pixels. Les unités relatives telles que %, em ou auto ne peuvent pas être utilisées.
• Marge (Margin) : définit la marge de la mise en page. Par défaut, une marque de 4px est définie. Les propriétés des marges Haut/Bas (Top/Bottom)et Gauche/Droite (Left/Right) sont combinées. Ces propriétés peuvent être dissociées à l'aide du bouton Lier (Link) sur le côté droit de la section Marge (Margin).
• Taille : largeur et hauteur de la liste personnalisée, en pixels. Valeurs par défaut :
  • En mise en page horizontale : largeur 800 px, hauteur automatique
  • En mise en page verticale : largeur auto, hauteur 400 px
  • En mise en page Grille : Largeur 800 px, Hauteur 400 px Pour définir des valeurs minimales ou maximales, cliquez sur l'icône à trois points (*).

Modèle

• Alignement de commande (Control Alignment) : hérite de l'alignement parent par défaut. Un autre alignement que le parent peut être défini. Pour revenir par défaut à l'alignement parent, désélectionnez les options remplacées.
  Remarque :

  L'alignement dépend de la mise en page sélectionnée pour le parent.

• Mise en page : déterminez comment les commandes du modèle sont positionnées :
  • Horizontal/Vertical : l'orientation des commandes.
  • Alignement : l'alignement des commandes dans le modèle.
  • Autoriser l'encapsulage : si cette option est sélectionnée, encapsule les commandes dans le modèle.
  • Autoriser le défilement : si cette option est sélectionnée, elle permet de faire défiler l'intérieur du modèle. Pour activer Autoriser le défilement, le modèle doit avoir une hauteur fixe (mise en page verticale) ou une largeur fixe (mise en page horizontale).
• Couleur d'arrière-plan : la couleur d'arrière-plan du modèle.
• Bordure (Border) : la bordure de la commande. L'épaisseur (Thickness), la couleur (Color) et le rayon (Radius) peuvent être configurés.
• Police : la famille de polices relative à ce modèle. Toutes les commandes du modèle partagent la même famille de polices. Par défaut, le modèle hérite de la famille de polices de la liste personnalisée.
• Marge (Margin) : définit la marge de la mise en page. Par défaut, une marge de 0px est définie. Les propriétés des marges Haut/Bas (Top/Bottom)et Gauche/Droite (Left/Right) sont combinées. Ces propriétés peuvent être dissociées à l'aide du bouton Lier (Link) sur le côté droit de la section Marge (Margin).
• Remplissage : remplissage du modèle. Par défaut, un remplissage de 16px est défini. Les propriétés des marges Haut/Bas et Gauche/Droite sont combinées. Ces propriétés peuvent être dissociées à l'aide du bouton Lier sur le côté droit de la section Remplissage .
• Avancé - affiche les propriétés Flex de la commande.
  • Base Flex : définit la taille d'origine d'un élément Flex avant que l'espace supplémentaire ne soit distribué ou supprimé (px, %, em, auto).
  • Croissance Flex : lorsqu'un espace supplémentaire est disponible, cette valeur détermine la quantité de croissance d'un élément Flex par rapport au reste des éléments.
  • Réduction des flexibilités : lorsque l’espace est insuffisant, cette valeur détermine la valeur d’un élément flexible par rapport aux autres éléments. Pour de plus amples informations, consultez la documentation Mozilla Developer Network.

Propriétés VB

Nom de la propriété	Type de données	Autorisations d’accès	Exemple
Disabled	Booléen	Lecture/Écriture	Si la valeur est true, désactive la commande au moment du runtime.
Hidden	Booléen	Lecture/Écriture	Si la valeur est true, masque la commande au moment du runtime.
SelectedItemIndex	Entier	Lecture seule	Renvoie l'index de la ligne actuellement sélectionnée : MainPage.CustomList.SelectedItemIndex
ThisRow	Le même que le champ Source de données .	Lecture seule	Fait référence à l'enregistrement actuel de la source de données. Utilisez-le pour configurer les champs de la liste personnalisée.

Exemples de liaison de données pour les éléments de liste personnalisée

La source de données est une entité

Supposons un scénario dans lequel vous référencerez une entité dans le champ Source de données (Data source). Cette entité a une colonne nommée cvxz"FirstName".vcc.

Pour lier cette colonne à une commande Zone de texte dans la Liste personnalisée, vous pouvez utiliser l'expression suivante :

ThisRow.Firstname

La source de données est un objet TableDonnées

Supposons un scénario dans lequel vous référencez un argument TableDonnées d'un processus dans le champ Source de données .

Le type de CeciLigne est DataRow, et sa valeur peut être extraite comme suit :

ThisRow("FieldName")

Assurez-vous de le convertir dans le type approprié.