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

مقالة
11/01/2010

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

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

نوع المشروع

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

إصدار Microsoft Office

Word 2007

توضح هذه الإرشادات التفصيلية كيفية إنشاء علامات ذكية على مستوى التطبيق يمكن استخدامها في كل مستند مفتوح. العلامة الذكية تتعرف على قياسات بملعقة الطعام في مستند Microsoft Office 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 إضافية.

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

حدث خطأ عند محاولة إنشاء أو فتح ‏‫المكتب مشروع، ولكن لم برنامج ‏‫Visual Studio معلومات كافية لتحديد السبب.

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

Visual Studio adds the My Recipe Smart Tag project to Solution Explorer.

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

يحتاج المشروع مرجعاً لـ 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;
```

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

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

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

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

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

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

    Dim SmartTagDemo As New Microsoft.Office.Tools.Word.SmartTag( _
        "www.microsoft.com/Demo#DemoSmartTag", "Recipe Smart Tag")

    SmartTagDemo.Expressions.Add(New Regex( _
        "(?'tbsNumber'[+-]?\b[0-9]+)?\s?(tbs|tablespoons|tablespoon)\b"))

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

private void ThisAddIn_Startup(object sender, System.EventArgs e)
{
    Microsoft.Office.Tools.Word.SmartTag SmartTagDemo =
        new Microsoft.Office.Tools.Word.SmartTag(
        @"www.microsoft.com/Demo#DemoSmartTag",
        @"Recipe Smart Tag");

    // Specify the terms to recognize.
    SmartTagDemo.Expressions.Add(new Regex(
        @"(?'tbsNumber'[+-]?\b[0-9]+)?\s?(tbs|tablespoons|tablespoon)\b"));

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

RecipeAction = New Microsoft.Office.Tools.Word.Action("Convert to ounces")
SmartTagDemo.Actions = New Microsoft.Office.Tools.Word.Action() {RecipeAction}

RecipeAction = new Microsoft.Office.Tools.Word.Action(
    @"Convert to ounces");

// Add the action to the smart tag.
SmartTagDemo.Actions = new Microsoft.Office.Tools.Word.Action[] { RecipeAction };

قم بإرفاق علامة ذكية إلى خاصية VstoSmartTags من فئة ThisAddIn . في C# ، قم بإرفاق معالج الأحداث إلى الحدث Click من الإجراء.

    Me.VstoSmartTags.Add(SmartTagDemo)
End Sub

    // Add the smart tag to the document.
    this.VstoSmartTags.Add(SmartTagDemo);

    RecipeAction.Click += new Microsoft.Office.Tools.Word.ActionClickEventHandler(
        RecipeAction_Click);
}

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

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

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

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

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

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

    Dim value As String = e.Properties.Read("tbsNumber")
    Dim tbsRecipeAmount As Double = System.Convert.ToDouble(value)
    Dim ozRecipeAmount As Double = tbsRecipeAmount * 0.5
    e.Range.InsertAfter(" (" + ozRecipeAmount.ToString() + " oz)")
End Sub

private void RecipeAction_Click(object sender,
    Microsoft.Office.Tools.Word.ActionEventArgs e)
{
    string value = e.Properties.get_Read(@"tbsNumber");
    double tbsRecipeAmount = System.Convert.ToDouble(value);
    double ozRecipeAmount = tbsRecipeAmount * 0.5;
    e.Range.InsertAfter(" (" + ozRecipeAmount.ToString() + " oz)");
}

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

الآن يمكنك اختبار المستند للتحقق من أن العلامة الذكية تحول قياسات ملعقة الطعام إلى أواقي.

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

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

لمزيد من المعلومات، راجع كيفية القيام بما يلي: تمكين العلامات الذكية في Word وExcel.
اضغط F5 لتشغيل مشروعك.
في مستند Word ,اكتب 1 tablespoon salt (ملعقة طعام واحدة من ملح).
انقر فوق أيقونة العلامة الذكية التي تظهر فوق 1 tablespoon ثم انقر فوق تحويل إلى أوقية . .
تأكد من أنه تم إدراج أواقي مكافئة بعد ملعقة الطعام.

راجع أيضًا:

مشاركة عبر