formContext.getControl (Referensi API Klien)

Mendapatkan kontrol pada formulir.

Nota

getControl hanya berfungsi pada kontrol dalam isi formulir dan header. Ini tidak didukung untuk kontrol di tempat lain di halaman, bahkan jika mereka merujuk ke kolom yang sama.

• Untuk kontrol di dalam alur proses bisnis, lihat dengan awalan header_process_.
• Kontrol di dalam kontrol lain seperti subgrid dan kontrol garis waktu tidak didukung.

Syntax

formContext.getControl(arg);

Metode formContext.getControl(arg) adalah metode pintasan untuk mengakses formContext.ui.controls.get.

Pengaturan

arg: Opsional. Anda dapat mengakses kontrol pada formulir dengan meneruskan argumen sebagai nama atau nilai indeks kontrol pada formulir. Sebagai contoh: formContext.getControl("firstname") atau formContext.getControl(0). arg Jika nama dieja salah dan tidak ada dalam formulir, nama tersebut mengembalikan nilai null.

arg Saat nilai tidak disediakan, nilai mengembalikan array dari semua kontrol pada formulir.

Mengembalikan Nilai

Jenis: Koleksi objek, Objek, atau null.

Deskripsi: Koleksi objek jika Anda menggunakan metode tanpa parameter apa pun. Objek atau null jika Anda menggunakan metode dengan parameter . Jika Anda menggunakan nama sebagai parameter dan ada beberapa kontrol untuk kolom yang sama, maka hanya kontrol pertama yang dikembalikan.

Petunjuk / Saran

Jika Anda ingin mengubah semua kontrol yang terikat ke kolom pada formulir, gunakan koleksi kontrol di dalam jenis kolom. Misalnya, untuk menambahkan pemberitahuan ke setiap kontrol yang terikat ke name kolom, Anda bisa melakukan hal berikut:

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

Artikel terkait

formContext