مشاركة عبر


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

ينطبق على

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

نوع المشروع

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

إصدار Microsoft Office

  • Outlook 2007

  • Outlook 2010

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

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

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

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

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

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

ملاحظة

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

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

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

-

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

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

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

  1. ابدأ Visual Studio.

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

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

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

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

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

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

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

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

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

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

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

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

  1. في ملف التعليمات البرمجية ThisAddIn ، قم بتعريف حقل باسم inspectors في الفئة ThisAddIns. الحقل inspectors يحتفظ بمرجع إلى مجموعة نوافذ التحكم في مثيل Outlook الحالي. يمنع هذا المرجع مجمع البيانات المهملة من تحرير الذاكرة التي تحتوي على معالج الحدث لحدث NewInspector .

    Private WithEvents inspectors As Outlook.Inspectors
    
    Outlook.Inspectors inspectors;
    
  2. قم باستبدال الأسلوب ThisAddIn_Startup كما في التعليمات البرمجية التالية. تقوم التعليمات البرمجية بإرفاق معالج الأحداث للحدث NewInspector .

    Private Sub ThisAddIn_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
        inspectors = Me.Application.Inspectors
    End Sub
    
    private void ThisAddIn_Startup(object sender, System.EventArgs e)
    {
        inspectors = this.Application.Inspectors;
        inspectors.NewInspector +=
        new Microsoft.Office.Interop.Outlook.InspectorsEvents_NewInspectorEventHandler(Inspectors_NewInspector);
    }
    
  3. في ملف التعليمات البرمجية ThisAddIn ، قم بإضافة التعليمة البرمجية التالية للفئة ThisAddIn تعرّف هذه التعليمة البرمجية معالج أحداث للحدث NewInspector .

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

    Private Sub inspectors_NewInspector(ByVal Inspector As Microsoft.Office.Interop.Outlook.Inspector) Handles inspectors.NewInspector
        Dim mailItem As Outlook.MailItem = CType(Inspector.CurrentItem, Outlook.MailItem)
        If Not (mailItem Is Nothing) Then
            If mailItem.EntryID Is Nothing Then
                mailItem.Subject = "This text was added by using code"
                mailItem.Body = "This text was added by using code"
            End If
        End If
    End Sub
    
    void Inspectors_NewInspector(Microsoft.Office.Interop.Outlook.Inspector Inspector)
    {
        Outlook.MailItem mailItem = (Outlook.MailItem)Inspector.CurrentItem;
        if (mailItem != null)
        {
            if (mailItem.EntryID == null)
            {
                mailItem.Subject = "This text was added by using code";
                mailItem.Body = "This text was added by using code";
            }
    
        }
    }
    

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

  • الحقل Application من الفئة ThisAddIn . يقوم الحقل Application بإرجاع الكائن Application الذي يمثل مثيل Outlook الحالي.

  • المعلمة Inspector الخاصة بـمعالج الأحداث للحدث NewInspector . المعلمة Inspector هي كائن Inspector يمثل نافذة متفحص لرسالة البريد الجديدة . لمزيد من المعلومات، راجع حلول Outlook.

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

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

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

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

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

  2. في Outlook، قم بإنشاء رسالة بريد جديدة.

  3. تحقق من إضافة النص التالي لكل من سطر الموضوع أو نص الرسالة.

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

  4. أغلق Outlook.

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

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

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

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

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

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

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

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

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

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

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

راجع أيضًا:

موارد أخرى

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

حلول Outlook

تخصيص واجهة Office

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

توزيع حلول Office

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