getFormContext (ügyfél API-referencia)

Az űrlapra vagy az űrlap egy elemére mutató hivatkozást ad vissza attól függően, hogy hol hívták meg a metódust.

Szemantika

ExecutionContextObj.getFormContext()

Visszaadott érték

Típus: Objektum

Leírás: Az űrlapra vagy az űrlap egy elemére( például szerkeszthető rácsra) mutató hivatkozást ad vissza a metódus meghívásának helyétől függően. Ez a módszer lehetővé teszi, hogy olyan gyakori eseménykezelőket hozzon létre, amelyek az űrlapon vagy az űrlap egy elemén is működhetnek attól függően, hogy hol van a neve.

Example

Az alábbi mintakód bemutatja, hogyan hozhat létre olyan metódust, amely az értesítési adatokat űrlaposzlopon vagy szerkeszthető rácscellán állítja be attól függően, hogy hol regisztrálta a szkriptet (Column OnChange esemény vagy szerkeszthető rács OnChange esemény):

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

Kapcsolódó cikkek

Végrehajtási környezet
Űrlapkörnyezet