إنشاء معالج الأحداث

هام: تمت ترجمة هذه المقالة ترجمة آلية، راجع إقرار إخلاء المسؤولية. يرجى الاطلاع على النسخة الإنجليزية من هذه المقالة. هنا للرجوع إليها.

عند كتابه برنامج نصي ل# قالب نموذج Microsoft Office InfoPath، يمكنك عاده ب# كتابه التعليمات البرمجيه في احد النموذج معالجات الاحداث التحقق من صحه البيانات او قالب. معالج احداث هو رمز الداله في قالب نموذج InfoPath يستجيب ل# اجراء مستخدم او تغيير بيانات XML في نموذج. تعتمد كيفيه انشاء معالج احداث علي نوع الحدث الذي تريد استخدامه. من المهم ان انشاء معالج الاحداث في وضع التصميم ل# ان InfoPath تلقائيا انشاء تعريفات ل# معالجات الاحداث في ملف البرنامج النصي و# عمل الادخالات في ملف تعريف (.xsf) النموذج التي تمكنك من قالب نموذج ل# استخدام معالجات الاحداث.

ملاحظة: على الرغم من أنه يمكنك إنشاء معالجات أحداث يدوياً في ملف البرنامج النصي، ثم تمكينها عن طريق إضافة العناصر الصحيحة يدوياً إلى ملف .xsf، إلا أن استخدام هذا الخيار لا يعتبر مفضلاً. إذا تم إجراء تغيير غير صحيح على ملف .xsf، قد لا يكون قالب النموذج قابل للاستخدام.

يسرد الجدول التالي كل من معالجات InfoPath و# الخطوات اللازمه ل# انشائها. عند انشاء معالج احداث ل# قالب نموذج، يبدا تشغيل Microsoft Script Editor (MSE) InfoPath و# يقوم ب# وضع المؤشر في التعليمات البرمجيه ل# هذا الحدث. يمكنك ثم كتابه البرنامج النصي ل# معالج الاحداث. ل# الحصول علي معلومات مفصله حول احداث و# معالجات الاحداث، راجع مرجع المطور InfoPath، الذي يتوفر في تعليمات MSE.

Event handler

Description

Steps for creating

OnAfterChange

يعمل هذا الحدث بعد مستخدم ب# تغيير القيمه في عنصر التحكم المحدد مرتبط ب# حقل. علي سبيل المثال، يمكنك عرض جزء مهام تنسيق HTML مخصص بعد قام مستخدم ب# تحديد عنصر ما في عنصر تحكم مربع قائمه. يتم تشغيل هذا الحدث بعد الحدث OnValidate .

زر الماوس الايمن فوق عنصر تحكم علي قالب النموذج او حقل في جزء المهام مصدر البيانات، و# اشر الي البرمجه القائمه المختصره، و# من ثم انقر فوق عند حدث بعد التغيير.

OnAfterImport

يعمل هذا الحدث بعد المستخدم ب# نجاح ب# دمج نماذج متعدده في نموذج واحد.

اضافه تعريف معالج الحدث أونافتيريمبورت يدويا الي ملف البرنامج النصي مباشره ب# استخدام محرر البرامج النصيه. لا يمكن انشاء معالج الاحداث هذا في وضع التصميم.

OnBeforeChange

يتم تشغيل هذا الحدث بعد مستخدم ب# تغيير القيمه في عنصر تحكم و# قبل ان تتم اضافه القيمه ل# الحقل المحدد المرتبط ب# عنصر التحكم هذا. علي سبيل المثال، يمكنك منع مستخدم من اضافه صف اضافيه قبل تعبئه الصف الاخير في جدول مكرر.

زر الماوس الايمن فوق عنصر تحكم علي قالب النموذج او حقل في جزء المهام مصدر البيانات، و# اشر الي البرمجه القائمه المختصره، و# من ثم انقر فوق عند حدث قبل التغيير.

OnClick

