formContext.getControl (referenční dokumentace k rozhraní API klienta)

Získá ovládací prvek ve formuláři.

Poznámka:

getControl Funguje pouze u ovládacích prvků v textu formuláře a záhlaví. Ovládací prvky jinde na stránce se nepodporují, i když odkazují na stejný sloupec.

• U ovládacích prvků uvnitř toků obchodních procesů na ně odkazujte s předponou header_process_.
• Ovládací prvky uvnitř jiných ovládacích prvků, jako jsou podmřížky a ovládací prvky časové osy , nejsou podporované.

Syntaxe

formContext.getControl(arg);

Metoda formContext.getControl(arg) je metoda zástupce pro přístup k formContext.ui.controls.get.

Parameter

arg: Volitelné. K ovládacímu prvku ve formuláři můžete získat přístup předáním argumentu jako názvu nebo indexové hodnoty ovládacího prvku ve formuláři. Například: formContext.getControl("firstname") nebo formContext.getControl(0). arg Pokud je název napsaný špatně a není ve formuláři, vrátí hodnotu null.

arg Pokud tato hodnota není zadaná, vrátí pole všech ovládacích prvků ve formuláři.

Návratová hodnota

Typ: Kolekce objektů, Objekt nebo null.

Popis: Kolekce objektů, pokud používáte metodu bez parametrů. Pokud použijete metodu s parametrem, objekt nebo null. Pokud jako parametr použijete název a pro stejný sloupec existuje více ovládacích prvků, vrátí se pouze první ovládací prvek.

Návod

Pokud chcete upravit všechny ovládací prvky vázané na sloupec ve formuláři, použijte kolekci ovládacích prvků uvnitř typu sloupce. Pokud například chcete přidat oznámení ke každému ovládacímu prvku vázanému na name sloupec, můžete udělat toto:

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

Související články

formContext