مشاركة عبر

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

  • مقالة

ينطبق على

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

نوع المشروع

  • مشروعات على مستوى التطبيق

إصدار Microsoft Office

  • Word 2007

  • Word 2010

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

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

  • إنشاء مشروع وظيفة Word إضافية.

  • كتابة تعليمات برمجية تستخدم نموذج كائن من 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 الإضافية أو وظيفة 2010 Word الإضافية .

  6. في مربع الاسم , اكتب FirstWordAddIn .

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

    يقوم Visual Studio بإنشاء المشروع FirstWordAddIn ويفتح ملف التعليمات البرمجية ThisAddIn في المحرر.

كتابة التعليمات البرمجية لإضافة نص إلى مستند محفوظ

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

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

  • معالجا الأحداث ThisAddIn_Startup وThisAddIn_Shutdown. يتعرض معطل مصنفات Excel عندما تكون مشروع تخصيص المستوى مستند 2007 Excel فتح في ‏‫Visual Studio استخدام هذه معالجات الأحداث يهيّئ الوظيفة الإضافية عند هو تم تحميله، ولتنظيف موارد المستخدمة من قبل الوظيفة الإضافية عند هو غير محمل. لمزيد من المعلومات، راجع الأحداث في مشاريع Office.

لإضافة فقرة من نص إلى المستند المحفوظ

  1. في ملف التعليمات البرمجية ThisAddIn ، قم بإضافة التعليمة البرمجية التالية للفئة ThisAddIn تقوم التعليمات البرمجية الجديدة بتعريف معالج الحدث DocumentBeforeSave الذي يتم رفعه عند حفظ. المستند

    عند قيام المستخدم بحفظ مستند ، يضيف معالج الأحداث النص الجديد في البداية المستند.

    Private Sub Application_DocumentBeforeSave(ByVal Doc As Word.Document, ByRef SaveAsUI As Boolean, _
    ByRef Cancel As Boolean) Handles Application.DocumentBeforeSave
    Doc.Paragraphs(1).Range.InsertParagraphBefore()
    Doc.Paragraphs(1).Range.Text = "This text was added by using code."
End Sub

    void Application_DocumentBeforeSave(Word.Document Doc, ref bool SaveAsUI, ref bool Cancel)
{
    Doc.Paragraphs[1].Range.InsertParagraphBefore();
    Doc.Paragraphs[1].Range.Text = "This text was added by using code.";
}

    ملاحظة

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

  2. إذا كنت تستخدم C# ، أضف التعليمة البرمجية التالية إلى معالج الحدث ThisAddIn_Startup . هذه التعليمات البرمجية مطلوبة لاستدعاء معالج الأحداث Application_DocumentBeforeSave مع الحدث DocumentBeforeSave .

    this.Application.DocumentBeforeSave += 
    new Word.ApplicationEvents4_DocumentBeforeSaveEventHandler(Application_DocumentBeforeSave);

لتعديل المستند عند حفظه ,أمثلة التعليمات البرمجية السابقة تستخدم الكائنات التالية:

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

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

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

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

  2. في Word، احفظ المستند النشط.

  3. تحقق من إضافة النص التالي إلى المستند.

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

  4. أغلق Word.

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

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

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

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

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

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

راجع أيضًا:

المبادئ

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

موارد أخرى

حلول Word

برمجة وظائف إضافية على مستوى التطبيق

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

تخصيص واجهة Office

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

توزيع حلول Office

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