الإرشادات التفصيلية: تصميم منطقة نموذج Outlook

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

توسع مناطق النموذج المخصصة نماذج Microsoft Office Outlook القياسية أو المخصصة . في هذه الإرشادات التفصيلية، ستقوم بتصميم منطقة نموذج مخصص تظهر كصفحة جديدة في نافذة المتفحص لعنصر جهة الاتصال. تعرض منطقة النموذج هذه خريطة لكل عنوان مسرد لجهة الاتصال، عن طريق إرسال معلومات العنوان إلى موقع البحث المحلي لـ Windows Live .

لمزيد من المعلومات حول مناطق النموذج , راجع إنشاء مناطق نموذج 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

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

أولاً قم بإنشاء مشروع وظيفة إضافية أساسي.

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

1. هذا النموذج متوفر فقط متصل.Visual Studio

2. في مربع الحوار مشروع جديد، حدد إنشاء دليل للحل.

3. احفظ المشروع إلى أى دليل.

   لمزيد من المعلومات، راجع كيفية القيام بما يلي: إنشاء مشاريع Office في Visual Studio.

إضافة نطاق نموذج إلى مشروع وظيفة Outlook الإضافية

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

لاضافة منطقة نموذج إلى مشروع وظيفة Outlook الإضافية

1. في مستكشف الحلول ،حدد المشروعWinFormInput .

2. في مشروع قائمة ، انقر فوق إضافة عنصر جديد .

3. In the Add New Item dialog box, select Outlook Form Region, name the file MapIt, and then click Add.

   سيبدأ تشغيل المعالج منطقة نموذج Outlook الجديد .

4. على الصفحة قم بتحديد كيف تريد إنشاء صفحة منطقة النموذج ، انقر فوق تصميم منطقة نموذج جديدةثم انقر فوق التالي.

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

   منطقة نموذج منفصلة تضيف صفحة جديدة لنموذج Outlook. لمزيد من المعلومات حول أنواع مناطق النموذج , راجع إنشاء مناطق نموذج Outlook.

6. على الصفحة قم بتدعيم نص وصفي ثم حدد تفضيلات العرض الخاصة بك ، اكتب عيّنها (‎Map It) في المربع الاسم.

   هذا الاسم يظهر على شريط نافذة المتفحص عند فتح عنصر جهة الاتصال.

7. حدد المتفحصون الذين في وضع إنشاء و المتفحصون الذين في وضع القراءة ، ثم انقر التالي.

8. على الصفحة قم بتعريف فئات الرسائل التي ستقوم بعرض منطقة النموذج هذه ، قم بإلغاء رسالة البريد،اختر الاتصال ، ثم انقر إنهاء.

   يتم إضافة ملف TaskFormRegion.cs أو TaskFormRegion.vb إلى مشروعك.

تصميم التخطيط لمنطقة النموذج.

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

تصميم التخطيط لمنطقة النموذج.

1. في مستكشف الحلول، قم بتوسيع المشروع MapItAddIn ثم انقر نقراً مزدوجاً فوق MapIt.cs أو MapIt.vb لفتح "مصمم منطقة النموذج".

2. انقر بزر الفارة الأيمن فوق المصمم، ثم انقر فوق خصائص.

3. In the Properties window, set Size to 664, 469.

   هذا يضمن أن منطقة النموذج ستكون كبيرة بما فيه الكفاية لعرض خريطة.

4. في القائمة عرض، انقر فوق تفاصيل.

5. من علامة تبويب عناصر التحكم الشائعة الخاصة بـمربع الأدوات ، قم بإضافة متصفح الشبكة (WebBrowser‎) إلى منطقة النموذج.

   WebBrowser سيعرض خريطة لكل عنوان مسرود لجهة الاتصال.

تخصيص السلوك لمنطقة النموذج.

قم بإضافة تعليمات برمجية لمعالجات الأحداث بمنطقة النموذج لتخصيص طريقة تصرف منطقة النموذج في وقت التشغيل. لمنطقة النموذج هذه، التعليمة البرمجية تفحص خصائص عنصر Outlook و تحدد ما إذا كان يجب عرض منطقة النموذج "Map It". إذا تم عرض منطقة النموذج، تقوم التعليمات البرمجية بالانتقال إلى البحث المحلي الخاص بـ Windows Live و تقوم بتحميل خريطة لكل عنوان مسرود في عنصر جهة اتصال Outlook.

لتخصيص سلوك منطقة النموذج.

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

   MapIt.cs أو MapIt.vb يفتح في محرر التعليمات البرمجية.

2. قم بتوسيع منطقة التعليمات البرمجية مصنع منطقة النموذج.

   يتم عرض فئة مصنع منطقة النموذج MapItFactory .

