Delen via


getFormContext (client-API-verwijzing)

Retourneert een verwijzing naar het formulier of een item op het formulier, afhankelijk van waar de methode is aangeroepen.

Syntaxis

ExecutionContextObj.getFormContext()

Retourwaarde

Type: Object

Beschrijving: Retourneert een verwijzing naar het formulier of een item in het formulier, zoals bewerkbaar raster, afhankelijk van waar de methode is aangeroepen. Met deze methode kunt u algemene gebeurtenis-handlers maken die kunnen worden uitgevoerd op een formulier of een item in het formulier, afhankelijk van waar het formulier is aangeroepen.

Example

In de volgende voorbeeldcode ziet u hoe u een methode kunt maken waarmee een melding wordt ingesteld voor een formulierkolom of bewerkbare rastercel, afhankelijk van waar u het script hebt geregistreerd (Column OnChange-gebeurtenis of bewerkbare grid OnChange-gebeurtenis ):

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

Uitvoeringscontext
Formuliercontext