إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
تبدأ الأحداث في النماذج والشبكات جميع التعليمات البرمجية من جانب العميل في التطبيقات المستندة إلى النموذج. يمكنك إقران دالة معينة في مكتبة JavaScript (مورد ويب البرنامج النصي) ليتم تنفيذها عند حدوث حدث. تسمى هذه الدالة معالج الأحداث. يحدد كل معالج أحداث دالة واحدة داخل مكتبة JavaScript وأي معلمات يمكن تمريرها إلى الدالة.
يمكنك إقران معالجات الأحداث ببعض الأحداث فقط باستخدام واجهة المستخدم. بالنسبة للأحداث التي لا يمكنك إقرانها من خلال واجهة المستخدم، توفر واجهة برمجة تطبيقات العميل أساليب يمكنك استخدامها لإرفاق معالجات الأحداث.
إضافة دالات معالج الأحداث أو إزالتها في النماذج باستخدام واجهة المستخدم
لإضافة أو إزالة دالات معالج الأحداث للأحداث في الواجهة الموحدة الجديدة:
انتقل إلى Power Apps.
في جزء التنقل الأيمن، حدد البيانات ثم حدد الجداول.
من قائمة الجداول، حدد الجدول حيث تريد إضافة معالجات الأحداث.
حدد علامة التبويب نماذج من شريط الأوامر ثم حدد النموذج الذي تريد إضافة معالج الأحداث إليه.
حدد علامة التبويب الأحداث . ترى كلا معالجي الأحداث عند الحفظوالتحميل .
لإضافة معالج أحداث لحدث التغيير، حدد العمود ثم حدد علامة التبويب الحدث .
نماذج التحرير المجمع
بشكل افتراضي، لا يتم تشغيل معالجات الأحداث عندما يكون النموذج في وضع التحرير المجمع.
لتمكين معالج أحداث في وضع التحرير المجمع، قم بتعديل 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 لسياق التنفيذ لفهم تسلسل تنفيذ معالج الأحداث بالنسبة لمعالجات الأحداث الأخرى.
المقالات ذات الصلة
فهم نموذج كائن واجهة برمجة تطبيقات العميل
سياق تنفيذ واجهة برمجة تطبيقات العميل
الأحداث (مرجع واجهة برمجة تطبيقات العميل)