الإرشادات التفصيلية: إنشاء التخصيص الأول الخاص بك على مستوى المستند لـ Word

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

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

توضح هذه الإرشادات التفصيلية المهام التالية:

• إنشاء مشروع مستند Word.

• إضافة نص إلى مستند تتم استضافته في مصمم Visual Studio.

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

• بناء و تشغيل المشروع لاختباره.

• تنظيف المشروع لإزالة ملفات البناء غير الضرورية وإعدادات الأمان من كمبيوتر التطوير الخاص بك.

ملاحظة

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

المتطلبات الأساسية

تحتاج إلى المكونات التالية لاستكمال هذه الإرشادات التفصيلية:

-

إصدار لـ Visual Studio 2010 يشمل أدوات مطوري Microsoft Office. لمزيد من المعلومات، راجع [تكوين كمبيوتر لتطوير حلول Office](bb398242\(v=vs.100\).md).

• Word 2007 أو Word 2010.

إنشاء المشروع

لإنشاء مشروع مستند Word جديد في Visual Studio

1. ابدأ Visual Studio.

2. من القائمة File (ملف)، أشر إلى New (جديد)، ثم انقر فوق Project (مشروع).

3. في جزء القوالب، قم بتوسيع #Visual C أو Visual Basic ثم قم بتوسيع Office.

4. ضمن العقدة الموسعة Office، حدد 2007 إذا كان لديكWord 2007 مثبت، أو حدد العقدة 2010 إذا كان لديك Word 2010 مثبتا.

5. في قائمة قوالب المشروع، حدد مشروع مستند Word 2007 أو مستند Word 2010.

6. في مربع الاسم، اكتب FirstDocumentCustomization.

7. انقر فوق موافق.

   أدوات Visual Studio لمعالج مشروع Office تفتح.

8. حدد إنشاء مستند جديد، وانقر فوق موافق.

   يقوم Visual Studio بإنشاء مشروع FirstDocumentCustomization، و يقوم بإضافة المستند FirstDocumentCustomization و ملف التعليمات البرمجية ThisDocument للمشروع. يفتح مستند FirstDocumentCustomization تلقائياً في المصمم.

إغلاق و إعادة فتح المستند في المصمم

إذا قمت بإغلاق مستند ما بشكل متعمد أو عن طريق الخطأ في المصمم بينما تقوم بتطوير مشروعك، يمكنك إعادة فتحه.

لإغلاق ثم إعادة فتح مستند ما في المصمم

