Benutzerdefinierte Liste

Die benutzerdefinierte Liste ist ein dynamisches, vorlagenbasiertes Steuerelement, das verschiedene Steuerelemente mit ausgezeichneter Flexibilität enthält. Die benutzerdefinierte Liste ist kein Standard-Listensteuerelement, sondern ermöglicht noch mehr Steuerelemente innerhalb des Layouts, was sie ideal für Aufgaben wie das Erstellen eines effektiven E-Mail-Auflistungsrasters macht.

Eigenschaften

Die benutzerdefinierte Liste verfügt über zwei Sätze von Eigenschaften: einen Satz für das Hauptsteuerelement und einen für die enthaltene Vorlage.

Um zwischen den Eigenschaften einer benutzerdefinierten Liste und ihrer Vorlage umzuschalten, klicken Sie einfach auf das Steuerelement auf der Arbeitsfläche oder wählen Sie es in der Strukturansicht auf der linken Seite aus.

DieseZeile

Verwenden Sie das Schlüsselwort ThisRow , um jede Zeile der benutzerdefinierten Listendaten darzustellen.

Um Werte aus der Datenquelle an einzelne Steuerelemente innerhalb der benutzerdefinierten Liste zu binden, verwenden Sie das Schlüsselwort ThisRow .

Einschränkungen

• Aus Leistungsgründen können mehrere Steuerelemente nicht in eine benutzerdefinierte Liste aufgenommen werden:

  • Bearbeitungsraster
  • Tabelle
  • Benutzerdefinierte Liste
  • Benutzerdefinierter HTML-Code
  • Registerkarten
  Hinweis:

  Für listbasierte Steuerelemente, die vier Elemente überschreiten, empfehlen wir die Verwendung von Dropdown -Steuerelementen.

• Das direkte Verweisen auf Steuerelemente der benutzerdefinierten Liste , z. B. MainPage.Header, ist nicht zulässig, obwohl der Steuerelementname von IntelliSense gefunden wird.

• Das Ziehen von Steuerelementen zwischen dem Kontext einer benutzerdefinierten Liste und anderen Containersteuerelementen kann zu ungültigen Ausdrücken führen, von denen einige nur sichtbar sind, wenn Sie eine Vorschau der App anzeigen. Dies liegt daran, dass die Bindungen im Kontext der benutzerdefinierten Liste (mit dem Schlüsselwort ThisRow ) außerhalb der benutzerdefinierten Liste ungültig werden.

Demo

Verwenden der benutzerdefinierten Liste

Einleitung

Diese App demonstriert die Funktion der benutzerdefinierten Liste .

Demo-App – selbst ausprobieren

Um die benutzerdefinierte Liste selbst auszuprobieren, verwenden Sie die Demo-App.

Laden Sie die Demo-App von GitHub herunter
Vorschau der Demo-App in der Cloud

Demo-App – Verwendungsanweisungen

1. Erstellen Sie in UiPath Apps eine neue App und importieren Sie die heruntergeladene Demo-App.
2. Möglicherweise stellen Sie einige Fehler fest. Um sie zu beheben, ersetzen Sie die referenzierten Entitäten „Country“, „EmailInbox“, „Mitarbeiter“, „Mitarbeiter2“ und „Systembenutzer“ durch Entitäten in Ihrem Mandanten.
3. Um mit den benutzerdefinierten Listenfeldern zu interagieren, zeigen Sie eine Vorschau Ihrer App an.

Allgemein

Benutzerdefinierte Liste

• Ausgeblendet – Bei „true“ wird das Steuerelement während der Laufzeit ausgeblendet.
• Deaktiviert – Wenn dieser Wert auf „false“ festgelegt ist, können App-Benutzer mit der Liste interagieren. Bei „true“ befindet sich die Liste in einem schreibgeschützten Zustand.

Vorlage

