الإرشادات التفصيلية: إنشاء علامة ذكية باستخدام تخصيص على مستوى المستند

مقالة
11/01/2010

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

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

نوع المشروع

مشروعات على مستوى المستند

إصدار Microsoft Office

Word 2007

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

لتشغيل هذه العلامة الذكية ، يجب على المستخدمين النهائيين تمكين العلامات الذكية في Word. لمزيد من المعلومات، راجع كيفية القيام بما يلي: تمكين العلامات الذكية في Word وExcel.

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

إنشاء علامة ذكية تتعرف على التعبير العادي.
إنشاء إجراء لاسترداد البيانات من العلامة الذكية و يعدل نص العلامة الذكية التى تم التعرف عليها.

ملاحظة

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

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

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

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

Word 2007
.Net Framework 3.5

ملاحظة

إذا كنت تستهدف .Net framework4 يجب كتابة التعليمات البرمجية المختلفة لإنشاء العلامات الذكية والإجراءات. لمزيد من المعلومات، راجع بنية العلامات الذكية.

إنشاء مشروع جديد

الخطوة الأولى هي إنشاء مشروع مستند Word.

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

قم بإنشاء مشروع Wأوd 2007 المستند يحمل الاسم الخاص بي علامة ذكية، أما باستخدام Visual أساسى أو C#. في المعالج، حدد إنشاء مستند جديد .

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

‏‫Visual Studio opens the جديد الكلمة مستند في the مصمم و adds the My ذكى علامة مشروع إلى الحل مستكشف.

تكوين المشروع

يحتاج المشروع مرجعاً لـ DLL العلامة الذكية ,ويحتاج أيضاً لإستخدام تعبيرات عادية.

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

