كتابة التعليمات البرمجية في حلول Office
ينطبق على |
|---|
|
تنطبق المعلومات الموجودة في هذا الموضوع فقط على أنواع المشاريع وإصدارات Microsoft Office التالية: لمزيد من المعلومات، راجع الميزات المتوفرة بواسطة تطبيقات Office و نوع المشروع. نوع المشروع
إصدار Microsoft Office
|
توجد بعض الأوجه لكتابة التعليمات البرمجية في مشاريع Office المختلفة عن الأنواع الأخرى من المشاريع في Visual Studio. العديد من هذه الاختلافات مرتبطة بالطريقة التي يتم بها عرض نماذج كائن Office للتعليمات البرمجية المدارة . تتعلق الاختلافات الأخرى بتصميم مشاريع Office .
التعليمات البرمجية المدارة و برمجة Office
تقنية المفاتيح التي تجعل من الممكن إنشاء حل Microsoft Office متكامل هى التنفيذ التلقائى (أو الأتمتة) و التي هى جزء من تقنية نموذج كائن المكون (COM). التنفيذ التلقائي يمكنك استخدام التعليمات البرمجية لإنشاء كائنات برنامج معروضة بواسطة أي تطبيق أو DLL أو عنصر تحكم ActiveX الذي يدعم واجهات البرمجي المناسبة والتحكم فيها.
فهم تجميعات التوافق الأساسية
تقوم تطبيقات Microsoft Office بالكشف عن الكثير من الوظائف الخاصة بهم للتنفيذ التلقائي . ومع ذلك، لا يمكنك استخدام التعليمات البرمجية المدارة (مثل Visual Basic أو C#) مباشرة لأتمتة تطبيقات Office. يجب عليك استخدام تجميعات التوافق الأساسية (PIAs) الخاصة بـ Office لأتمتة تطبيقات Office باستخدام التعليمات البرمجية المدارة. تجميعات التوافق الأساسية تقوم بتمكين التعليمات البرمجية المدارة بحيث تتفاعل مع نموذج كائن يستند إلى COM من تطبيقات Office.
كل تطبيق Microsoft Office يحتوي على PIA. عند إنشائك لمشروع Office في Visual Studio ، يتم إضافة مرجع PIA تلقائياً إلى المشروع . لأتمتة الميزات الموجودة في تطبيقات Office الأخرى من المشروع يجب إضافة مرجع PIA المناسب يدوياً. لمزيد من المعلومات، راجع كيفية القيام بما يلي: استهداف تطبيقات Office عبر تجميعات توافق أساسي.
استخدام تجميعات التوافق الأساسية في وقت التصميم ووقت التشغيل
يجب أن يكون لديك Office PIAs مثبتة و مسجلة في ذاكرة التخزين المؤقتة للتجميع العمومي على كمبيوتر التطوير الخاص بك لتنفيذ معظم مهام التطوير. لمزيد من المعلومات، راجع تكوين كمبيوتر لتطوير حلول Office.
يجب أيضاً تثبيت PIAs على أجهزة كمبيوتر المستخدم لتشغيل حلول Office التي تستهدف 3.5 .NET Framework. ومع ذلك، فإن Office PIAs غير مطلوبة على أجهزة كمبيوتر المستخدم لتشغيل حلول Office التي تستهدف .NET Framework 4. لمزيد من المعلومات، راجع تصميم و إنشاء حلول Office.
استخدام أنواع في تجميعات التوافق الأساسية
لأن الأنواع في Office PIAs تناظر أنواعا في نماذج الكائنات التى تستند إلى COM، فإن طريقة استخدام هذه الأنواع غالباً تختلف عن الأنواع الأخرى المدارة. على سبيل المثال، تعتمد الطريقة التي يتم بها استدعاء الأساليب التي تحتوي على المعلمات الاختيارية في تجميع التوافق الأساسي لـ Office على لغة البرمجة التي تستخدمها في المشروع. لمزيد من المعلومات، راجع المواضيع التالية:
نموذج البرمجة لمشاريع Office
كافة مشاريع Office تتضمن واحد أو أكثر من الفئات التي تم إنشاؤها التي توفر نقطة الإدخال للحصول على التعليمات البرمجية الخاصة بك. توفر هذه الفئات أيضاً الوصول إلى نموذج كائن من تطبيق العنصر المضيف والوصول إلى ميزات مثل أجزاء الإجراءات و أجزاء المهام المخصصة.
فهم الفئات المنشأة
في المشاريع على مستوى المستند في Excel و Word، الفئة التي تم إنشاؤها تشبه الكائن على المستوى الأعلى في نموذج الكائن الخاص بالتطبيق. على سبيل المثال، توفر الفئة ThisDocument المنشأة في مشروع مستند Word الأعضاء نفسها كما في الفئة Microsoft.Office.Interop.Word.Document في نموذج كائن Word . للحصول على مزيد من المعلومات حول الفئات التي تم إنشاؤها في مشاريع على مستوى المستند، راجع برمجة تخصيصات علي مستوي مستند.
توفر المشاريع على مستوى التطبيق فئة منشأة تسمى ThisAddIn. لا تتشابه هذه الفئة مع الفئة في نموذج الكائن المضيف الخاص بالتطبيق. بدلاً من ذلك، تمثل هذه الفئة الوظيفة الإضافية نفسها كما توفر أعضاء تستطيع استخدامهم للوصول إلى نموذج الكائن المضيف الخاص بالتطبيق والوصول إلى ميزات أخرى متوفرة للوظائف الإضافية. لمزيد من المعلومات، راجع برمجة وظائف إضافية على مستوى التطبيق.
تتضمن كافة الفئات المنشأة في مشاريع Office معالجات الأحداث Startup و Shutdown . لبدء كتابة التعليمات البرمجية ، تقوم عادةً بإضافة تعليمة برمجية لمعالجات الحدث هذه. لتهيئة الوظيفة الإضافية الخاصة بك ، يمكنك إضافة تعليمة برمجية لمعالج الحدث Startup . لتنظيف الموارد المستخدمة من قبل الوظيفة الإضافية الخاصة بك ، يمكنك إضافة التعليمات البرمجية لمعالج الحدث Shutdown . لمزيد من المعلومات، راجع الأحداث في مشاريع Office.
الوصول إلى فئات منشأة في وقت التشغيل
عند تحميل حل Office ، Visual Studio Tools لوقت تشغيل Office تقوم بإنشاء مثيل لكل من الفئات التي تم إنشاؤها في المشروع الخاص بك. يمكنك الوصول إلى هذه الكائنات من أية تعليمات برمجية في المشروع الخاص بك باستخدام الفئة Globals . على سبيل المثال، يمكنك استخدام الفئة Globals لاستدعاء التعليمات البرمجية في الفئة ThisAddIn من معالج الأحداث الخاص بزر الشريط في الوظيفة الإضافية على مستوى التطبيق
لمزيد من المعلومات، راجع الوصول العمومي إلى الكائنات في مشاريع Office.
راجع أيضًا:
المهام
كيفية القيام بما يلي: استهداف تطبيقات Office عبر تجميعات توافق أساسي
كيفية القيام بما يلي: إنشاء معالجات أحداث في مشاريع Office
الربط فى وقت التشغيل في حلول Office
المبادئ
لغات البرمجة المدعومة في مشاريع Office
البرمجة باستخدام Visual Basic مقابل استخدام Visual C# في حلول Office
المعلمات الاختيارية في حلول Office
الوصول العمومي إلى الكائنات في مشاريع Office
اعتبارات مساحة الاسم في حلول Office