الأحداث في مشاريع Office

ينطبق على
تنطبق المعلومات الموجودة في هذا الموضوع فقط على أنواع المشاريع وإصدارات Microsoft Office التالية: لمزيد من المعلومات، راجع الميزات المتوفرة بواسطة تطبيقات Office و نوع المشروع. نوع المشروع مشروعات على مستوى المستند مشروعات على مستوى التطبيق إصدار Microsoft Office نظام 2007 Microsoft Office Microsoft Office 2010

يقوم كل قالب مشروع Office تلقائيًا بإنشاء عدة معالجات أحداث. معالجات الأحداث لتخصيصات على مستوى المستند تختلف بشكل طفيف عن معالجات الأحداث لوظائف إضافية على مستوى التطبيق.

للمزيد من المعلومات حول التخصيصات والوظائف إضافية، راجع نظرة عامة حول تطوير حلول Office.

المشروعات على مستوى المستند

يوفر Visual Studio تعليمات برمجية منشأة خلف مستندات أو أوراق العمل الموجودة أو الجديدة في تخصيصات على مستوى المستند. ترففع هذه التعليمات البرمجية حدثين مختلفين: Startup وShutdown

حدث بدء التشغيل

يُرفع الحدث Startup لكل من عناصر المضيف (مستند أو مصنف أو ورقة عمل) بعد تشغيل المستند وتشغيل كافة تعليمات التهيئة البرمجية في التجميع. ومع ذلك، لا يمكن تشغيل حلول المكتب التي تم إنشاؤها بواسطة استخدام قوالب مشروع 2003 Microsoft المكتب 2010 Suite في 2008 Studio Visual Basic أو حلول المكتب التي تم إنشاؤها بواسطة استخدام ‏‫‏‫Visual Studio 2005. لمزيد من المعلومات حول عناصر المضيف, انظرنظرة عامة حول العناصر المضيفة و عناصر تحكم المضيف.

عندما تقوم بإنشاء مشروع على مستوى المستند، يقوم Visual Studio بإنشاء معالجات أحداث للحدث Startup في ملفات التعليمات البرمجية المنشأة:

• بالنسبة لمشاريع Microsoft Office Word، يسمى معالج الأحداث ThisDocument_Startup.

• بالنسبة لمشاريع Microsoft Office Excel، معالجات الأحداث لها الأسماء التالية:

  • Sheet1_Startup

  • Sheet2_Startup

  • Sheet3_Startup

  • ThisWorkbook_Startup

حدث إيقاف تشغيل

يُرفع الحدث Shutdown لكل من عناصر المضيف (مستند أو ورقة العمل) عندما يكون مجال التطبيق الذي تم تحميل تعليماتك البرمجية عليه على وشك إلغاء التحميل. هذا هو آخر شيء يتم استدعاؤه في الفئة بينما يتم إلغاء التحميل.

عندما تقوم بإنشاء مشروع على مستوى المستند، يقوم Visual Studio بإنشاء معالجات أحداث للحدث Shutdown في ملفات التعليمات البرمجية المنشأة:

• بالنسبة لمشاريع Microsoft Office Word، يسمى معالج الأحداث ThisDocument_Shutdown.

• بالنسبة لمشاريع Microsoft Office Excel، معالجات الأحداث لها الأسماء التالية:

  • Sheet1_Shutdown

  • Sheet2_Shutdown

  • Sheet3_Shutdown

  • ThisWorkbook_Shutdown

ملاحظة

لا تقم بإزالة عناصر التحكم برمجيًا أثناء عمل معالج الحدث Shutdown للمستند. عناصر واجهة المستخدم للمستند لن تعود متوفرة عندما يحدث الحدث Shutdown. إذا كنت ترغب في إزالة عناصر التحكم قبل إغلاق التطبيق، قم بإضافة التعليمات البرمجية الخاصة بك إلى معالج أحداث آخر مثل BeforeClose أو BeforeSave.

التصريح بأساليب معالج الحدث

يحتوي كل تصريح بأسلوب لمعالج الحدث على نفس الوسائط التي تم تمريرها إليه: sender وe في Excel، الوسيطة sender تشير إلى الورقة، مثل Sheet1 أو Sheet2; في Word، الوسيطة sender تشير إلى المستند. الوسيطة e تشير إلى الوسيطات القياسية لحدث ما، التي لا يتم استخدامها في هذه الحالة.

