نظرة عامة على نموذج كائن Word

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

عند تطويرك حلول Word في Visual Studio تقوم بالتفاعل مع نموذج كائن Word. يتكون نموذج الكائن هذا من الواجهات و الفئات التي تم توفيرها في تجميع التوافق الأساسي لـ WORD والتي تم تعريفها في مساحة الاسم Microsoft.Office.Interop.Word .

يصف هذا الموضوع الأوجه التالية لاستخدام كائن نموذج Word .

• فهم نموذج كائن Word

• استخدام وثائق نموذج الكائن الخاصة بـ Word

للحصول على معلومات حول استخدام كائن Word لتنفيذ مهام معينة, راجع المواضيع التالية:

• العمل مع المستندات

• العمل مع النص في المستندات

• استخدام الجداول

فهم نموذج كائن Word

يوفر Word مئات الكائنات التى يمكنك التفاعل معها. يتم تنظيم هذه الكائنات في التسلسل الهرمي الذي يتبع واجهة المستخدم . في أعلى التسلسل الهرمي، الكائن Application . هذا الكائن يمثل المثيل الحالي لـ WORD. الكائنApplication يحتوي على الكائنات Document ، Selection ، Bookmark ، و Range . لدى كل من هذه الكائنات و المجموعات العديد من الأساليب والخصائص التي يمكنك الوصول إليها للتعامل والتفاعل معها.

يبين الرسم التوضيحي التالي طريقة عرض واحدة من هذه الكائنات في التسلسل الهرمي لنموذج كائن Word.

تجريد نموذج كائن WORD

في أول نظرة يظهر انه هناك الكثير من التراكب. على سبيل المثال الكائنات، Document و Selection كليهما اعضاء في الكائن Application ، ولكن الكائن Document أيضاً عضو في الكائن Selection . كلا الكائنات Document و Selection تحتوي على الكائنات Bookmark و Range . يوجد التراكب لأن هناك طرق متعددة يمكنك الوصول من خلالها إلى نفس الكائن. على سبيل المثال، يمكنك تطبيق التنسيق إلى الكائن Range ; ولكن قد تحتاج إلى الوصول الي نطاق التحديد الحالي لفقرة معينة أو مقطع أو المستند بأكمله.

تصف المقاطع التالية باختصار المستوى الأعلى من الكائنات و كيف تتفاعل مع بعضها البعض. هذه الكائنات تتضمن الكائنات الخمسة التالية:

• كائن التطبيق

• كائن المستند

• كائن التحديد

• كائن النطاق

• كائن الإشارة المرجعية

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

كائن التطبيق

الكائن Application يمثل تطبيق Word وهو الأصل لكل الكائنات الأخرى . أعضاؤه عادةً يطبقون على Word ككل. يمكنك استخدام الخصائص والأساليب الخاصة به للتحكم في بيئة Word.

في مشاريع الوظيفة الإضافية على مستوى التطبيق، يمكنك الوصول إلى كائن Application باستخدام الحقل Applicationمن الفئة ThisAddIn. لمزيد من المعلومات، راجع برمجة وظائف إضافية على مستوى التطبيق.

في مشاريع الوظيفة الإضافية على مستوى التطبيق، يمكنك الوصول إلى كائن Application باستخدام الخاصية Applicationمن الفئة ThisDocument.

كائن المستند

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

أدوات تطوير Office في Visual Studio توسع الكائن Microsoft.Office.Interop.Word.Document بواسطة توفير النوعMicrosoft.Office.Tools.Word.Document. هذا النوع هو عنصر مضيف يعطيك الوصول إلى كافة ميزات الكائن Microsoft.Office.Interop.Word.Document ويقوم بإضافة أحداث إضافية والقدرة علي إضافة عناصر التحكم المدارة.

