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

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

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

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

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

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

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

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

ملاحظة

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

للحصول على عرض فيديو توضيحي ذي صلة، راجع كيف يمكنني القيام بما يلي: إنشاء وظيفة إضافية لـ Microsoft PowerPoint ؟.

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

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

-

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

• PowerPoint 2007 أو برنامج PowerPoint 2010

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

لإنشاء أحد المشروعات الجديدة

1. ابدأ Visual Studio.

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

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

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

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

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

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

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

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

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

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

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

لإضافة مربع نص إلى كل شريحة جديدة

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

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

   Private Sub Application_PresentationNewSlide(ByVal Sld As PowerPoint.Slide) _
       Handles Application.PresentationNewSlide
       Dim textBox As PowerPoint.Shape = Sld.Shapes.AddTextbox( _
           Office.MsoTextOrientation.msoTextOrientationHorizontal, 0, 0, 500, 50)
       textBox.TextFrame.TextRange.InsertAfter("This text was added by using code.")
   End Sub
   

   void Application_PresentationNewSlide(PowerPoint.Slide Sld)
   {
       PowerPoint.Shape textBox = Sld.Shapes.AddTextbox(
           Office.MsoTextOrientation.msoTextOrientationHorizontal, 0, 0, 500, 50);
       textBox.TextFrame.TextRange.InsertAfter("This text was added by using code.");
   }
   

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

   this.Application.PresentationNewSlide += 
       new PowerPoint.EApplication_PresentationNewSlideEventHandler(
       Application_PresentationNewSlide);
   

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

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

• المعلمة Sld الخاصة بـمعالج الأحداث للحدث PresentationNewSlide . المعلمة Sld هي كائن Microsoft.Office.Interop.PowerPoint.Slide يمثل الشريحة الجديدة. لمزيد من المعلومات، راجع حلول PowerPoint.

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

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

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

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

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

2. في PowerPoint، أضف شريحة جديدة إلى العرض التقديمي النشط.

3. تحقق من إضافة النص التالي إلى مربع نص جديد في الجزء العلوي من الشريحة.

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

4. أغلق PowerPoint.

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

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

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

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

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

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

• المهام البرمجة العامة التي يمكنك تنفيذها في الوظائف الإضافية لـ PowerPoint. لمزيد من المعلومات، راجع برمجة وظائف إضافية على مستوى التطبيق.

• استخدام نموذج الكائن الخاص بـ PowerPoint لمزيد من المعلومات، راجع حلول PowerPoint.

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

• إنشاء و تصحيح الوظائف الإضافية على مستوى التطبيق لـ PowerPoint. لمزيد من المعلومات، راجع بناء وتصحيح أخطاء حلول Office.

• نشر الوظائف الإضافية على مستوى التطبيق لـ PowerPoint. لمزيد من المعلومات، راجع توزيع حلول Office.

راجع أيضًا:

المبادئ

حلول PowerPoint

موارد أخرى

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

تخصيص واجهة Office

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

توزيع حلول Office

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