يوضح مثال التعليمات البرمجية التالية معالجات الحدث الافتراضية في مشاريع على مستوى المستند لـ Word.

Private Sub ThisDocument_Startup(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Startup

End Sub

Private Sub ThisDocument_Shutdown(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Shutdown

End Sub

private void ThisDocument_Startup(object sender, System.EventArgs e)
{
}

private void ThisDocument_Shutdown(object sender, System.EventArgs e)
{
}

يوضح مثال التعليمات البرمجية التالية معالجات الحدث الافتراضية في مشاريع على مستوى المستند لـ Excel.

ملاحظة

يوضح مثال التعليمات البرمجية التالي معالجات الحدث في الفئة Sheet1. تتوافق أسماء معالجات الأحداث في فئات العنصر المضيف الأخرى مع اسم الفئة. على سبيل المثال، في الفئة Sheet2، معالج الحدث Startup يسمى Sheet2_Startup. في الفئة ThisWorkbook، معالج الحدث Startup يسمى ThisWorkbook_Startup.

Private Sub Sheet1_Startup(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Startup

End Sub

Private Sub Sheet1_Shutdown(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Shutdown

End Sub

private void Sheet1_Startup(object sender, System.EventArgs e)
{
}

private void Sheet1_Shutdown(object sender, System.EventArgs e)
{
}

ترتيب الأحداث في مشاريع Excel على مستوى المستند

يتم استدعاء معالجات الأحداث Startup في المشاريع Excel بهذا الترتيب:

1. ThisWorkbook_Startup.

2. Sheet1_Startup.

3. Sheet2_Startup.

4. Sheet3_Startup.

5. أوراق أخرى بالترتيب.

يتم استدعاء معالجات الأحداث Shutdown في حل مصنف ما بهذا الترتيب:

1. ThisWorkbook_Shutdown.

2. Sheet1_Shutdown.

3. Sheet2_Shutdown.

4. Sheet3_Shutdown.

5. أوراق أخرى بالترتيب.

يتم تحديد الترتيب عند التحويل البرمجي للمشروع. إذا كان المستخدم يقوم بإعادة ترتيب الأوراق في وقت التشغيل، فإن ذلك لا يؤدي إلى تغيير ترتيب رفع الأحداث في المرة التالية التي يتم فيها فتح المصنف أو إغلاقه.

المشروعات على مستوى التطبيق

يوفر Visual Studio التعليمات البرمجية المنشأة في وظائف إضافية على مستوى التطبيق. ترففع هذه التعليمات البرمجية حدثين مختلفين: Startup وShutdown

حدث بدء التشغيل

يُرفع الحدث Startup بعد تحميل الوظيفة الإضافية وتشغيل كافة تعليمات التهيئة البرمجية في التجميع. هذا الحدث تتم معالجته من قبل الأسلوب ThisAddIn_Startup في ملف التعليمات البرمجية المنشأ.

التعليمات البرمجية في معالج الحدث ThisAddIn_Startup هي أول تعليمات برمجية للمستخدم ينبغى تشغيلها، ما لم تتجاوز الوظيفة الإضافية الأسلوب RequestComAddInAutomationService. في هذه الحالة، يتم استدعاء معالج الحدث ThisAddIn_Startup بعد RequestComAddInAutomationService. في الوظائف الإضافية الخاصة بنظام 2007 Microsoft Office، يمكن أيضًا استدعاء التعليمة البرمجية في معالج الحدث ThisAddIn_Startup بعد الأسلوب RequestService، إذا كانت الوظيفة الإضافية الخاصة بك تتجاوز هذا الأسلوب.

للمزيد من المعلومات حول تسلسل بدء تشغيل الوظائف الإضافية، راجع بنية الوظائف الإضافية على مستوى التطبيق.

حدث إيقاف تشغيل

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

راجع أيضًا:

المهام

كيفية القيام بما يلي: إنشاء مشاريع Office في Visual Studio

موارد أخرى

تطوير حلول Office

برمجة تخصيصات علي مستوي مستند

برمجة وظائف إضافية على مستوى التطبيق

نظرة عامة حول قوالب مشاريع Office