RepeaterControl

Aus Formupedia

Wechseln zu: Navigation, Suche

Inhaltsverzeichnis


Beschreibung

Mit dem RepeaterControl können wiederkehrende Strukturen und Elemente erzeugt werden. Dabei ist es ausreichend eine Vorlage in Form einer Zeile zu gestalten. Diese Zeile kann in bestimmter Anzahl wiederholt werden, wobei der Formularentwickler eine feste Anzahl vorgeben, aber auch den Ausfüller die Anzahl der Zeilen bestimmen lassen kann.

Mit dem RepeaterControl können bequem einfache Berechnungen erstellt werden. Für das Erstellen der Summe über alle Controls im Repeater wurde eine Funktion im Funktionseditor hinterlegt. Dabei ist zu beachten, dass das AusgabeControl außerhalb des RepeaterControls liegen muss.

Eine einfache Anwendung für das RepeaterControl sind Tabellen. Repeater sind ab Version 5.4 auch für Webformulare verfügbar.

Eigenschaften

Eigenschaft Beschreibung
Schaltflächen
ShowAdd

Angabe, ob der Button für das Hinzufügen einer Zeile angezeigt werden soll. Die hinzugefügte Zeile erscheint am Ende.

Angabe: True (Ja) oder False (Nein)

ShowRemove Angabe, ob der Button für das Entfernen einer Zeile angezeigt werden soll. Es wird immer die letzte Zeile entfernt.

Angabe: True (Ja) oder False (Nein)

ShowRowRemove

Angabe, ob der Button für das Entfernen einer Zeile in jeder Zeile angezeigt werden soll. Jede Zeile kann separat entfernt werden. 

Angabe: True (Ja) oder False (Nein)

Wiederholung
Anzahl

Angabe der sichtbaren Zeilen

Autosize

Angabe, ob das Control während des Hinzufügens neuer Zeilen wachsen soll oder ob die Größe des Controls erhalten bleiben soll (mit Scrollbar)

Angabe: True (Ja) oder False (Nein)

Maximum

Angabe der maximalen Anzahl von Zeilen

Minimum Angabe der minimalen Anzahl von Zeilen
StartIndex

Angabe des Namenssuffix für Controls innerhalb des Repeaters. Der Start kann manuell festgelegt werden, der Index wird anschließend inkrementiert.

Zeilenabstand Angabe eines festen Zeilenabstandes


Entwurf
AlternateColor

Alternierende Hintergrundfarbe für Repeaterzeile, wenn kein Hintergrundbild verwendet wird.

BackImage

Hintergrundbild für das Element

prefix

Prefix für die interne Bezeichnung der Controls.

RowBackImage Hintergrundbild für einzelne Wiederholung

Beispiele

Beispiele folgen noch und werden als Anwendungsbeispiele integriert.

Tipps & Tricks

Auslesen von Werten aus bestimmten Zeilen

Es kann notwendig sein, dass bestimmte Werte des Repeater-Controls ausgelesen werden müssen.

Dafür gibt es ein paar hilfreiche Funktionen:

Annahme: Es existiert ein Repeater-Control [@rp_Test], mit einer TextBox [@txt_Test] und einer ComboBox [@cb_Test].

Wie lautet der Wert der TextBox [@txt_Test] einer Zeile n?

[@rp_Testtxt_Test_n]

Wie lautet der Wert der TextBox [@txt_Test] der letzten Zeile?

Schritt 1: Auslesen, welche Zeile die letzte ist.
Der Variable [$LetzteZeile] wird der Wert [![@rp_Test]-1:0] zugewiesen.
Schritt 2: Wert übergeben und gewünschtes Feld auslesen
[@rp_Testtxt_Test_[$LetzteZeile]]

Persönliche Werkzeuge