• Tooltip – Kurzinfo, die bei der Vorlage angezeigt wird. Damit können Sie zusätzliche Informationen über die Vorlage bereitstellen.
• Ausgeblendet– Bei „true“ wird das Steuerelement während der Laufzeit ausgeblendet.
• Deaktiviert – Wenn dieser Wert auf „false“ festgelegt ist, können App-Benutzer mit der Vorlage interagieren. Bei „true“ befindet sich die Vorlage in einem schreibgeschützten Zustand.

Events

Benutzerdefinierte Liste

• Zeile ausgewählt – Konfigurieren Sie, was passiert, wenn der App-Benutzer eine Zeile (d. h. ein Steuerelement in einer Vorlage) in der benutzerdefinierten Liste auswählt. Konfigurieren Sie, was passiert, wenn der Wert geändert wird.

Vorlage

• Angeklickt – Konfigurieren Sie, was passieren soll, wenn auf die Vorlage geklickt wird.

Stil

Benutzerdefinierte Liste

• Ausrichtung von Steuerelementen – Erbt standardmäßig die übergeordnete Ausrichtung. Eine andere Ausrichtung als die übergeordnete kann festgelegt werden. Um die Standardausrichtung wiederherzustellen, heben Sie die Markierung der überschriebenen Optionen auf.
  Hinweis:

  Die Ausrichtung hängt vom Layout ab, das für das übergeordnete Element ausgewählt wurde (Vertikal vs. Horizontal).

• Layout – Passen Sie die Position der Vorlagen innerhalb der benutzerdefinierten Liste an:
  • Vertikal – Vorlagen werden vertikal angeordnet
  • Horizontal – Vorlagen werden horizontal angeordnet
  • Raster – Vorlagen sind in einem Rasterformat angeordnet
  • Zwischenraum (nur Pixel) – Der Abstand zwischen Vorlagen, wenn sie in einem vertikalen oder horizontalen Layout angeordnet sind.
  • Horizontale / Vertikal Lücke – Der horizontale und vertikale Abstand zwischen Vorlagen, wenn sie in einem Rasterlayout angeordnet sind.
  • Vorlagenbreite – Die Breite der Vorlage.
  • Vorlagenhöhe – Die Höhe der Vorlage.
  Hinweis:

  • In einem horizontalen Layout wird die Breite in Pixeln und die Höhe in Pixeln %, em oder auto festgelegt.
  • In einem vertikalen Layout wird die Höhe in Pixeln angegeben und die Breite kann Pixel, %, em oder auto sein.
  • In einem Rasterlayout müssen sowohl die Höhe als auch die Breite in Pixeln angegeben werden. Relative Einheiten wie %, em oder auto können nicht verwendet werden.
• Seitenrand – Der Rand des Layouts. Standardmäßig ist ein Seitenrand von 4px festgelegt. Die Randeigenschaften Oben/Unten und Links/Rechts werden kombiniert. Diese Eigenschaften können mit der Schaltfläche Link rechts neben dem Abschnitt Seitenrand getrennt werden.
• Größe – Die Breite und Höhe der benutzerdefinierten Liste in Pixeln. Standardwerte:
  • In einem horizontalen Layout: Breite 800 px, Höhe automatisch
  • In einem vertikalen Layout: Breite automatisch, Höhe 400 px
  • In einem Rasterlayout : Breite 800 px, Höhe 400 px. Um Mindest- oder Höchstwerte festzulegen, klicken Sie auf das Drei-Punkte-Symbol (...).

Vorlage

• Ausrichtung von Steuerelementen – Erbt standardmäßig die übergeordnete Ausrichtung. Eine andere Ausrichtung als die übergeordnete kann festgelegt werden. Um die Standardausrichtung wiederherzustellen, heben Sie die Markierung der überschriebenen Optionen auf.
  Hinweis:

  Die Ausrichtung hängt vom Layout ab, das für das übergeordnete Element ausgewählt wurde (Vertikal vs. Horizontal).

