مشاركة عبر

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

  • مقالة

ينطبق على

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

نوع المشروع

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

إصدار Microsoft Office

  • Excel 2007 و Excel 2010

  • Word 2007 و Word 2010

عند توسيع Microsoft Office Word أو Microsoft Office Excel باستخدام تخصيص علي مستوي المستند ، يمكنك تنفيذ المهام التالية:

  • أتمتة التطبيق باستخدام نموذج الكائن الخاص به.

  • إضافة عناصر التحكم إلى واجهة المستند.

  • استدعاء التعليمات البرمجية لـتطبيقات Visual Basicـ (VBA) في المستند من تجميع التخصيص.

  • استدعاء التعليمات البرمجية في تجميع التخصيص من VBA

  • إدارة أوجه معينة من المستند أثناء وجوده على خادم ليس فيه Microsoft Office مثبتاً.

  • قم بتخصيص واجهة المستخدم (UI) للتطبيق.

توجد بعض الأوجه لكتابة التعليمات البرمجية في مشاريع علي مستوي المستند مختلفة عن الأنواع الأخرى من المشاريع في Visual Studio. العديد من هذه الاختلافات بسبب الطريقة التي يتم بها عرض نماذج كائن Office للتعليمات البرمجية المدارة . لمزيد من المعلومات، راجع كتابة التعليمات البرمجية في حلول Office.

للحصول على معلومات عامة حول التخصيصات علي مستوي المستند و أنواع الحلول الأخرى التي يمكنك إنشاؤها باستخدام أدوات تطوير Office في Visual Studio ، راجع نظرة عامة حول تطوير حلول Office.

استخدام الفئات المنشأة في المشاريع على مستوى المستند

عند إنشاء مشروع علي مستوي المستند ، يقوم Visual Studio تلقائياً بإنشاء فئة في المشروع يمكنك استخدامها لبدء كتابة التعليمات البرمجية الخاصة بك. يقوم Visual Studio بإنشاء فئات مختلفة لـ Word و Excel:

  • في مشاريع علي مستوي المستند لـ Word ، الفئة تسمى ThisDocument بشكل الافتراضي.

  • يكون للمشاريع علي مستوى المستند لـ Excel فئات منشأة متعددة : واحدة للمصنف نفسه ثم واحدة لكل ورقة عمل. افتراضياً، هذه الفئات لها الأسماء التالية:

    • ThisWorkbook

    • Sheet1

    • Sheet2

    • Sheet3

تتضمن الفئة التي تم إنشاؤها معالجات الأحداث التي تستدعي عند فتح المستند أو إغلاقه. لتشغيل التعليمات البرمجية عند فتح المستند ، قم بإضافة تعليمات برمجية لمعالج الحدث Startup . لتشغيل التعليمات البرمجية قبل إغلاق المستند قم بإضافة التعليمات البرمجية لمعالج الحدث Shutdown . لمزيد من المعلومات، راجع الأحداث في مشاريع Office.

فهم تصميم الفئات المنشأة

في مشاريع تستهدف 3.5 .NET Framework ، تشتق الفئات التي تم إنشاؤها معظم أعضائهم و سلوكهم من فئات العنصر المضيف التالية في Visual Studio Tools لوقت تشغيل Office:

  • ThisDocument: مشتقة من Microsoft.Office.Tools.Word.Document

  • ThisWorkbook: مشتقة من Microsoft.Office.Tools.Excel.Workbook

  • Sheetn: : مشتقة منMicrosoft.Office.Tools.Excel.Worksheet

عناصر المضيف هي أنواع موجودة في أعلى التسلسلات الهرمية لنموذج الكائن في مشاريع Office وتقوم بتوسيع سلوك الكائنات المقابلة في تجميعات التوافق الأساسية لـ Office ـ(PIAs). لمزيد من المعلومات حول عناصر المضيف, انظرنظرة عامة حول العناصر المضيفة و عناصر تحكم المضيف.

في مشاريع تستهدف .NET Framework 4 ، أنواع عناصر المضيف في Visual Studio Tools لوقت تشغيل Office هي واجهات, لذا لا يمكن اشتقاق تطبيق الفئات التي تم إنشاؤها منها. بدلاً من ذلك، تشتق الفئات المنشأة معظم الأعضاء الخاصين بهم من الفئات الأساسية التالية:

الفئات الأساسية هذه تقوم بإعادة توجيه كافة استدعاءاتهم لأعضاءهم إلى تطبيقات داخلية لواجهات العنصر المضيف المناظر في Visual Studio Tools لوقت تشغيل Office. على سبيل المثال، إذا قمت باستدعاء الأسلوب Protect للفئة ThisDocument، تقوم الفئة Microsoft.Office.Tools.Word.DocumentBase بإعادة توجيه هذا الاستدعاء إلي التطبيق الداخلي للواجهة Microsoft.Office.Tools.Word.Document في Visual Studio Tools لوقت تشغيل Office . للحصول على مزيد من المعلومات حول الاختلافات فى Visual Studio Tools لوقت تشغيل Office للمشاريع التى تستهدف 3.5 .NET Framework و .NET Framework 4 راجع نظرة عامة حول أدوات Visual Studio لوقت تشغيل Office.

الوصول إلى نموذج الكائن للتطبيق المضيف

