getFormContext (kliento API nuoroda)

Grąžina nuorodą į formą arba formos elementą, atsižvelgiant į metodo iškvietą.

Sintaksė

ExecutionContextObj.getFormContext()

Pateikiama reikšmė

Tipas: Objektas

Aprašas: pateikia nuorodą į formą arba formos elementą, pvz., redaguojamą tinklelį, atsižvelgiant į tai, kur buvo iškviestas metodas. Šis metodas leidžia kurti įprastas įvykių apdorojimo programas, kurios gali veikti formoje arba formos elemente, atsižvelgiant į iškvietos vietą.

Pavyzdys

Toliau pateiktame kodo pavyzdyje parodoma, kaip galite sukurti metodą, kuris nustato pranešimą formos stulpelyje arba redaguojamame tinklelio langelyje, atsižvelgiant į tai, kur užregistravote scenarijų (įvykis Stulpelio onChange arba redaguojamas tinklelis OnChange įvykis):

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');
    }
}

Susiję straipsniai

Vykdymo kontekstas
Formos kontekstas