getFormContext (Rujukan API Klien)

Mengembalikan rujukan kepada borang atau item pada borang bergantung pada tempat kaedah dipanggil.

Sintaks

ExecutionContextObj.getFormContext()

Nilai pulangan

Jenis: Objek

Perihalan: Mengembalikan rujukan kepada borang atau item pada borang seperti grid boleh diedit bergantung pada tempat kaedah dipanggil. Kaedah ini membolehkan anda mencipta pengendali peristiwa biasa yang boleh beroperasi sama ada pada borang atau item pada borang bergantung pada tempat ia dipanggil.

Contoh

Kod sampel berikut menunjukkan cara anda boleh mencipta kaedah yang mengesetkan pemberitahuan pada lajur borang atau sel grid boleh diedit bergantung pada tempat anda mendaftarkan skrip (peristiwa OnChange Lajur atau peristiwa OnChange grid boleh diedit):

function commonEventHandler(executionContext) {
    var formContext = executionContext.getFormContext();    
    var telephoneAttr = formContext.data.entity.attributes.get('telephone1');
    var isNumberWithCountryCode = telephoneAttr.getValue().substring(0,1) === '+';

    // telephoneField will be a form control if invoked from a form OnChange event;
    // telephoneField will be a editable grid GridCell object if invoked from editable grid OnChange event.
    var telephoneField = telephoneAttr.controls.get(0);

    if (!isNumberWithCountryCode) {
        telephoneField.setNotification('Please include the country code beginning with '+'.', 'countryCodeNotification');
    }
    else {
        telephoneField.clearNotification('countryCodeNotification');
    }
}

Artikel berkaitan

Konteks pelaksanaan
Konteks borang