عند قيامك بإنشاء مشروع علي مستوى المستند يمكنك الوصول إلى اعضاء Microsoft.Office.Tools.Word.Document باستخدام الفئة ThisDocument التي تم إنشاؤها في المشروع الخاص بك. يمكنك الوصول إلى أعضاء العنصر المضيف Microsoft.Office.Tools.Word.Document عن طريق استخدام الكلمات الأساسية Me أو this من التعليمات البرمجية في الفئة ThisDocument ، أو باستخدام Globals.ThisDocument من التعليمات البرمجية خارج الفئة ThisDocument . لمزيد من المعلومات، راجع برمجة تخصيصات علي مستوي مستند. على سبيل المثال، لتحديد الفقرة الأولى في المستند, استخدم التعليمات البرمجية التالية.

Me.Paragraphs(1).Range.Select()

this.Paragraphs[1].Range.Select();

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

كائن التحديد

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

كائن النطاق

الكائن Range يمثل منطقة متجاورة في مستند و يتم تعريفه بموضع حرف البداية و موضع حرف النهاية . انت غير محدود بكائن Range واحد . يمكنك تعريف كائنات Range متعددة في نفس المستند . الكائن Range لديه الميزات التالية:

• يمكن أن يتألف من نقطة الإدراج وحدها, نطاق نص, أو المستند بأكمله.

• يتضمن الأحرف غير القابلة للطباعة مثل المسافات وأحرف التبويب و علامات الفقرات.

• يمكن أن يكون المساحة الممثلة بالتحديد الحالي أو يمكن أن يمثل منطقة مختلفة عن التحديد الحالي.

• هو غير مرئي في المستند ، بعكس التحديد, الذي يكون دوماً مرئياً .

• لم يتم حفظه مع مستند و يوجد فقط أثناء تشغيل التعليمات البرمجية.

عند إدراجك نص في نهاية نطاق, يقوم Word تلقائياً بتوسيع النطاق لتضمين النص المدرج.

كائنات تحكم المحتوى

يوفرMicrosoft.Office.Interop.Word.ContentControl طريقة لك للتحكم في إدخال وعرض النص وأنواع أخرى من المحتوى في مستندات Word. يمكن ل Microsoft.Office.Interop.Word.ContentControl عرض عدة أنواع من واجهة المستخدم التي تم تحسينها لاستخدامها في مستندات Word، مثل عنصر التحكم في النص , منتقي تاريخ أو مربع التحرير والسرد. يمكنك أيضاً استخدام Microsoft.Office.Interop.Word.ContentControl لمنع مستخدمين من تحرير مقاطع من المستند أو من قالب.

يقوم Visual Studio بتوسيع الكائنMicrosoft.Office.Interop.Word.ContentControl إلى عدة عناصر تحكم مضيفة آخري. بينما يمكن للكائنMicrosoft.Office.Interop.Word.ContentControl عرض أي من الأنواع المختلفة من واجهة المستخدم التي تتوفر لعناصر محتوى التحكم، يوفر Visual Studio نوعاً مختلفاً لكل عنصر من عناصر تحكم المحتوى. على سبيل المثال، يمكنك استخدام RichTextContentControl لإنشاء عنصر تحكم نص غنى أو يمكنك استخدام DatePickerContentControl لإنشاء منتقي التاريخ. عناصر تحكم المضيف هذه تتصرف مثل Microsoft.Office.Interop.Word.ContentControl الأصلي، لكن لديهم أحداث إضافية و قدرات ربط بيانات. لمزيد من المعلومات، راجع عناصر تحكم المحتوى.

كائن الإشارة المرجعية

الكائنMicrosoft.Office.Interop.Word.Bookmark يمثل منطقة متجاورة في مستند، لديه كل من موضع بداية و موضع نهاية . يمكنك استخدام الإشارات المرجعية لوضع علامة على موقع في المستند أو كحاوية النص في مستند. الكائنMicrosoft.Office.Interop.Word.Bookmark يمكن أن يتألف من نقطة الإدراج أو ان يكون كبيراً بقدر المستند بأكمله. Microsoft.Office.Interop.Word.Bookmark لديه الميزات التالية التي تميزه عن الكائن Range :

• يمكنك تسمية الإشارة المرجعية في وقت التصميم.