1. قم بإغلاق المستند عن طريق النقر فوق زر إغلاق ((X لنافذة المصمم.

2. في مستكشف الحلول، انقر برز الماوس الأيمن فوق ملف التعليمات البرمجية ThisDocument، ثم انقر فوق عرض المصمم.

   -أو-

   في مستكشف الحلول، ‏‫انقر نقرًا مزدوجًا علي ملف التعليمات البرمجية ThisDocument.

إضافة نص لمستند في المصمم

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

لإضافة نص إلى المستند الخاص بك باستخدام المصمم

• في المستند المفتوح في المصمم، اكتب النص التالي.

  هذا النص تمت إضافته باستخدام المصمم.

إضافة نص إلى المستند برمجياً

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

• تعريف جزئي للفئة ThisDocument، التي تمثل النموذج البرمجي لمستند وتوفر الاتصال بنموذج كائن Word. للمزيد من المعلومات، راجع العنصر المضيف الخاص بالمستند ونظرة عامة على نموذج كائن Word. باقي فئة ThisDocument تم تعريفها في ملف التعليمات البرمجية المخفي الذي يجب عليك ألا تقوم بتعديله.

• معالجا الأحداث ThisDocument_Startup وThisDocument_Shutdown. تُستدعى معالجات الأحداث هذه عند فتح المستند و غلقه. استخدم معالجات الحدث هذه لتهيئة التخصيص الخاص بك عند فتح المستند و لتنظيف الموارد المستخدمة من قبل التخصيص الخاص بك عند إغلاق المستند. لمزيد من المعلومات، راجع الأحداث في مشاريع Office.

لإضافة فقرة ثانية من النص إلى مستند باستخدام التعليمات البرمجية

1. في مستكشف الحلول، انقر بزر الماوس الأيمن فوق ThisDocument، ثم انقر فوق عرض التعليمات البرمجية.

   يتم فتح ملف التعليمات البرمجية في Visual Studio.

2. قم باستبدال معالج الأحداث ThisDocument_Startup بالتعليمات البرمجية التالية. عند فتح المستند، تقوم هذه التعليمات البرمجية بإضافة فقرة ثانية من النص إلى المستند.

   Private Sub ThisDocument_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
       Me.Paragraphs(1).Range.InsertParagraphAfter()
       Me.Paragraphs(2).Range.Text = "This text was added by using code."
   End Sub
   

   private void ThisDocument_Startup(object sender, System.EventArgs e)
   {
       this.Paragraphs[1].Range.InsertParagraphAfter();
       this.Paragraphs[2].Range.Text = "This text was added by using code.";
   }
   

   ملاحظة

   تستخدم هذه التعليمات البرمجية قيمة الفهرس 1 للوصول للفقرة الأولى في الخاصية Paragraphs. لا يمكن فتح مشروع بعد الترحيل لمزيد من المعلومات، راجع البرمجة باستخدام Visual Basic مقابل استخدام Visual C# في حلول Office.

اختبار المشروع

لاختبار مستندك

1. اضغط F5 لبناء المشروع وتشغيله.

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

2. في المستند، تأكد من رؤية النص التالي.

   هذا النص تمت إضافته باستخدام المصمم.

   تمت إضافة هذا النص باستخدام تعليمات برمجية (This text was added by using code).

3. قم بإغلاق المستند.

تنظيف المشروع

عند الانتهاء من تطوير مشروع ما، يجب إزالة الملفات الموجودة في مجلد إخراج البناء وإعدادات الأمان التي تم إنشاؤها بواسطة عملية البناء.

لتنظيف المشاريع المكتملة على كمبيوتر التطوير الخاص بك

• في Visual Studio على القائمة بناء ، انقر فوق ‎تنظيف الحل.

الخطوات التالية

والآن بعد أن قمت بإنشاء تخصيص أساسي على مستوى المستند لـ Word، يمكنك معرفة المزيد حول كيفية تطوير تخصيصات من هذه المواضيع:

• مهام البرمجة العامة التي يمكنك تنفيذها في تخصيصات على مستوى المستند: برمجة تخصيصات علي مستوي مستند.

• مهام البرمجة المحددة إلى تخصيصات على مستوى المستند لـ Word: حلول Word.

• استخدام نموذج الكائن لـ Word. نظرة عامة على نموذج كائن Word.

• تخصيص واجهة المستخدم لـ Word، على سبيل المثال، بإضافة علامة تبويب مخصصة للشريط أو إنشاء جزء الإجراءات الخاص بك: تخصيص واجهة Office.

• استخدام كائنات Word موسعة تم توفيرها من قبل Visual Studio Tools لـ Office لتنفيذ المهام التي ليست ممكنة باستخدام نموذج كائن Word (على سبيل المثال، استضافة عناصر تحكم مدارة على المستندات ثم ربط عناصر تحكم Word بالبيانات باستخدام نموذج ربط بيانات Windows Forms): أتمتة Word عن طريق استخدام الكائنات الموسعة.

• بناء وتصحيح أخطاء التخصيصات على مستوى المستند لـ Word: بناء وتصحيح أخطاء حلول Office.

• نشر تخصيصات على مستوى المستند لـ Word: توزيع حلول Office.

راجع أيضًا:

المبادئ

نظرة عامة حول تطوير حلول Office

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

موارد أخرى

حلول Word

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

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

تخصيص واجهة Office

بناء وتصحيح أخطاء حلول Office

توزيع حلول Office

نظرة عامة حول قوالب مشاريع Office