formContext.getControl (αναφορά API προγράμματος-πελάτη)

Λαμβάνει ένα στοιχείο ελέγχου στη φόρμα.

Σημείωμα

getControl Το λειτουργεί μόνο σε στοιχεία ελέγχου στο σώμα και την κεφαλίδα της φόρμας. Δεν υποστηρίζεται για στοιχεία ελέγχου σε κάποιο άλλο σημείο της σελίδας, ακόμη και αν αναφέρονται στην ίδια στήλη.

• Για στοιχεία ελέγχου μέσα σε ροές επιχειρηματικής διαδικασίας, ανατρέξτε σε αυτά με το πρόθεμα header_process_.
• Τα στοιχεία ελέγχου που βρίσκονται μέσα σε άλλα στοιχεία ελέγχου, όπως τα δευτερεύοντα πλέγματα και ταστοιχεία ελέγχου λωρίδας χρόνου , δεν υποστηρίζονται.

Σύνταξη

formContext.getControl(arg);

Η μέθοδος formContext.getControl(arg) είναι μια μέθοδος συντόμευσης για πρόσβαση στη formContext.ui.controls.get.

Παράμετρος

arg: Προαιρετικό. Μπορείτε να αποκτήσετε πρόσβαση σε ένα στοιχείο ελέγχου σε μια φόρμα διαβιβάζοντας ένα όρισμα είτε ως όνομα είτε ως τιμή ευρετηρίου του στοιχείου ελέγχου σε μια φόρμα. Για παράδειγμα: formContext.getControl("firstname") ή formContext.getControl(0). Εάν το arg όνομα είναι ορθογραφικό λάθος και δεν είναι στη φόρμα, επιστρέφει τιμή null.

Όταν η arg τιμή δεν παρέχεται, επιστρέφει έναν πίνακα με όλα τα στοιχεία ελέγχου στη φόρμα.

Τιμή επιστροφής

Τύπος: Συλλογή αντικειμένων, Αντικείμενο ή null.

Περιγραφή: Συλλογή αντικειμένων εάν χρησιμοποιείτε τη μέθοδο χωρίς παραμέτρους. Αντικείμενο ή null εάν χρησιμοποιείτε τη μέθοδο με μια παράμετρο. Εάν χρησιμοποιείτε το όνομα ως παράμετρο και υπάρχουν πολλαπλά στοιχεία ελέγχου για την ίδια στήλη, επιστρέφεται μόνο το πρώτο στοιχείο ελέγχου.

Φιλοδώρημα

Εάν θέλετε να τροποποιήσετε όλα τα στοιχεία ελέγχου που είναι συνδεδεμένα σε μια στήλη σε μια φόρμα, χρησιμοποιήστε τη συλλογή στοιχείων ελέγχου μέσα στον τύπο στήλης. Για παράδειγμα, για να προσθέσετε ειδοποίηση σε κάθε στοιχείο ελέγχου που είναι δεσμευμένο στη name στήλη, μπορείτε να κάνετε τα εξής:

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

Σχετικά άρθρα

formContext