formContext.getControl (Ügyfél API-referencia)

Vezérlőt kap az űrlapon.

Megjegyzés:

getControl csak az űrlap törzsében és fejlécében lévő vezérlőelemeken működik. A vezérlők nem támogatottak a lapon máshol, még akkor sem, ha ugyanarra az oszlopra hivatkoznak.

• Az üzleti folyamatokon belüli vezérlők esetében tekintse meg őket az előtaggal header_process_.
• Más vezérlők, például az alsávok és az idővonal-vezérlők vezérlői nem támogatottak.

Szemantika

formContext.getControl(arg);

A formContext.getControl(arg) metódus a formContext.ui.controls.get eléréséhez használható billentyűparancs.

Paraméter

arg: Nem kötelező. Az űrlap vezérlőihez úgy férhet hozzá, ha egy űrlap vezérlőelemének neveként vagy indexértékeként ad át egy argumentumot. Például: formContext.getControl("firstname") vagy formContext.getControl(0). Ha a arg név hibás, és nem szerepel az űrlapon, null értéket ad vissza.

Ha az arg érték nincs megadva, az űrlap összes vezérlőjének tömbje lesz visszaadva.

Visszaadott érték

Típus: Objektumgyűjtemény, objektum vagy null.

Leírás: Objektumgyűjtemény, ha a metódust paraméterek nélkül használja. Objektum vagy null érték, ha a metódust paraméterrel használja. Ha a nevet paraméterként használja, és ugyanahhoz az oszlophoz több vezérlő is tartozik, akkor csak az első vezérlőelem lesz visszaadva.

Jótanács

Ha módosítani szeretné az űrlap egy oszlopához kötött összes vezérlőt, használja az oszloptípus vezérlőgyűjteményét. Ha például értesítéseket szeretne hozzáadni az name oszlophoz kötött vezérlőkhöz, tegye a következőket:

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

Kapcsolódó cikkek

formContext