Steuerelementsammlung (Client-API-Referenz)

Verwenden Sie die controls Auflistung, um auf Steuerelemente zuzugreifen, die Spalten zugeordnet sind.

Wenn Sie Aktionen für Steuerelemente ausführen, die an eine Spalte gebunden sind, sollten Sie berücksichtigen, dass das Steuerelement auf der Seite mehr als einmal angezeigt wird. Im Allgemeinen sollten Sie dieselben Aktionen für jedes Steuerelement für die Spalte ausführen. Sie können die Sammlung von Spaltensteuerelementen durchlaufen und die Aktionen für jedes Steuerelement ausführen.

Wenn Sie beispielsweise jedem Steuerelement, das an die name Spalte gebunden ist, eine Benachrichtigung hinzufügen möchten, verwenden Sie den folgenden Code:

const notification = {
    messages: ['Sample Notification on Name Controls'],
    notificationLevel: 'RECOMMENDATION',
    uniqueId: 'my_unique_id'
 };
 
formContext.getAttribute("name").controls.forEach(control =>
    control.addNotification(notification)
 );

Da jede Spalte mehr als einmal auf der Seite angezeigt werden kann, bietet die Steuerelementauflistung Zugriff auf alle Steuerelemente, die diese Spalte darstellen. Wenn die Spalte nur durch ein Steuerelement auf der Seite dargestellt wird, beträgt die Länge dieser Auflistung 1.

Wenn Sie die GetName-Methode des Steuerelements verwenden, entspricht der Name des ersten Steuerelements dem Namen der Spalte. Die zweite Instanz eines Steuerelements für diese Spalte lautet <columnName>1. Das Muster <columnName>+N wird für jedes zusätzliche Steuerelement fortgesetzt, das dem Formular für eine bestimmte Spalte hinzugefügt wurde.

Wenn ein Formular ein Geschäftsprozessflusssteuerelement in der Kopfzeile anzeigt, fügt es Steuerelemente für jede Spalte hinzu, die im Geschäftsprozessablauf angezeigt wird. Diese Steuerelemente weisen einen eindeutigen Namen wie die folgende auf: header_process_<column name>

Ähnliche Artikel

Spalten (Client-API-Referenz)