3. قم بإضافة التعليمات البرمجية التالية إلى معالج الحدث MapItFactory_FormRegionInitializing . يتم استدعاء معالج الحدث هذا عندما يفتح المستخدم عنصر جهة الاتصال . التعليمات البرمجية التالية تحدد ما إذا كان عنصر جهة الاتصال يحتوي على عنوان. إذا لم يتضمن عنصر جهة الاتصال عنوان، هذه التعليمات البرمجية تقوم بتعيين خاصية Cancel للفئة FormRegionInitializingEventArgs إلى true ولا يتم عرض منطقة النموذج. وإلا، فالوظيفة الإضافية تقوم برفع الحدث FormRegionShowing و تقوم بعرض منطقة النموذج.

   Private Sub MapItFactory_FormRegionInitializing(ByVal sender As Object, ByVal e As Microsoft.Office.Tools.Outlook.FormRegionInitializingEventArgs) Handles Me.FormRegionInitializing
   
       Dim myItem As Outlook.ContactItem = CType(e.OutlookItem, Outlook.ContactItem)
   
       If Not (myItem Is Nothing) Then
           If Not (myItem.BusinessAddress Is Nothing) AndAlso myItem.BusinessAddress.Trim().Length > 0 Or (Not (myItem.HomeAddress Is Nothing) AndAlso myItem.HomeAddress.Trim().Length > 0) Or (Not (myItem.OtherAddress Is Nothing) AndAlso myItem.OtherAddress.Trim().Length > 0) Then
               Return
           End If
       End If
   
       e.Cancel = True
   
   End Sub
   

   private void MapItFactory_FormRegionInitializing(object sender,
       Microsoft.Office.Tools.Outlook.FormRegionInitializingEventArgs e)
   {
       Outlook.ContactItem myItem = (Outlook.ContactItem)e.OutlookItem;
   
       if (myItem != null)
       {
           if ((myItem.BusinessAddress != null &&
                   myItem.BusinessAddress.Trim().Length > 0) ||
               (myItem.HomeAddress != null && 
                   myItem.HomeAddress.Trim().Length > 0) ||
               (myItem.OtherAddress != null && 
                   myItem.OtherAddress.Trim().Length > 0))
           {
               return;
           }
       }
   
       e.Cancel = true;
   }
   

4. قم بإضافة التعليمات البرمجية التالية إلى معالج الحدث FormRegionShowing . هذه التعليمة البرمجية تقوم بتنفيذ المهام التالية:

   • يلصق كل عنوان في عنصر جهة الاتصال بجانب الآخر، ويقوم بإنشاء سلسلة URL.

   • يستدعي أسلوبNavigate للكائن WebBrowser و يقوم بتمرىر سلسلة URL كمعلمة متغيرة.

   يظهر موقع ويب البحث المحلي في منطقة النموذج "Map It" و تعرض كل عنوان في دفتر المذكرات.

   Private Sub MapIt_FormRegionShowing(ByVal sender As System.Object, _
       ByVal e As System.EventArgs) Handles MyBase.FormRegionShowing
       Dim tempLoc As String = ""
       Dim defaultAddress As String = ""
       Dim scratchPadAddress As String = ""
   
       Dim myItem As Outlook.ContactItem = _
           CType(Me.OutlookItem, Outlook.ContactItem)
   
       If Not (myItem Is Nothing) Then
           If Not (myItem.HomeAddress Is Nothing) And _
               myItem.HomeAddress.Trim().Length > 0 Then
               tempLoc = myItem.HomeAddressStreet.Trim() + " " _
                   + myItem.HomeAddressCity + " " + myItem.HomeAddressState + _
                       " " + myItem.HomeAddressPostalCode
               If myItem.HomeAddress = myItem.MailingAddress Then
                   defaultAddress = tempLoc + "_Home"
               Else
                   scratchPadAddress += "adr." + tempLoc + "_Home~"
               End If
           End If
           If Not (myItem.BusinessAddress Is Nothing) And _
               myItem.BusinessAddress.Trim().Length > 0 Then
               tempLoc = myItem.BusinessAddressStreet.Trim() + " " _
                   + myItem.BusinessAddressCity + " " + _
                       myItem.BusinessAddressState + " " + _
                           myItem.BusinessAddressPostalCode
               If myItem.BusinessAddress = myItem.MailingAddress Then
                   defaultAddress = tempLoc + "_Business"
               Else
                   scratchPadAddress += "adr." + tempLoc + "_Business~"
               End If
           End If
           If Not (myItem.OtherAddress Is Nothing) And _
               myItem.OtherAddress.Trim().Length > 0 Then
               tempLoc = myItem.OtherAddressStreet.Trim() + " " + _
                   myItem.OtherAddressCity + " " + myItem.OtherAddressState + _
                       " " + myItem.OtherAddressPostalCode
               If myItem.OtherAddress = myItem.MailingAddress Then
                   defaultAddress = tempLoc + "_Other"
               Else
                   scratchPadAddress += "adr." + tempLoc + "_Other~"
               End If
           End If
       End If
   
       WebBrowser1.Navigate(("http://local.live.com/default.aspx?style=r&where1=" _
           + defaultAddress + "&sp=" + scratchPadAddress))
   
   End Sub
   

   private void MapIt_FormRegionShowing(object sender, EventArgs e)
   {
       string tempLoc = "";
       string defaultAddress = "";
       string scratchPadAddress = "";
   
       Outlook.ContactItem myItem = (Outlook.ContactItem)this.OutlookItem;
   
       if (myItem != null)
       {
           if (myItem.HomeAddress != null && 
                   myItem.HomeAddress.Trim().Length > 0)
           {
               tempLoc = myItem.HomeAddressStreet.Trim() + " " + 
                   myItem.HomeAddressCity + " " + myItem.HomeAddressState + 
                       " " + myItem.HomeAddressPostalCode;
               if (myItem.HomeAddress == myItem.MailingAddress)
               {
                   defaultAddress = tempLoc + "_Home";
               }
               else
               {
                   scratchPadAddress += "adr." + tempLoc + "_Home~";
               }
           }
           if (myItem.BusinessAddress != null && 
                   myItem.BusinessAddress.Trim().Length > 0)
           {
               tempLoc = myItem.BusinessAddressStreet.Trim() + 
                   " " + myItem.BusinessAddressCity + " " + 
                       myItem.BusinessAddressState + " " + 
                           myItem.BusinessAddressPostalCode;
               if (myItem.BusinessAddress == myItem.MailingAddress)
               {
                   defaultAddress = tempLoc + "_Business";
               }
               else
               {
                   scratchPadAddress += "adr." + tempLoc + "_Business~";
               }
           }
           if (myItem.OtherAddress != null && myItem.OtherAddress.Trim().Length > 0)
           {
               tempLoc = myItem.OtherAddressStreet.Trim() + " " + 
                   myItem.OtherAddressCity + " " + myItem.OtherAddressState + 
                       " " + myItem.OtherAddressPostalCode;
               if (myItem.OtherAddress == myItem.MailingAddress)
               {
                   defaultAddress = tempLoc + "_Other";
               }
               else
               {
                   scratchPadAddress += "adr." + tempLoc + "_Other~";
               }
           }
       }
   
       webBrowser1.Navigate("http://local.live.com/default.aspx?style=r&where1=" 
           + defaultAddress + "&sp=" + scratchPadAddress);
   
   }
   