• كائناتMicrosoft.Office.Interop.Word.Bookmark يتم حفظها مع المستند، و وبالتالي لا يتم حذفها عند إيقاف تشغيل التعليمات البرمجية أو عند إغلاق المستند.

• يمكن إخفاء الإشارات المرجعية أو جعلها مرئية بواسطة تعيين خاصية ShowBookmarks للكائن View الي false أو true.

يقوم Visual Studio بتوسيع الكائن Microsoft.Office.Interop.Word.Bookmark بواسطة توفير التحكم المضيف Microsoft.Office.Tools.Word.Bookmark . يتصرف عنصر التحكم المضيف Microsoft.Office.Tools.Word.Bookmark مثل العنصر الأصلي Microsoft.Office.Interop.Word.Bookmark, ولكنه يحتوي علي أحداث إضافية و قدرات ربط بيانات . يمكنك ربط البيانات إلى عنصر تحكم الإشارة المرجعية في مستند بنفس طريقة ربط البيانات إلى مربع نص عنصر التحكم على Windows Form. لمزيد من المعلومات، راجع عنصر تحكم الإشارة المرجعية.

استخدام وثائق نموذج الكائن الخاصة بـ Word

للحصول على مزيد من المعلومات حول الانواع التي يمكنك استخدامها في نموذج كائن Word، راجع مجموعات الوثائق التالية :

• مرجع التوافق الأساسي لـ Microsoft Office Word

  هذه الوثائق توفر معلومات حول الفئات و الواجهات في تجميع التوافق الاساسي لل Word.

• مرحباً بك في مرجع مطور Microsoft Office Word 2007

  توفر هذه الوثائق معلومات حول نموذج كائن Word 2007 كما يتم عرضها لتعليمات Visual Basic البرمجية الخاصة بالتطبيق.

تحتوي كل مجموعة من الوثائق علي مزايا وعيوب للمطورين الذين يطورون حلول Office باستخدام Visual Studio.

مرجع تجميع التوافق الأساسي

توضح هذه الوثائق كل أنواع تجميع التوافق الأساسي في Word التي يمكنك استخدامها في مشاريع Office. ومع ذلك، تحتوي هذه الوثائق علي العيوب التالية:

• These حدث handlers are called when Excel loads و unloads your إضافة-في. يوضح هذا المثال كيفية إضافة أمر إلى قائمة مختصرة في Excel باستخدام وظيفة إضافية لالمستوى تطبيق.

• لا توفر أي أمثلة للتعليمات البرمجية حتى ذلك الوقت.

مرجع VBA:

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

مرجع VBA فيه المميزات التالية:

• يوفر أمثلة تعليمات برمجية لمعظم الأعضاء .

مرجع VBA فيه العيوب التالية:

• يوفر أمثلة بناء الجملة و التعليمة البرمجية لـ VBA فقط. لاستخدم أمثلة التعليمة البرمجية في مشروع Office، يجب أن تقوم بترجمة تعليمة VBA البرمجية إلى Visual Basic أو Visual C#‎.

أنواع إضافية في تجميع التوافق الأساسي

تجميع التوافق الأساسي يحتوي على العديد من الأنواع غير المتوفرة لـ VBA. هذه الأنواع الإضافية التى تساعد على ترجمة الكائنات في نموذج الكائن المستند إلى COM الخاص ب Word إلى تعليمة برمجية مدارة ، غير معدة للاستخدام بشكل مباشر في التعليمة البرمجية الخاصة بك.

لمزيد من المعلومات، راجع Overview of Classes and Interfaces in the Office Primary Interop Assemblies.

راجع أيضًا:

المرجع

مكتب التجميعات إمكانية التشغيل المتداخل الأساسية

المبادئ

أتمتة Word عن طريق استخدام الكائنات الموسعة

العمل مع المستندات

العمل مع النص في المستندات

استخدام الجداول

نظرة عامة حول العناصر المضيفة و عناصر تحكم المضيف

القيود البرمجية للعناصر مضيفة وعناصر التحكم

المعلمات الاختيارية في حلول Office