في قائمة المشروع انقر فوق إضافة مرجع .
في علامة التبويب .NET ، حدد Microsoft.Office.Interop.SmartTag و انقر فوق موافق . حدد إصدار 12.0.0.0 الخاص بالتجميع.
في مستكشف الحلول أنقر بزر الماوس الأيمن فوق ThisDocument.vb (في Visual Basic) "أو" ThisDocument.cs (في C#) ، ثم انقر فوق عرض التعليمات البرمجية .
قم بإضافة سطر التعليمات البرمجية التالي أعلى الملف.
```
Imports System.Text.RegularExpressions
```
```
using System.Text.RegularExpressions;
```

إنشاء العلامات الذكية

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

لإنشاء العلامة الذكية

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

WithEvents action1 As Microsoft.Office.Tools.Word.Action

Private Sub ThisDocument_Startup(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Me.Startup

    'Use the following line of code in projects that target the .NET Framework 4.
    Dim smartTag1 As Microsoft.Office.Tools.Word.SmartTag = _
        Globals.Factory.CreateSmartTag( _
       "www.microsoft.com/Demo#DemoSmartTag", _
       "Demonstration Smart Tag")

    'In projects that target the .NET Framework 3.5, use the following line of code.
    'Dim smartTag1 As New Microsoft.Office.Tools.Word.SmartTag( _
    '   "www.microsoft.com/Demo#DemoSmartTag", _
    '  "Demonstration Smart Tag")

    smartTag1.Expressions.Add( _
        New Regex("(?'number'[+-]?\b[0-9]+)?\s?(F|f)\b"))

private Microsoft.Office.Tools.Word.Action action1;

private void ThisDocument_Startup(object sender, System.EventArgs e)
{
    // Use the following line of code in projects that target the .NET Framework 4.
    Microsoft.Office.Tools.Word.SmartTag smartTag1 =
        Globals.Factory.CreateSmartTag(
        "www.microsoft.com/Demo#DemoSmartTag",
        "Demonstration Smart Tag");

    // In projects that target the .NET Framework 3.5, use the following line of code.
    //Microsoft.Office.Tools.Word.SmartTag smartTag1 =
    //  new Microsoft.Office.Tools.Word.SmartTag(
    //  "www.microsoft.com/Demo#DemoSmartTag",
    //  "Demonstration Smart Tag");

    smartTag1.Expressions.Add(new Regex(
        @"(?'number'[+-]?\b[0-9]+)�?\s?(F|f)\b"));

قم بإنشاء Action جديد وقم بإضافته إلى الخاصية Actions الخاصة بالعلامة الذكية. يمثل Action العنصر الذي يمكن للمستخدم النقر عليه في قائمة العلامة الذكية.

'Use the following line of code in projects that target the .NET Framework 4.
action1 = Globals.Factory.CreateAction( _
    "Convert to Celsius")

'In projects that target the .NET Framework 3.5, use the following line of code.
'action1 = New Microsoft.Office.Tools.Word.Action( _
'    "Convert to Celsius")

smartTag1.Actions = _
    New Microsoft.Office.Tools.Word.Action() {action1}


// Use the following line of code in projects that target the .NET Framework 4.
action1 = Globals.Factory.CreateAction(
    "Convert to Celsius");

// In projects that target the .NET Framework 3.5, use the following line of code.
//action1 = new Microsoft.Office.Tools.Word.Action(
//    "Convert to Celsius");



smartTag1.Actions = new
    Microsoft.Office.Tools.Word.Action[] {action1};

قم بإرفاق العلامات الذكية إلى المستند عن طريق إضافة SmartTag إلى الخاصية VstoSmartTags . في C# ، قم بإرفاق معالج الأحداث إلى الحدث Click من الإجراء.
```
    Me.VstoSmartTags.Add(smartTag1)
End Sub
```
```
    this.VstoSmartTags.Add(smartTag1);

    action1.Click += new
        Microsoft.Office.Tools.Word.ActionClickEventHandler(
        action1_Click);
}
```

إنشاء معالج أحداث للإجراء

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

في هذا المثال، المفتاح رقم يقوم بتعريف مجموعة من التعبيرات العادية المعيّنة إلى العلامة الذكية. للحصول على مزيد من المعلومات حول حقائب الخواص و التعبيرات العادية في العلامات الذكية ، راجع بنية العلامات الذكية.

لإنشاء معالج الأحداث

قم بنسخ التعليمات البرمجية التالية إلى الفئة ThisDocument .

Private Sub action1_Click(ByVal sender As Object, _
    ByVal e As Microsoft.Office.Tools.Word.ActionEventArgs) _
    Handles action1.Click

    Dim value As String = e.Properties.Read("number")
    Dim fahrenheit As Double = System.Convert.ToDouble(value)
    Dim celsius As Integer = Fix(fahrenheit - 32) * 5 / 9
    e.Range.Text = celsius.ToString() + "C"
End Sub

void action1_Click(object sender,
    Microsoft.Office.Tools.Word.ActionEventArgs e)
{
    string value = e.Properties.get_Read("number");
    double fahrenheit = System.Convert.ToDouble(value);
    int celsius = (int)(fahrenheit - 32) * 5 / 9;
    e.Range.Text = celsius.ToString() + "�C";
}

اختبار التطبيق

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

لاختبار المصنف الخاص بك

في Word، قم بتمكين العلامات الذكية.

لمزيد من المعلومات، راجع كيفية القيام بما يلي: تمكين العلامات الذكية في Word وExcel.
اضغط F5 لتشغيل مشروعك.
اكتب سلسلة تتوافق مع التعبير العادي الذي قمت بإضافته إلى العلامة الذكية مثل 60F F ° 60أو 60 F .

ملاحظة

لكتابة رمز الدرجة (°) ، اضغط على ALT واكتب 248.
انقر فوق رمز العلامة الذكية الذي يظهر فوق السلسلة التي تم التعرف عليها ثم انقر فوق تحويل إلى درجة مئوية.
تأكد من استبدال السلسلة الأصلية بسلسلة جديدة تحتوي على درجة الحرارة بالقيمة المئوية.

راجع أيضًا:

مشاركة عبر