• Layout – Legen Sie fest, wie die Steuerelemente innerhalb der Vorlage positioniert werden:
  • Horizontal/Vertikal – Die Ausrichtung der Steuerelemente.
  • Ausrichtung– Die Ausrichtung der Steuerelemente innerhalb der Vorlage.
  • Umbrechen zulassen – Wenn diese Option ausgewählt ist, werden die Steuerelemente in der Vorlage umgebrochen.
  • Bildlauf zulassen – Wenn diese Option ausgewählt ist, kann innerhalb der Vorlage gescrollt werden. Um Bildlauf zulassen aktivieren zu können, muss die Vorlage eine feste Höhe ( vertikales Layout) oder eine feste Breite ( horizontales Layout ) haben.
• Hintergrundfarbe – Die Hintergrundfarbe der Vorlage.
• Rahmen – Der Rahmen für das Steuerelement. Rahmenstärke, Farbe und Radius können konfiguriert werden.
• Schriftart – Die Schriftfamilie für die Vorlage. Alle Steuerelemente innerhalb der Vorlage verwenden dieselbe Schriftfamilie. Standardmäßig erbt die Vorlage die Schriftfamilie der Benutzerdefinierten Liste.
• Seitenrand – Der Rand des Layouts. Standardmäßig ist ein Seitenrand von 0px festgelegt. Die Randeigenschaften Oben/Unten und Links/Rechts werden kombiniert. Diese Eigenschaften können mit der Schaltfläche Link rechts neben dem Abschnitt Seitenrand getrennt werden.
• Abstand – Der Abstand der Vorlage. Standardmäßig ist ein Abstand von 16px festgelegt. Die auf den Seitenrand bezogenen Eigenschaften „Oben/Unten“ und „Links/Rechts“ werden kombiniert. Diese Eigenschaften können mit der Schaltfläche Link rechts neben dem Abschnitt Abstand getrennt werden.
• Erweitert – Zeigt die Flex-Eigenschaften des Steuerelements an.
  • Flex basis – Legt die Originalgröße eines Flex-Elements fest, bevor der zusätzliche Speicherplatz verteilt oder weggenommen wird (px, %, em, auto).
  • Flex grow – Wenn zusätzlicher Platz verfügbar ist, bestimmt dieser Wert, wie sehr ein Flex-Element im Verhältnis zu den restlichen Elementen wachsen soll.
  • Flex shrink – Wenn der Platz nicht ausreicht, bestimmt dieser Wert, wie sehr ein flexibles Element im Vergleich zu den anderen Elementen verkleinert werden soll. Weitere Informationen finden Sie in der Dokumentation zu Mozilla Developer Network.

VB-Eigenschaften

Name der Eigenschaft	Datentyp	Zugriffsberechtigungen	Beispiel
Disabled	Boolescher	Lesen/Schreiben	Bei „true“ wird das Steuerelement zur Laufzeit deaktiviert.
Hidden	Boolescher	Lesen/Schreiben	Bei „true“ wird das Steuerelement zur Laufzeit ausgeblendet.
SelectedItemIndex	Integer	Schreibgeschützt	Gibt den Index der aktuell ausgewählten Zeile zurück: MainPage.CustomList.SelectedItemIndex
ThisRow	Dasselbe wie im Feld Datenquelle .	Schreibgeschützt	Bezieht sich auf den aktuellen Datensatz der Datenquelle. Verwenden Sie diese Option, um Felder innerhalb der benutzerdefinierten Liste zu konfigurieren.

Datenbindungsbeispiele für benutzerdefinierte Listenelemente

Datenquelle ist eine Entität

Angenommen, Sie verweisen auf eine Entität im Feld Datenquelle. Diese Entität hat eine Spalte mit dem Namen cvxz"FirstName".vcc.

Um diese Spalte an ein Textfeldsteuerelement in der Benutzerdefinierten Liste zu binden, können Sie den folgenden Ausdruck verwenden:

ThisRow.Firstname

Datenquelle ist eine Datentabelle

Angenommen, Sie verweisen auf ein Szenario, in dem Sie auf ein Datentabellenargument eines Prozesses im Feld Datenquelle verweisen.

Der Typ von DieseZeile ist Datenzeile, und ihr Wert kann wie folgt extrahiert werden:

ThisRow("FieldName")

Stellen Sie sicher, dass Sie sie in den entsprechenden Typ umwandeln.