برمجة وظائف إضافية على مستوى التطبيق
ينطبق على |
|---|
|
تنطبق المعلومات الموجودة في هذا الموضوع فقط على أنواع المشاريع وإصدارات Microsoft Office التالية: لمزيد من المعلومات، راجع الميزات المتوفرة بواسطة تطبيقات Office و نوع المشروع. نوع المشروع
إصدار Microsoft Office
|
عند توسيع أحد تطبيقات Microsoft Office عن طريق إنشاء وظيفة إضافية علي مستوى التطبيق ، تقوم بكتابة التعليمات البرمجية مباشرة مقابل الفئة ThisAddIn في المشروع الخاص بك. يمكنك استخدام هذه الفئة لتنفيذ مهام مثل الوصول إلى نموذج كائن تطبيق Microsoft Office المضيف، و تخصيص واجهة مستخدم (UI) للتطبيق و من عرض كائنات في الوظيفة الإضافية الخاصة بك إلى حلول Office أخرى.
توجد بعض الأوجه لكتابة التعليمات البرمجية في مشاريع الوظيفة الإضافية مختلفة عن الأنواع الأخرى من مشاريع Visual Studio. العديد من هذه الاختلافات بسبب الطريقة التي يتم بها عرض نماذج كائن Office للتعليمات البرمجية المدارة . لمزيد من المعلومات، راجع كتابة التعليمات البرمجية في حلول Office.
للحصول على معلومات عامة حول الوظائف الإضافية علي مستوي التطبيق و أنواع الحلول الأخرى التي يمكنك إنشاؤها باستخدام أدوات تطوير Office في Visual Studio ، راجع نظرة عامة حول تطوير حلول Office.
استخدام الفئة ThisAddIn
يمكنك بدء كتابة التعليمات البرمجية للوظيفة الإضافية الخاصة بك في الفئة ThisAddIn . يقوم Visual Studio تلقائياً بإنشاء هذه الفئة في ملف التعليمات البرمجية ThisAddIn.vb (في Visual Basic) أو ThisAddIn.cs (في C#) في مشروع الوظيفة الإضافية الخاص بك. يقوم Visual Studio Tools لوقت تشغيل Office تلقائياً بإنشاء مثيل لهذه الفئة لك عند تحميل تطبيق Microsoft Office للوظيفة الإضافية
هناك معالجان للأحداث بشكل الافتراضي في الفئة ThisAddIn . لتشغيل التعليمات البرمجية عند تحميل التطبيق ، قم بإضافة تعليمات برمجية لمعالج الحدث ThisAddIn_Startup . لتشغيل التعليمات البرمجية قبل إغلاق التطبيق قم بإضافة التعليمات البرمجية لمعالج الحدث ThisAddIn_Shutdown . للحصول على مزيد من المعلومات حول إنشاء معالجات الأحداث تلك ، راجع الأحداث في مشاريع Office.
الوصول إلى نموذج الكائن للتطبيق المضيف
للوصول لنموذج الكائن للتطبيق المضيف ، استخدم الحقل Application من الفئة ThisAddIn . هذا الحقل يقوم بإرجاع كائن يمثل المثيل الحالي للتطبيق المضيف. يسرد الجدول التالي نوع قيمة الإرجاع للحقل Application في كل مشروع وظيفة إضافية.
التطبيق المضيف |
نوع قيمة الإرجاع |
|---|---|
Microsoft Office Excel |
|
Microsoft Office InfoPath |
Microsoft.Office.Interop.InfoPath.Application |
Microsoft Office Outlook |
Microsoft.Office.Interop.Outlook.Application |
Microsoft Office PowerPoint |
Microsoft.Office.Interop.PowerPoint.Application |
Microsoft Office Project |
Microsoft.Office.Interop.MSProject.Application |
Microsoft Office Visio |
Microsoft.Office.Interop.Visio.Application |
Microsoft Office Word |
يظهر مثال التعليمات البرمجية التالي كيفية استخدام الحقل Application لإنشاء مصنف جديد في وظيفة إضافية لـ Microsoft Office Excel. يفترض أن يتم تشغيل هذا المثال من الفئة ThisAddIn .
Dim newWorkbook As Excel.Workbook = Me.Application.Workbooks.Add()
Excel.Workbook newWorkbook = this.Application.Workbooks.Add(System.Type.Missing);
للقيام بنفس الشيء من خارج الفئة ThisAddIn ، استخدم الكائن Globals للوصول للفئة ThisAddIn . لمزيد من المعلومات حول كائنات Globals، راجع الوصول العمومي إلى الكائنات في مشاريع Office.
Dim newWorkbook As Excel.Workbook = Globals.ThisAddIn.Application.Workbooks.Add()
Excel.Workbook newWorkbook = Globals.ThisAddIn.Application.Workbooks.Add(System.Type.Missing);
للحصول على معلومات إضافية حول نماذج كائن معين من تطبيقات Microsoft Office، راجع المواضيع التالية:
أعضاء ThisAddIn المراد استخدامهم للمهام الأخرى
الجدول التالي يصف المهام الشائعة الأخرى ويظهر أي أعضاء من الفئة ThisAddIn يمكنك استخدامهم لتنفيذ المهام.
المهمة |
عضو للاستخدام |
|---|---|
تشغيل التعليمات البرمجية لتهيئة الوظيفة الإضافية عند تحميلها. |
إضافة تعليمات برمجية إلى الأسلوب ThisAddIn_Startup هذا هو معالج الحدث الافتراضي للحدث Startup . لمزيد من المعلومات، راجع الأحداث في مشاريع Office. |
قم بتشغيل التعليمات البرمجية لتنظيف الموارد المستخدمة من قبل الوظيفة الإضافية قبل إلغاء تحميلها. |
إضافة تعليمات برمجية إلى الأسلوب ThisAddIn_Shutdown هذا هو معالج الحدث الافتراضي للحدث Shutdown . لمزيد من المعلومات، راجع الأحداث في مشاريع Office. |
تتوفر حزم اللغات من مركز ينزّل Microsoft Office 2010 Suite. |
على سبيل المثال، عندما CustomTaskPanesسمة لعنصر المخطط تساوي 1. لمزيد من المعلومات، راجع نظرة عامة على أجزاء الإجراءات المخصصة. |
إنشاء علامة ذكية يمكن التعرف عليها في أي مستند Word أو مصنف Excel مفتوح. |
بعد إنشاء برنامج Visual Studio نطاق XML معين، يمكنك برمجة عليها مباشرة دون الحاجة إلى اجتياز طراز كائن Excel.VstoSmartTags لمزيد من المعلومات، راجع نظرة عامة على العلامات الذكية. |
عرض الكائنات في الوظيفة الإضافية الخاصة بك إلى حلول Microsoft Office الأخرى. |
تجاوز الأسلوب RequestComAddInAutomationService. لمزيد من المعلومات، راجع استدعاء تعليمات برمجية في وظائف إضافية على مستوى التطبيق من حلول Office الأخرى. |
تخصيص ميزة في نظام Microsoft Office عن طريق تطبيق واجهة القابلية للتوسعة . |
تجاوز الأسلوب RequestService لإرجاع مثيل من الفئة التي تنفذ الواجهة . لمزيد من المعلومات، راجع تخصيص ميزات UI باستخدام الواجهات القابلة للتوسعة. .gif "ملاحظة") ملاحظة
لتخصيص واجهة المستخدم الشريطية، يمكنك أيضاً تجاوز الأسلوب CreateRibbonExtensibilityObject .
|
فهم تصميم فئة ThisAddIn
في المشاريع التي تستهدف .Net Framework 3.5 ، تشتق الفئة ThisAddIn من الفئة Microsoft.Office.Tools.AddIn فى Visual Studio Tools لوقت تشغيل Office. في المشاريع التى تستهدف .NET Framework 4 ، Microsoft.Office.Tools.AddIn هي واجهة ، لذلك الفئة ThisAddIn التي تم إنشاؤها لا يمكنها اشتقاق أي تنفيذ منها. بدلاً من ذلك ، تشتق الفئة ThisAddIn من الفئة Microsoft.Office.Tools.AddInBase. هذه الفئة الأساسية تعيد توجيه كافة الاستدعاءات إلى أعضائها إلى التنفيذ الداخلي للواجهة Microsoft.Office.Tools.AddIn في Visual Studio Tools لوقت تشغيل Office. للحصول على مزيد من المعلومات حول الاختلافات في Visual Studio Tools لوقت تشغيل Office للمشاريع التي تستهدف .NET Framework 3.5 و .NET Framework 4 راجع نظرة عامة حول أدوات Visual Studio لوقت تشغيل Office.
في مشاريع الوظائف الإضافية لـ Outlook ، الفئة ThisAddIn تشتق من الفئة Microsoft.Office.Tools.Outlook.OutlookAddIn في المشاريع التي تستهدف .NET Framework 3.5 و من Microsoft.Office.Tools.Outlook.OutlookAddInBase في المشاريع التي تستهدف .NET Framework 4. توفر هذه الفئات الأساسية بعض وظائف إضافية لدعم مناطق النموذج. لمزيد من المعلومات حول مناطق النموذج , راجع إنشاء مناطق نموذج Outlook.
تخصيص واجهة المستخدم لتطبيقات Microsoft Office
منح الثقة عند استخدام Windows مثبت يمكنك استخدام Windows مثبت في إنشاء ملف MSI في يثّبت حلول المكتب في في direcفيry برنامج ملفات، والتي تتطلب يمنى administraفيr. لمزيد من المعلومات، راجع تخصيص واجهة Office.
يوفر Visual Studio مصممين وفئات يمكنك استخدامهم لإنشاء أجزاء مهام مخصصة و تخصيصات الشريط ومناطق نموذج Outlook. تساعد هذه المصممات والفئات في تبسيط عملية تخصيص هذه الميزات. لمزيد من المعلومات، راجع نظرة عامة على أجزاء الإجراءات المخصصة ، مصمم الشريط ، و إنشاء مناطق نموذج Outlook.
عن حلول المكتب في direcإلىry برنامج ملفات، يعتبر هذه الحلول المكتب إلى تكون موثوقة وعدم ظهور تعجيل ClickOnce الثقة. لمزيد من المعلومات، راجع تخصيص ميزات UI باستخدام الواجهات القابلة للتوسعة.
يمكنك أيضاً تعديل UI لمستندات Word ومصنفات Excel بواسطة إنشاء عناصر مضيفة تقوم بتوسيع سلوك المستندات والمصنفات. يمكّنك هذا من إضافة عناصر تحكم مدارة و علامات ذكية إلى المستندات وأوراق العمل. لمزيد من المعلومات، راجع توسيع مستندات Word ومصنفات Excel في وظائف إضافية على مستوى التطبيق في وقت التشغيل.
استدعاء تعليمات برمجية في وظائف إضافية على مستوى التطبيق من حلول Office الأخرى
يمكن عرض الكائنات في الوظيفة الإضافية الخاصة بك لحلول أخرى بما في ذلك حلول Office الأخرى. وهذا مفيد إذا كانت الوظيفة الإضافية الخاصة بك توفر خدمة تريد تمكين حلول أخرى من استخدامها. على سبيل المثال، إذا كان لديك وظيفة إضافية لـ Microsoft Office Excel تقوم بعملية حسابية على البيانات المالية من خدمة ويب ، يمكن لحلول أخرى تنفيذ هذه الحسابات بواسطة استدعاء الوظيفة الإضافية في Excel في وقت التشغيل.
لمزيد من المعلومات، راجع استدعاء تعليمات برمجية في وظائف إضافية على مستوى التطبيق من حلول Office الأخرى.
راجع أيضًا:
المهام
الإرشادات التفصيلية: استدعاء تعليمات برمجية في وظيفة إضافية على مستوى التطبيق من VBA
كيفية القيام بما يلي: إنشاء مشاريع Office في Visual Studio
المبادئ
توسيع مستندات Word ومصنفات Excel في وظائف إضافية على مستوى التطبيق في وقت التشغيل
استدعاء تعليمات برمجية في وظائف إضافية على مستوى التطبيق من حلول Office الأخرى
تخصيص ميزات UI باستخدام الواجهات القابلة للتوسعة
بنية الوظائف الإضافية على مستوى التطبيق
كتابة التعليمات البرمجية في حلول Office