إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
تبدأ الأحداث جميع التعليمات البرمجية من جانب العميل. في التطبيقات المستندة إلى النموذج، يمكنك إقران وظيفة معينة في مكتبة JavaScript (مورد ويب البرنامج النصي) ليتم تنفيذها عند حدوث حدث. تسمى هذه الدالة معالج الأحداث. يحدد كل معالج أحداث دالة واحدة داخل مكتبة JavaScript وأي معلمات يمكن تمريرها إلى الدالة.
يمكنك إقران معالجات الأحداث ببعض الأحداث فقط باستخدام واجهة المستخدم. بالنسبة للأحداث غير المتوفرة ليتم إقرانها من خلال واجهة المستخدم، توفر واجهة برمجة تطبيقات العميل أساليب يمكن استخدامها لإرفاق معالجات الأحداث بمثل هذه الأحداث.
إضافة دالة معالج الأحداث إلى الحدث أو إزالتها باستخدام واجهة المستخدم
استخدم قسم معالجات الأحداث في مربع الحوار خصائص النموذج لإقران البرنامج النصي بحدث للنماذج والأعمدة.
نماذج التحرير المجمع
بشكل افتراضي، لا يتم استدعاء معالجات الأحداث عندما يكون النموذج في وضع التحرير المجمع.
لتمكين معالج أحداث في وضع التحرير المجمع، قم بتعديل Form XML عن طريق العثور على العنصر ذي الصلة event وإنشاء/تعيين السمة BehaviorInBulkEditForm إلى Enabled. حاليا، هذا مدعوم فقط لأحداث OnLoad.
لمزيد من المعلومات حول تخصيص Form XML، راجع متى يتم تحرير ملف التخصيصات وتخصيص النماذجومخطط Form XML.
لتحديد وقت استدعاء معالج حدث في نموذج في وضع التحرير المجمع، استخدم getFormType الأسلوب .
إضافة دالة معالج الأحداث إلى الحدث أو إزالتها باستخدام التعليمات البرمجية
استخدام الأساليب التالية لإضافة معالج الأحداث وإزالته للأحداث التي لا يمكن إقرانها من خلال واجهة المستخدم:
| Events | معالج الأحداث |
|---|---|
| تغيير السمة | أساليب addOnChange و removeOnChange |
| تحميل النموذج | أساليب formContext.ui addOnLoad و removeOnLoad |
| تم تحميل النموذج | formContext.ui addLoaded و removeLoaded methods |
| بيانات النموذج عند التحميل | formContext.data addOnLoad وأساليب removeOnLoad |
| حفظ النموذج | أساليب addOnSave و removeOnSave |
| عنصر تحكم البحث PreSearch | addPreSearchوإزالة أساليبPreSearch |
| عنصر تحكم kbsearch OnResultOpened | addOnResultOpened و removeOnResultOpened methods |
| عنصر تحكم kbsearch OnSelection | أساليب addOnSelection و removeOnSelection |
| التحكم في kbsearch PostSearch | أساليب addOnPostSearch و removeOnPostSearch |
مهم
يتم تمرير سياق التنفيذ تلقائيا كمعلمة أولى إلى الوظائف التي تم تعيينها باستخدام التعليمات البرمجية. مزيد من المعلومات: سياق تنفيذ واجهة برمجة تطبيقات العميل
مسار حدث النموذج
يمكنك تحديد ما يصل إلى 50 معالج أحداث لكل حدث. يتم تنفيذ كل معالج أحداث بالترتيب الذي يتم عرضه في قسم معالجات الأحداث في علامة التبويب الأحداث في مربع الحوار خصائص النموذج .
استخدم أساليب setSharedVariable و getSharedVariable لتمرير متغير مشترك بين معالجات الأحداث (الوظائف). استخدم أسلوب getDepth لسياق التنفيذ لمعرفة التسلسل الذي يتم تنفيذ معالج أحداث به بالنسبة لمعالجات الأحداث الأخرى.
المقالات ذات الصلة
فهم نموذج كائن واجهة برمجة تطبيقات العميل
سياق تنفيذ واجهة برمجة تطبيقات العميل
الأحداث (مرجع واجهة برمجة تطبيقات العميل)