Share via

formContext.getControl (Client-API-Referenz)

  • Artikel

Ruft ein Steuerelement im Formular auf.

Hinweis

getControl funktioniert nur bei Steuerelementen im Text und in der Kopfzeile des Formulars. Es wird für Steuerelemente an anderen Stellen auf der Seite nicht unterstützt, selbst wenn sie auf dieselbe Spalte verweisen.

Syntax

formContext.getControl(arg);

Die formContext.getControl (arg)-Verknüpfungsmethode, um auf formContext.ui.controls.get zuzugreifen.

Parameter

arg: Optional. Sie können auf ein Steuerelement in einem Formular zugreifen, indem Sie das Argument entweder als Name oder Indexwert des Steuerelements in einem Formular übergeben. Beispiel: formContext.getControl("firstname") oder formContext.getControl(0). Wenn der arg-Name falsch geschrieben ist und sich nicht im Formular befindet, wird der Nullwert zurückgegeben.

Wenn der arg-Wert nicht angegeben wird, wird ein Array aller Steuerelemente im Formular zurückgegeben.

Rückgabewert

Typ: Objektsammlung, Objekt oder NULL.

Beschreibung: Objektsammlung, wenn Sie die Methode ohne Parameter verwenden. Objekt oder NULL, wenn Sie die Methode mit einem Parameter verwenden. Wenn Sie den Namen als Parameter verwenden und mehrere Steuerelemente für die gleiche Spalte vorhanden sind, wird nur das erste Steuerelement zurückgegeben.

Tipp

Wenn Sie alle Steuerelemente ändern möchten, die an die Spalte in einem Formular gebunden sind, verwenden Sie die Steuerelementauflistung innerhalb des Spaltentyps. Um jedem Steuerelement, das an die Spalte name Spalte gebunden ist, eine Benachrichtigung hinzuzufügen, können Sie beispielsweise Folgendes tun:

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

formContext

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).