formContext.getControl (Rujukan API Klien)

Mendapat kawalan pada borang.

Nota

getControl hanya berfungsi pada kawalan dalam badan borang dan pengepala. Ia tidak disokong untuk kawalan di tempat lain pada halaman, walaupun ia merujuk kepada lajur yang sama.

• Untuk kawalan dalam aliran proses perniagaan, rujuk kepada mereka dengan awalan header_process_.
• Kawalan dalam kawalan lain seperti subgrid dan kawalan garis masa tidak disokong.

Sintaks

formContext.getControl(arg);

Kaedah formContext.getControl(arg) ialah kaedah pintasan untuk mengakses formContext.ui.controls.get.

Parameter_

arg: Pilihan. Anda boleh mengakses kawalan pada borang dengan menghantar argumen sama ada nama atau nilai indeks kawalan pada borang. Sebagai contoh: formContext.getControl("firstname") atau formContext.getControl(0). Jika arg nama salah dieja dan tiada pada borang, ia mengembalikan nilai nol.

Apabila arg nilai tidak disediakan, ia mengembalikan tatasusunan semua kawalan pada borang.

Nilai Pulangan

Jenis: Koleksi objek, Objek atau null.

Penerangan: Pengumpulan objek jika anda menggunakan kaedah tanpa sebarang parameter. Objek atau null jika anda menggunakan kaedah dengan parameter. Jika anda menggunakan nama sebagai parameter dan terdapat berbilang kawalan untuk lajur yang sama, maka hanya kawalan pertama yang dikembalikan.

Tip

Jika anda mahu mengubah suai semua kawalan terikat pada lajur pada borang, gunakan koleksi kawalan dalam jenis lajur. Contohnya, untuk menambah pemberitahuan pada setiap kawalan yang terikat pada name lajur, anda boleh melakukan perkara 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 berkaitan

bentukKonteks