العنصر المضيف الخاص بالمستند
ينطبق على |
|---|
|
تنطبق المعلومات الموجودة في هذا الموضوع فقط على أنواع المشاريع وإصدارات Microsoft Office التالية: لمزيد من المعلومات، راجع الميزات المتوفرة بواسطة تطبيقات Office و نوع المشروع. نوع المشروع
إصدار Microsoft Office
|
العنصر المضيف Document هو نوع يوسع النوع Microsoft.Office.Interop.Word.Document من تجميع التوافق الأساسي لـ Word. يوفر العنصر المضيف Document كافة الخصائص و الأساليب و الأحداث كـكائن Microsoft.Office.Interop.Word.Document ولكنه أيضًا يقوم بالكشف عن أحداث إضافية ويعمل كحاوية لعناصر تحكم المضيف وعناصر تحكم Windows Forms.
في المشاريع على مستوى المستند ، يوجد عنصر مضيف Document افتراضي يمثل المستند في المشروع الخاص بك. في المشاريع على مستوى التطبيق ، يمكنك إنشاء عناصر مضيف Document في وقت التشغيل.
فهم العنصر المضيف الخاص بالمستند في المشاريع على مستوى المستند
للوصول إلى المستند في المشروع الخاص بك , استخدم الفئة ThisDocument . عند إنشائك مشروع على مستوى المستند ، يقوم Visual Studio بإنشاء الفئة ThisDocument لتقوم بدور ارتباط الاتصال بين Word و التعليمات البرمجية الخاصة بالتخصيص الخاص بك . تمنحك فئة ThisDocument حق الوصول إلى أعضاء العنصر المضيف Document لتنفيذ مهام أساسية في التخصيص الخاص بك مثل تشغيل التعليمات البرمجية عند فتح المستند أو إغلاقه. يمكنك أيضاً استخدام الفئة لإضافة عناصر تحكم و علامات ذكية إلى المستند. بواسطة ضم مجموعات مختلفة من عناصر التحكم وكتابة تعليمات برمجية ، يمكنك ربط عناصر التحكم إلى البيانات ، جمع معلومات من المستخدم و الاستجابة إلى إجراءات المستخدم. لمزيد من المعلومات، راجع برمجة تخصيصات علي مستوي مستند.
توفر الفئة ThisDocument موقعا حيث يمكنك بدء كتابة التعليمات البرمجية في المشروع الخاص بك. لأن الفئة توفر نفس الخصائص والأساليب والأحداث كلها كـكائن Microsoft.Office.Interop.Word.Document في تجميع التوافق الأساسي لـ Word، يمكنك أيضاً استخدام ThisDocument للوصول إلى نموذج كائن Word. لمزيد من المعلومات، راجع نظرة عامة على نموذج كائن Word.
قيود العنصر المضيف الخاص بالمستند في المشاريع من مستوى المستند
يمكن أن يحتوي المشروع على مستوى المستند على عنصر مضيف Document واحد فقط (أي، الفئة ThisDocument ). لا يمكنك إضافة عناصر مضيفة Document جديدة إلى المشروع الخاص بك و لا يمكنك إنشاء عناصر مضيفة Document جديدة في وقت التشغيل للتخصيص على مستوى المستند.
إذا قمت بإنشاء مستند Word جديد في وقت التشغيل ، سيكون نوعه Microsoft.Office.Interop.Word.Document. لأنه ليس عنصرا مضيفا، لا يمكن أن يحتوي على أية عناصر تحكم مضيفة أو عناصر تحكم Windows Forms. للحصول على مزيد من المعلومات حول إنشاء مستندات في وقت التشغيل ، راجع كيفية القيام بما يلي: إنشاء مستند جديد.
فهم العناصر المضيفة الخاصة بالمستند في المشاريع على مستوى التطبيق
في المشاريع على مستوى التطبيق ، يمكنك إنشاء العنصر المضيف Document في وقت التشغيل لأي مستند مفتوح في Word. يمكنك استخدام العنصر المضيف Document لإضافة عناصر التحكم و العلامات الذكية إلى المستند المقترن أو لمعالجة الأحداث التي تكون غير متوفرة على كائنات Microsoft.Office.Interop.Word.Document .
لإنشاء عنصر مضيف Document ،استخدم الأسلوب GetVstoObject . لمزيد من المعلومات، راجع توسيع مستندات Word ومصنفات Excel في وظائف إضافية على مستوى التطبيق في وقت التشغيل.
راجع أيضًا:
المبادئ
نظرة عامة حول العناصر المضيفة و عناصر تحكم المضيف
أتمتة Word عن طريق استخدام الكائنات الموسعة
القيود البرمجية للعناصر مضيفة وعناصر التحكم
توسيع مستندات Word ومصنفات Excel في وظائف إضافية على مستوى التطبيق في وقت التشغيل