formContext.getControl (İstemci API başvurusu)

Formda bir denetim alır.

Uyarı

getControl yalnızca form gövdesindeki ve üst bilgisindeki denetimlerde çalışır. Aynı sütuna başvursalar bile, sayfanın başka bir yerindeki denetimler için desteklenmez.

• İş süreci akışlarının içindeki denetimler için ön ekine header_process_başvurun.
• Alt kılavuzlar ve zaman çizelgesi denetimleri gibi diğer denetimlerin içindeki denetimler desteklenmez.

Sözdizimi

formContext.getControl(arg);

formContext.getControl(arg) yöntemi, formContext.ui.controls.get öğesine erişmek için bir kısayol yöntemidir.

Parametre

arg: İsteğe bağlı. Formdaki bir denetime, bir bağımsız değişkeni formdaki denetimin adı veya dizin değeri olarak geçirerek erişebilirsiniz. Örneğin: formContext.getControl("firstname") veya formContext.getControl(0). arg Ad yanlış yazılmışsa ve formda değilse null değer döndürür.

Değer sağlanmazsa arg , formdaki tüm denetimlerin bir dizisini döndürür.

Dönüş Değeri

Tür: Nesne koleksiyonu, Nesne veya null.

Açıklama: Herhangi bir parametre olmadan yöntemini kullanıyorsanız nesne koleksiyonu. yöntemini bir parametreyle kullanıyorsanız nesne veya null. Adı parametre olarak kullanırsanız ve aynı sütun için birden çok denetim varsa, yalnızca ilk denetim döndürülür.

Tavsiye

Formdaki bir sütuna bağlı tüm denetimleri değiştirmek istiyorsanız, sütun türünün içindeki denetimler koleksiyonunu kullanın. Örneğin, sütuna bağlı her denetime bildirim eklemek için name aşağıdakileri yapabilirsiniz:

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

İlgili makaleler

formContext