Поділитися через


getFormContext (довідник з API клієнта)

Повертає посилання на форму або елемент у формі залежно від того, куди викликано метод.

Синтаксис

ExecutionContextObj.getFormContext()

Значення, що повертається

Тип: Об'єкт

Опис. Повертає посилання на форму або елемент у формі, наприклад сітку, яку можна редагувати, залежно від того, куди викликано метод. Цей метод дає змогу створювати типові обробники подій, які можуть працювати на формі або в елементі форми залежно від того, куди її називають.

Приклад

Наведений нижче зразок коду демонструє, як можна створити метод, який задає сповіщення в стовпці форми або клітинці сітки, яку можна редагувати, залежно від того, де зареєстровано сценарій (подія Column OnChange або доступна для редагування сітка OnChange ):

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

контексту виконання
Контекст форми