مشاركة عبر


getFormContext (مرجع واجهة برمجة تطبيقات العميل)

إرجاع مرجع إلى النموذج أو عنصر في النموذج استنادا إلى مكان استدعاء الأسلوب.

بناء الجملة

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

سياق التنفيذ
سياق النموذج