اختبار منطقة نموذج Outlook

عند تشغيل المشروع يقوم Visual Studio بفتح Outlook. افتح عنصر جهة اتصال لعرض منطقة النموذج "Map It" . تظهر منطقة النموذج "Map It"، كصفحة في النموذج الخاص بأي عنصر جهة اتصال يحتوي على عنوان.

لاختبار منطقة النموذج "Map It".

1. اضغط F5 لتشغيل المشروع.

   يفتح Outlook.

2. في Outlook، قم بإنشاء جهة اتصال من خلال إجراء إحدى المهام التالية:

   • في 2010 Outlook، على علامة تبويب الصفحة الرئيسية، انقر فوق عناصر جديدة، ثم انقر فوق جهة اتصال.

   • في Outlook 2007، من قائمة ملف، أشر إلى جديد، ثم انقر فوق جهة الاتصال .

3. في نموذج جهة الاتصال ، اكتب Ann Beebe كاسم جهة الاتصال ثم قم بتحديد العناوين الثلاثة التالية.

   نوع العنوان	Address
   العمل	لا يعتمد ‏‫Visual Studio 2010 حلول المكتب تشغيل عندما يكون أحد إصدارات Microsoft المكتب Starter 2010 لجهاز الكمبيوتر الخاص بالمستخدم. المكتب الأساسية إمكانية التشغيل المتداخل تجميعات (PIAs).
   Home	التعامل مع مستندات فتح التنسيقات XML المكتب الأساسية إمكانية التشغيل المتداخل تجميعات (PIAs).
   أزرار أخرى	3456 Main St. تنسيق XML 2007 الكلمة

4. قم بحفظ وإغلاق عنصر جهة الاتصال.

5. قم بإعادة فتح عنصر جهة الاتصال Ann Beebe .

6. في المجموعة إظهار لشريط العنصر, انقر فوق Map It لفت نطقة النموذج الخاصة بالخريطة.

   تظهر منطقة النموذج الخاصة بالخريطة وتعرض موقع البحث المحلي. تظهر العناوين العمل و البيت و غيرها في دفتر المذكرات. في دفتر المذكرات حدد العنوان الذي ترغب في الحصول علي الخريطة الخاصة به.

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

يمكنك معرفة المزيد حول كيفية تخصيص واجهة المستخدم الخاصة بتطبيق Outlook من هذه المواضيع:

• لمعرفة المزيد حول كيفية تخصيص الشريط الخاص بعنصر Outlook راجع تخصيص شريط لـ Outlook.

راجع أيضًا:

المهام

الإرشادات التفصيلية: استيراد منطقة نموذج مصممة في Outlook

كيفية القيام بما يلي: إضافة نطاق نموذج إلى مشروع وظيفة Outlook الإضافية

كيفية القيام بما يلي: منع Outlook من عرض منطقة نموذج

كيفية القيام بما يلي: الوصول إلى عنصر Outlook يعرض منطقة النموذج

المبادئ

الوصول إلى منطقة نموذج في وقت التشغيل

إرشادات حول إنشاء مناطق نموذج Outlook

اقتران منطقة النموذج بفئة الرسالة فى Outlook

إجراءات مخصصة في مناطق نماذج Outlook

موارد أخرى

إنشاء مناطق نموذج Outlook