يتم تشغيل هذا الحدث عندما ينقر مستخدم فوق زر المقترنه ب# هذا الحدث. يتوفر هذا الحدث بعد اضافه زر الي قالب النموذج. علي سبيل المثال، يمكنك تنفيذ عمليه حسابيه معقده ب# استخدام القيم في حقول في مصدر البيانات الرئيسي عندما ينقر مستخدم فوق الزر.

انقر نقرا مزدوجا فوق عنصر تحكم زر و# ثم علي علامه التبويب عام من مربع الحوار خصائص الزر، انقر فوق تحرير التعليمات البرمجيه النموذج.

OnContextChange

يتم تشغيل هذا الحدث عندما يتغير التركيز في النموذج. علي سبيل المثال، يعمل هذا الحدث عندما ينتقل مستخدم من مربع نص الي منتقي تاريخ، او عند مستخدم ل# تبديل طرق العرض. هذا الحدث بعد حدثت كافه الاحداث الاخري.

علي القائمه ادوات، اشر الي البرمجه، و# من ثم انقر فوق علي حدث تغيير السياق.

OnLoad

يعمل هذا الحدث متي مستخدم يقوم ب# انشاء نموذج جديد او فتح نموذج الحالي استنادا الي قالب النموذج الخاص بك. علي سبيل المثال، يمكنك نسخ قائمه ب# العناصر من مصدر بيانات ثانوي ل# مصدر البيانات الرئيسي عند قيام مستخدم ب# فتح النموذج.

علي القائمه ادوات، اشر الي البرمجه، و# من ثم انقر فوق عند حدث التحميل.

OnMergeRequest

يتم تشغيل هذا الحدث عند دمج النماذج التي تستند الي قالب النموذج الخاص بك. علي سبيل المثال، يمكنك عرض عدد النماذج التي تم دمجها ل# منح مستخدم ب# حاله اثناء عمليه الدمج.

علي القائمه ادوات، انقر فوق " خيارات النموذج ". في القائمه الفئه، انقر فوق خيارات متقدمه. ضمن دمج النماذج، حدد خانه الاختيار دمج ب# استخدام تعليمات برمجيه مخصصه، و# من ثم انقر فوق تحرير.

OnSaveRequest

يتم تشغيل هذا الحدث عندما يقوم مستخدم ب# حفظ نموذج يستند الي قالب النموذج الخاص بك. علي سبيل المثال، يمكنك حفظ النموذج استنادا الي قالب النموذج هذا ل# اكثر من موقع عندما يقوم مستخدم ب# حفظ النموذج. يضيف InfoPath السطرين مزيد من التعليمات البرمجيه ل# هذا الحدث: يعلمك خط يحفظ النموذج و# سيضاف سطر اذا InfoPath حفظ النموذج ب# شكل ناجح.

علي القائمه ادوات، انقر فوق " خيارات النموذج ". في القائمه الفئه، انقر فوق فتح و# حفظ. ضمن سلوك الحفظ، حدد خانه الاختيار حفظ استخدام تعليمات برمجيه مخصصه، و# من ثم انقر فوق تحرير.

OnSign

يتم تشغيل هذا الحدث عند مستخدم ل# تطبيق توقيع رقمي الي نموذج. علي سبيل المثال، يمكنك اضافه بيانات اضافيه ل# التوقيع الرقمي ل# نموذج تقرير مصاريف عندما يسجل مستخدم فوقه.

علي القائمه ادوات، اشر الي البرمجه، و# من ثم انقر فوق حدث التوقيع علي.

OnSubmitRequest

يتم تشغيل هذا الحدث عند قيام مستخدم ب# ارسال بيانات النموذج الخاصه به او بها. علي سبيل المثال، يمكنك ارسال بيانات النموذج الي خدمه ويب امن عندما ينقر المستخدم فوق ارسال علي القائمه " ملف ". يدعم InfoPath اتصال بيانات خدمه ويب امن، ستحتاج الي اضافه اتصال بيانات مخصص الذي يعمل مع خدمه ويب امن.

