getFormContext (Referencia da API do cliente)

Devolve unha referencia ao formulario ou a un elemento do formulario dependendo de onde se chamou o método.

Sintaxe

ExecutionContextObj.getFormContext()

Valor devolto

Tipo: Obxecto

Descrición: Devolve unha referencia ao formulario ou a un elemento do formulario, como a grella editable, dependendo de onde se chamou o método. Este método permítelle crear xestores de eventos comúns que poden operar nun formulario ou nun elemento do formulario, dependendo de onde se chame.

Exemplo

O seguinte código de exemplo mostra como pode crear un método que estableza a notificación nunha columna de formulario ou unha cela de grella editable dependendo de onde rexistrou o script (evento Column OnChange ou evento OnChange da grella editable):

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

Artigos relacionados

Contexto de execución
Contexto do formulario