مشاركة عبر

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

  • مقالة

ينطبق على

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

نوع المشروع

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

إصدار Microsoft Office

  • Project 2007

  • Project 2010

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

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

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

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

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

  • تنظيف المشاريع المكتملة بحيث لا تعمل الوظيفة الإضافية بعد ذلك تلقائياً على كمبيوتر المطور الخاص بك .

ملاحظة

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

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

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

-

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

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

لإنشاء مشروع جديد في ‏‫Visual Studio

  1. ابدأ Visual Studio.

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

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

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

  5. في قائمة قوالب المشروع حدد وظيفة Project 2007 الإضافية أو وظيفة Project 2010 الإضافية.

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

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

    Visual Studio ينشئ المشروع FirstProjectAddIn و يفتح ملف التعليمات البرمجية ThisAddIn في المحرر.

كتابة التعليمات البرمجية التي تقوم بإضافة مهمة جديدة لمشروع

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

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

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

لإضافة مهمة إلى مشروع جديد

  • في ملف التعليمات البرمجية ThisAddIn ، قم بإضافة التعليمة البرمجية التالية للفئة ThisAddIn تعرّف هذه التعليمة البرمجية معالج أحداث للحدث NewProject من الفئة Microsoft.Office.Interop.MSProject.Application .

    عندما يقوم المستخدم بإنشاء مشروع جديد, يقوم معالج الحدث هذا بإضافة المهمة للمشروع.

    Private Sub Application_NewProject(ByVal pj As Microsoft.Office.Interop.MSProject.Project) Handles Application.NewProject
    Dim newTask As MSProject.Task
    newTask = pj.Tasks.Add _
    ("This text was added by using code")
    newTask.Start = DateTime.Now
    newTask.Duration = "3"
    newTask.ResourceNames = "Rob Caron, Kelly Krout"
End Sub

    void Application_NewProject(Microsoft.Office.Interop.MSProject.Project pj)
{
    MSProject.Task newTask = pj.Tasks.Add
        ("This text was added by using code", missing);
    newTask.Start = DateTime.Now;
    newTask.Duration = "3";
    newTask.ResourceNames = "Rob Caron, Kelly Krout";
}

لتعديل المشروع, يقوم مثال التعليمات البرمجية هذا باستخدام الكائنات التالية:

  • الحقل Application من الفئة ThisAddIn . يقوم الحقل Application بإرجاع الكائن Microsoft.Office.Interop.MSProject.Application الذي يمثل مثيل المشروع الحالي.

  • المعلمة pj الخاصة بـمعالج الأحداث للحدث NewProject . المعلمة pj هي كائن Microsoft.Office.Interop.MSProject.Project الذي يمثل المشروع. لمزيد من المعلومات، راجع حلول المشروع.

  1. إذا كنت تستخدم C# ، أضف التعليمة البرمجية التالية إلى معالج الحدث ThisAddIn_Startup . توصل هذه التعليمات البرمجية معالج الأحداث Application_Newproject مع الحدث NewProject.

    this.Application.NewProject += new Microsoft.Office.Interop.MSProject._EProjectApp2_NewProjectEventHandler(Application_NewProject);

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

عند بنائك وتشغيلك المشروع، تحقق من ظهور المهمة الجديدة في المشروع الجديد الناتج.

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

  1. اضغط F5 لبناء المشروع وتشغيله. يبدأ Microsoft Project و يقوم تلقائياً بفتح مشروع فارغ جديد.

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

  2. تحقق من إضافة مهمة جديدة للمشروع الفارغ.

  3. تحقق من ظهور النص التالي في حقل اسم المهمة للمهمة.

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

  4. قم بإغلاق Microsoft Project.

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

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

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

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

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

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

راجع أيضًا:

المبادئ

حلول المشروع

موارد أخرى

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

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

توزيع حلول Office

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