علي القائمه ادوات، انقر فوق خيارات الارسال. حدد خانه الاختيار السماح ل# المستخدمين ب# ارسال هذا النموذج، انقر فوق تنفيذ اجراء مخصص ب# استخدام التعليمات البرمجيه و# من ثم انقر فوق تحرير التعليمات البرمجيه.

OnSwitchView

هذا الحدث تشغيله عند قيام مستخدم ب# فتح نموذج يستند الي قالب النموذج الخاص بك او التبديل الي طريقه عرض اخري في النموذج. علي سبيل المثال، عندما يقوم مستخدم ب# التبديل الي طريقه عرض محدده، يمكنك انشاء رساله بريد الكتروني تحتوي علي بيانات من الحقول في مصدر البيانات الرئيسي الخاص ب# النموذج.

علي القائمه ادوات، انقر فوق البرمجه، و# ثم انقر فوق علي تبديل عرض الحدث.

OnValidate

يتم تشغيل هذا الحدث عند مستخدم ب# تغيير القيمه في عنصر تحكم منضم الي حقل. علي سبيل المثال، عند المستخدم ب# تغيير القيمه في عنصر تحكم معينه، يمكنك حساب قيمه جديده ل# عنصر تحكم اخر ب# استخدام الرقم الذي تم ادخاله المستخدم و# رقم في البرنامج النصي. هذا الحدث بعد تشغيل معالج الحدث OnBeforeChange .

زر الماوس الايمن فوق عنصر تحكم علي قالب النموذج او حقل في جزء المهام مصدر البيانات، و# اشر الي برمجه القائمه المختصره، و# من ثم انقر فوق علي بعد التحقق من صحه حدث.

OnVersionUpgrade

يتم تشغيل هذا الحدث عند قيام مستخدم ب# فتح نموذج موجود ورقم اصدار قالب النموذج المستخدمه ب# واسطه النموذج الموجود اقدم من رقم اصدار قالب النموذج في موقع النشر. عند قيام مستخدم ب# فتح نموذج موجود، يتحقق InfoPath رقم اصدار قالب النموذج المقترن ب# النموذج الموجود. اذا كان قالب النموذج رقم اصدار احدث، يقوم InfoPath ب# تشغيل معالج الاحداث أونفيرسيون عند قيام المستخدم ب# فتح النموذج الموجود. علي سبيل المثال، افترض انك اضافه حقل جديد الي قالب نموذج موجود و# اعاده نشره، و# الذي تريد ان الحقل جديد ل# اضافتها الي مصدر البيانات الاساسي اذا قام مستخدم ب# فتح نموذج موجود. يضيف هذا الحدث الحقل الجديد الي مصدر البيانات الرئيسي عند قيام مستخدم ب# فتح نموذج موجود.

علي القائمه ادوات، انقر فوق " خيارات النموذج ". في القائمه الفئه، انقر فوق تعيين الاصدار. في القائمه عند ترقيه الاصدار، انقر فوق استخدام حدث مخصص، و# من ثم انقر فوق تحرير.

ملاحظة: إقرار إخلاء المسؤولية للترجمة الآلية: تمت ترجمة هذه المقالة بواسطة نظام كمبيوتر دون تدخل العامل البشري. توفر Microsoft هذه الترجمات الآلية لمساعدة المستخدمين الذين لا يتحدثون الإنجليزية على استخدام منتجات Microsoft، وخدماتها، وتقنياتها والاستمتاع بها. قد تحتوي هذه المقالة على أخطاء في المفردات، أو بناء الجملة، أو القواعد نظرًا لترجمتها آليًا.

توسيع المهارات
استكشاف التدريب
الحصول على الميزات الجديدة أولاً
الانضمام إلى Office Insider

هل كانت المعلومات مفيدة؟

نشكرك على ملاحظاتك!

شكراً لك على الملاحظات! يبدو أنه من المفيد إيصالك بأحد وكلاء دعم Office لدينا.

×