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

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

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

لمزيد من المعلومات حول الفئة Globals، راجع الوصول العمومي إلى الكائنات في مشاريع Office.

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

الوصول إلى مناطق النماذج التي تظهر في نافذة متفحص Outlook محددة

للوصول إلى كافة مناطق النموذج التي تظهر في متفحص Outlook معين, قم باستدعاء الخاصية FormRegions من الفئة Globals و مرر كائن Inspector الذي يمثل المتفحص.

يحصل المثال التالي علي مجموعة مناطق النماذج التي تظهر في المتفحص الذي عليه التركيز حالياً. ثم يقوم هذا المثال بالوصول إلى منطقة نموذج في المجموعة باسم formRegion1 ويقوم بتعيين النص الذي يظهر في مربع نص إلي Hello World.

    Private Sub Access_Form_Regions_ByInspector()
        Dim formRegions As WindowFormRegionCollection = Globals.FormRegions _
            (Globals.ThisAddIn.Application.ActiveInspector())
        formRegions.FormRegion1.textBox1.Text = "Hello World"
    End Sub

private void Access_Form_Regions_ByInspector()
{
    WindowFormRegionCollection formRegions = 
        Globals.FormRegions
            [Globals.ThisAddIn.Application.ActiveInspector()];
    formRegions.FormRegion1.textBox1.Text = "Hello World";
}

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

للوصول إلى كافة مناطق النموذج التي تظهر في مستكشف Outlook معين, قم باستدعاء خاصية FormRegions من فئة Globals و مرر كائن Explorer الذي يمثل المستكشف.

يحصل المثال التالي علي مجموعة مناطق النماذج التي تظهر في المستكشف الذي عليه التركيز حالياً. ثم يقوم هذا المثال بالوصول إلى منطقة نموذج في المجموعة باسم formRegion1 ويقوم بتعيين النص الذي يظهر في مربع نص إلي Hello World.

Private Sub Access_Form_Regions_ByExplorer()
    Dim formRegions As WindowFormRegionCollection = Globals.FormRegions _
        (Globals.ThisAddIn.Application.ActiveExplorer())
    formRegions.FormRegion1.textBox1.Text = "Hello World"
End Sub

private void Access_Form_Regions_ByExplorer()
{
    WindowFormRegionCollection formRegions =
        Globals.FormRegions
            [Globals.ThisAddIn.Application.ActiveExplorer()];
    formRegions.FormRegion1.textBox1.Text = "Hello World";
}

الوصول إلى كافة مناطق النموذج

للوصول إلى كافة مناطق النموذج التي تظهر في كافة المستكشفات والمتفحصين ، قم باستدعاء الخاصية FormRegions للفئة Globals .

المثال التالي يحصل على مجموعة مناطق النموذج التي تظهر في كافة المستكشفات و المتفحصين. ثم يقوم هذا المثال بالوصول إلى منطقة نموذج في المجموعة باسم formRegion1 ويقوم بتعيين النص الذي يظهر في مربع نص إلي Hello World.

Friend Sub Access_All_Form_Regions()
    Dim formRegion As Microsoft.Office.Tools.Outlook.IFormRegion
    For Each formRegion In Globals.FormRegions
        If TypeOf formRegion Is FormRegion1 Then
            Dim formRegion1 As FormRegion1 = _
                CType(formRegion, FormRegion1)
            formRegion1.textBox1.Text = "Hello World"
        End If
    Next formRegion
End Sub

internal void Access_All_Form_Regions()
{
    foreach (Microsoft.Office.Tools.Outlook.IFormRegion formRegion 
        in Globals.FormRegions)
    {
        if (formRegion is FormRegion1)
        {
            FormRegion1 formRegion1 = (FormRegion1)formRegion;
            formRegion1.textBox1.Text = "Hello World";
        }
    }

}

الوصول إلى عناصر التحكم في منطقة نموذج

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

مناطق النموذج المصممة في مصمم مناطق النموذج

بالنسبة لـ C# ، قم بتغيير المعدّل لكل عنصر تحكم تريد الوصول إليه. To do this, select each control in the form region designer and change the Modifiers property to Internal or public in the Properties window. For example, if you change the Modifier property of textBox1 to Internal, you can access textBox1 by typing Globals.FormRegions.FormRegion1.textBox1.

لـ Visual Basic ، لا تحتاج لتغيير المعدل.

مناطق النموذج المستوردة

عند استيراد منطقة نموذج تم تصميمها في Outlook، معدِّل الوصول لكل عنصر تحكم في منطقة النموذج يصبح خاصاً. لأنه لا يمكنك استخدام مصمم منطقة النموذج لتعديل منطقة نموذج مستوردة ، لا توجد طريقة لتغيير المعدّل لعنصر التحكم في النافذة خصائص.

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

للحصول على مزيد من المعلومات حول كيفية إنشاء خصائص في C# , راجع كيفية: قم بتعريف خصائص القراءة/الكتابة (C# البرمجة دليل) واستخدامها.

للحصول على مزيد من المعلومات حول كيفية إنشاء خصائص في Visual Basic, راجع How to: Add Fields and Properties to a Class.

راجع أيضًا:

المهام

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

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

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

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

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

المبادئ

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

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

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

الوصول إلى الشريط في وقت التشغيل

موارد أخرى

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