للوصول إلى نموذج كائن التطبيق المضيف ، استخدم أعضاء الفئة التي تم إنشاؤها في المشروع. كل من هذه الفئات يناظر كائناً في نموذج كائن Excel أو Word، وهي تحتوي على نفس معظم الخصائص والأساليب والأحداث . على سبيل المثال ، الفئة ThisDocument في مشروع علي مستوى المستند لـ Word توفر نفس معظم الأعضاء ككائن Microsoft.Office.Interop.Word.Document في نموذج كائن Word .

يظهر مثال التعليمات البرمجية التالي كيفية استخدام نموذج الكائن Word لحفظ المستند الذي هو جزء من تخصيص علي مستوى المستند لـ Word. يفترض أن يتم تشغيل هذا المثال من الفئة ThisDocument .

Me.Save()

this.Save();

للقيام بنفس الشيء من خارج الفئة ThisDocument ، استخدم الكائن Globals للوصول للفئة ThisDocument . على سبيل المثال، يمكنك إضافة هذه التعليمة البرمجية إلى ملف التعليمات برمجية لجزء إجراءات إذا كنت تريد أن تقوم بتضمين الزر حفظ في جزء الإجراءات UI.

Globals.ThisDocument.Save()

Globals.ThisDocument.Save();

لأن الفئة ThisDocument تحصل على معظم أعضائها من العنصر المضيف Microsoft.Office.Tools.Word.Document ، الأسلوب Save الذي يتم استدعاؤه في هذه التعليمات البرمجية هو فعلاً الأسلوب Save للعنصر المضيف Microsoft.Office.Tools.Word.Document . يتوافق هذا الأسلوب مع الأسلوب Save للكائن Microsoft.Office.Interop.Word.Document في نموذج كائن Word .

للحصول على مزيد من المعلومات حول استخدام نماذج الكائنات من Word وExcel ، راجع نظرة عامة على نموذج كائن Word و ‏‫نظرة عامة لنموذج كائن Excel.

لمزيد من المعلومات حول كائنات Globals، راجع الوصول العمومي إلى الكائنات في مشاريع Office.

إضافة عناصر تحكم إلى المستندات

لتخصيص واجهة مستخدم المستند ، يمكن إضافة عناصر تحكم Windows Forms أو عناصر تحكم المضيف إلى سطح المستند. بواسطة ضم مجموعات مختلفة من عناصر التحكم وكتابة تعليمات برمجية ، يمكنك ربط عناصر التحكم إلى البيانات ، جمع معلومات من المستخدم و الاستجابة إلى إجراءات المستخدم.

عناصر تحكم المضيف هى فئات تقوم بتوسيع بعض الكائنات في نموذج كائن Word وExcel. على سبيل المثال، عنصر تحكم المضيف Microsoft.Office.Tools.Excel.ListObject يوفر كل وظائف Microsoft.Office.Interop.Excel.ListObject في Excel. ومع ذلك، يتضمن عنصر تحكم المضيف Microsoft.Office.Tools.Excel.ListObject أيضاً أحداثاً إضافية و قدرات ربط بيانات.

للمزيد من المعلومات، راجع نظرة عامة حول العناصر المضيفة و عناصر تحكم المضيف ونظرة عامة على عناصر تحكم Windows Forms فى مستندات Office.

ضم VBA و تخصيصات من مستوى المستند

يمكنك استخدام التعليمات البرمجية لـ VBA في مستند هو جزء من تخصيص علي مستوي المستند . يمكنك استدعاء تعليمات VBA البرمجية في المستند من تجميع التخصيص، و يمكنك أيضاً تكوين المشروع الخاص بك لتمكين تعليمات VBA البرمجية في المستند من استدعاء التعليمات البرمجية في تجميع التخصيص.

لمزيد من المعلومات، راجع ضم VBA و تخصيصات من مستوى المستند.

إدارة المستندات على خادم

يمكنك إدارة عدة أوجه مختلفة من التخصيصات علي مستوي المستند على خادم ليس عليه Microsoft Office Word أو Microsoft Office Excel مثبتين. على سبيل المثال، يمكن الوصول إلي وتعديل البيانات في ذاكرة تخزين البيانات المؤقت الخاصة بالمستند. يمكنك أيضاً إدارة تجميع التخصيص المرتبط بالمستند. على سبيل المثال، يمكنك برمجياً إزالة التجميع من المستند بحيث لا يقوم المستند بتشغيل التعليمات البرمجية الخاصة بك فيما بعد، أو يمكنك إرفاق تجميع برمجياً إلي مستند.

لمزيد من المعلومات، راجع إدارة المستندات على خادم باستخدام فئة ServerDocument.

تخصيص واجهة المستخدم لتطبيقات Microsoft Office

يمكنك تخصيص واجهة Word و Excel بالطرق التالية باستخدام التخصيص علي مستوي المستند:

لمزيد من المعلومات حول تخصيص تطبيقات واجهة المستخدم من Microsoft Office راجع تخصيص واجهة Office.

راجع أيضًا:

المبادئ

إدارة المستندات على خادم باستخدام فئة ServerDocument

الحصول على كائنات موسّعة من كائنات Office أصلية في تخصيصات على مستوى المستند

كتابة التعليمات البرمجية في حلول Office

موارد أخرى

عناصر التحكم في مستندات Office

ضم VBA و تخصيصات من مستوى المستند