مشاركة عبر


formContext.getControl (مرجع واجهة برمجة تطبيقات العميل)

الحصول على عنصر تحكم في النموذج.

Note

getControl يعمل فقط على عناصر التحكم في نص النموذج ورأسه. وهو غير معتمد لعناصر التحكم في مكان آخر على الصفحة، حتى لو كانت تشير إلى العمود نفسه.

بناء الجملة

formContext.getControl(arg);

الأسلوب formContext.getControl(arg) هو أسلوب اختصار للوصول إلى formContext.ui.controls.get.

المعلمة

arg: اختياري. يمكنك الوصول إلى عنصر تحكم في نموذج عن طريق تمرير وسيطة كاسم أو قيمة فهرس عنصر التحكم في نموذج. على سبيل المثال: formContext.getControl("firstname") أو formContext.getControl(0). arg إذا كان الاسم خطأ إملائيا ولم يكن في النموذج، فإنه يرجع قيمة خالية.

arg عندما لا يتم توفير القيمة، فإنها ترجع صفيفا من جميع عناصر التحكم في النموذج.

قيمة الإرجاع

النوع: مجموعة عناصر أو كائن أو قيمة خالية.

الوصف: مجموعة الكائنات إذا كنت تستخدم الأسلوب دون أي معلمات. كائن أو خال إذا كنت تستخدم الأسلوب مع معلمة. إذا كنت تستخدم الاسم كمعلمة وكانت هناك عناصر تحكم متعددة لنفس العمود، إرجاع عنصر التحكم الأول فقط.

التلميح

إذا كنت تريد تعديل كافة عناصر التحكم المرتبطة بعمود في نموذج، فاستخدم مجموعة عناصر التحكم داخل نوع العمود. على سبيل المثال، لإضافة إعلام إلى كل عنصر تحكم مرتبط بالعمود 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