شريط XML

ينطبق على

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

يمكّنك عنصر الشريط (XML) من تخصيص شريط باستخدام XML. استخدم عنصر شريط (XML) إذا كنت تريد تخصيص الشريط بطريقة غير معتمدة من قبل علي عنصر الشريط (مصمم مرئى). للحصول على مقارنة بين ما يمكنك القيام به مستخدماً كل عنصر ، راجع نظرة عامة على الشريط.

إضافة عنصر شريط (XML) إلي مشروع

يمكنك إضافة عنصر شريط (XML) إلى أي مشروع Office من مربع الحوار إضافة عنصر جديد. يضيف ‏‫Visual Studio الملفات التالية أوتوماتيكياً إلى المشروع:

• ملف شريط XML. هذا الملف يعرف واجهة المستخدم (UI) الشريطية. استخدم هذا الملف لإضافة عناصر واجهة المستخدم مثل علامات التبويب والمجموعات عناصر التحكم. للحصول على تفاصيل، راجع مرجع ملف شريط XML لاحقًا في هذا الموضوع.

• ملف التعليمات البرمجية للشريط.. هذا الملف يحتوي على فئة الشريط. هذه الفئة لها الاسم الذي حددته بإختيارك لعنصر الشريط (XML) من إضافة عنصر جديد في مربع الحوار. إن تطبيقات Microsoft Office تستخدم مثيل من هذه الفئة لتحميل الشريط المخصص. للحصول على تفاصيل، راجع مرجع فئة الشريط لاحقًا في هذا الموضوع.

بشكل افتراضي، تضيف هذه الملفات مجموعة مخصصة إلى علامة التبويب الوظائف الإضافية في الشريط.

عرض الشريط المخصص في أحد تطبيقات Microsoft Office

بعد إضافة عنصر الشريط (XML) إلى المشروع يجب إضافة تعليمات برمجية إلى الفئة ThisAddin أو ThisWorkbookأو ThisDocument التي تتجاوز أسلوب CreateRibbonExtensibilityObject و ترجع فئة شريط XML إلى تطبيق لـ Office.

إن مثال التعليمات البرمجية التالي يتجاوز الأسلوب CreateRibbonExtensibilityObject و يقوم بإرجاع فئة شريط XML تسمى MyRibbon.

Protected Overrides Function CreateRibbonExtensibilityObject() As  _
Microsoft.Office.Core.IRibbonExtensibility
    Return New MyRibbon()
End Function

protected override Microsoft.Office.Core.IRibbonExtensibility CreateRibbonExtensibilityObject()
{
    return new MyRibbon();
}

تعريف سلوك الشريط المخصص

يمكنك الاستجابة إلى إجراءات المستخدم مثل نقر زر فوق الشريط، عن طريق إنشاء أساليب رد الاتصال. أساليب رد الإتصال تشبه أحداثاً في عناصر تحكم Windows Forms، ولكن يتم التعرف عليها من قبل سمة في XML عنصر واجهة المستخدم. تقوم أنت بكتابة أساليب في فئة الشريط و يستدعي عنصر تحكم الأسلوب الذي له نفس الاسم كما في قيمة السمة. على سبيل المثال، يمكنك إنشاء أسلوب رد اتصال يستدعي عندما يقوم مستخدم بنقر زر فوق الشريط.. توجد خطوتان مطلوبتان لإنشاء أسلوب رد إتصال:

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

• قم بتعريف أسلوب رد الاتصال في فئة الشريط.

ملاحظة

يتطلب Outlook خطوة إضافية. لمزيد من المعلومات، راجع تخصيص شريط لـ Outlook.

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

تعيين أساليب الإستدعاء لعناصر التحكم

لتعيين أسلوب رد اتصال إلى عنصر التحكم في ملف من شريط XML، قم بإضافة السمة التي تحدد نوع أسلوب رد الاتصال "و" اسم الأسلوب. على سبيل المثال، يعرّف العنصر التالي زر تبديل يحتوي على أسلوب رد الاتصال onAction المسمي OnToggleButton1.

<toggleButton id="toggleButton1" onAction="OnToggleButton1" />

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

يمكن إعطاء أي إسم للأسلوب الذي تحدده في السمة. ومع ذلك، فإنه يجب أن يطابق إسم الأسلوب الذي تقوم بتعريفه في ملف التعليمات البرمجية للشريط..

توجد عدة أنواع مختلفة من أساليب رد الاتصال التي يمكن أن تقوم بتعيينها لعناصر تحكم الشريط. للحصول على قائمة كاملة لأساليب رد الاتصال المتوفرة لكل عنصر تحكم ،راجع المقالة الفنية تخصيص واجهة المستخدم الشريطية لOffice (2007) للمطورين (جزء 3 من 3) .

تعريف أساليب رد الإتصال

تعريف أساليب رد الاتصال الخاصة بك في فئة الشريط في ملف التعليمات البرمجية للشريط. أسلوب رد الإتصال له عدة متطلبات:

• يجب أن يصرح به على أنه عام.

• يجب أن يطابق اسمه اسم أسلوب رد الاتصال الذي قمت بتعيينه لعنصر تحكم في ملف شريط XML.

• يجب أن يتطابق توقيعه مع توقيع نوع أسلوب رد الاتصال المتوفر لعنصر تحكم الشريط.

للحصول على قائمة كاملة لأساليب رد الاتصال المتوفرة لكل عنصر تحكم ،راجع المقالة الفنية تخصيص واجهة المستخدم الشريطية لOffice (2007) للمطورين (جزء 3 من 3) . Visual Studio لا يوفر دعم IntelliSense لأساليب رد الاتصال التي تقوم بإنشائها في ملف التعليمات البرمجية للشريط. إذا كان أسلوب رد الاتصال الذي قمت بإنشائه غير متطابق مع توقيع صحيح، سيتم تحويل التعليمات البرمجية برمجياً، ولكن لا شيء سيحدث عندما يقوم المستخدم بالنقر فوق عنصر التحكم.

تحتوي كافة أساليب رد الاتصال على معلمة Microsoft.Office.Core.IRibbonControl التي تمثل عنصر التحكم الذي استدعي الأسلوب. يمكنك استخدام هذه المعلمة لإعادة استخدام نفس أسلوب رد الاتصال لعناصر تحكم متعددة. إن المثال التالي للتعليمات البرمجية يوضح أسلوب رد الاتصال onAction الذي يقوم بأداء مهام مختلفة استنادًا إلى عنصر التحكم الذى ينقر المستخدم فوقه.

Public Sub OnActionCallback(ByVal control As Office.IRibbonControl, _
    ByVal isPressed As Boolean)

    If (control.Id = "checkBox1") Then
        MessageBox.Show("You clicked " + control.Id)
    Else
        MessageBox.Show("You clicked a different control.")
    End If

End Sub

public void OnActionCallback(Office.IRibbonControl control, bool isPressed)
{
    if (control.Id == "checkBox1")
    {
        MessageBox.Show("You clicked " + control.Id);
    }
    else
    {
        MessageBox.Show("You clicked a different control.");
    }
}

مرجع ملف شريط XML

يمكنك تعريف الشريط المخصص الخاص بك عن طريق إضافة عناصر و سمات إلى ملف شريط XML. افتراضياً، ملف شريط XML يحتوي على XML التالي.

<?xml version="1.0" encoding="UTF-8"?>
<customUI xmlns="https://schemas.microsoft.com/office/2006/01/customui" onLoad="OnLoad">
  <ribbon>
    <tabs>
      <tab idMso="TabAddIns">
        <group id="MyGroup"
               label="My Group">
        </group>
      </tab>
    </tabs>
  </ribbon>
</customUI>

يصف الجدول التالي العناصر الافتراضية في ملف شريط XML.

العنصر	الوصف
customUI	يمثل الشريط المخصص في مشروع الوظيفة الإضافية.
ribbon	يمثل الشريط.
tabs	يمثل مجموعة من علامات التبويب للشريط.
tab	يمثل علامة تبويب مفردة للشريط.
group	يمثل مجموعة من عناصر التحكم على علامة تبويب الشريط.

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

السمة	العنصر الأصل	الوصف
onLoad	customUI	يحدد أسلوباً يُستدعى عند تحميل التطبيق للشريط.
idMso	tab	يحدد علامة تبويب مضمنة لتعرض في الشريط..
id	group	يعرّف المجموعة.
label	group	يحدد النص الذي يظهر على المجموعة.

إن العناصر و السمات الافتراضية في ملف شريط XML هي مجموعة فرعية صغيرة من العناصر و السمات المتوفرة. للحصول على قائمة كاملة من العناصر و السمات المتوفرة، راجع المقالة الفنية تخصيص واجهة المستخدم الشريطية لOffice (2007) للمطورين (جزء 2 من 3) .

مرجع فئة الشريط

يقوم Visual Studio بإنشاء فئة الشريط في ملف التعليمات البرمجية للشريط. قم بإضافة أساليب رد الاتصال لعناصر التحكم على الشريط إلى هذه الفئة. هذه الفئة تنفذ الواجهة Microsoft.Office.Core.IRibbonExtensibility الجديدة.

يصف الجدول التالي الأساليب الافتراضية في هذه الفئة.

Method	الوصف
GetCustomUI	تقوم بإرجاع محتويات ملف شريط XML. تستدعي تطبيقات Microsoft Office هذا الأسلوب للحصول على سلسلة XML التي تعرّف واجهة المستخدم للشريط المخصص الخاص بك. ملاحظة زر 'Ins' الإضافية التي تم إنشاؤها باستخدام أدوات تطوير المكتب في ‏‫Visual Studio الميزات المعمارية إبراز الاستقرار والأمان، وتمكينهم من العمل عن قرب مع Microsoft المكتب.GetCustomUIعند استخدام أدوات تطوير المكتب في Visual Studio لبنية وظيفة إضافية، تقوم ببنية تجميع التعليمات برمجية مدارة التي تم تحميلها من قبل Microsoft المكتب التطبيق.GetCustomUIوإلا، قد لا يعمل الشريط المخصص بشكل صحيح.إذا كان عليك تشغيل التعليمات البرمجية لتهيئة الوظيفة الاضافية الخاصة بك، أضف التعليمات البرمجية إلي معالج الحدث ThisAddIn_Startup.
OnLoad	يعيّن المعلمة Microsoft.Office.Core.IRibbonControl للحقل ribbon. إن تطبيقات Microsoft Office تقوم باستدعاء هذا الأسلوب عند قيامها بتحميل الشريط المخصص. يمكنك استخدام هذا الحقل لتحديث الشريط المخصص بشكل حيوى. لمزيد من المعلومات، راجع المقالة الفنية تخصيص واجهة المستخدم الشريطية لOffice (2007) للمطورين (Part 1 of 3).
GetResourceText	تستدعي بواسطة أسلوب GetCustomUI للحصول على محتويات ملف شريط XML.

راجع أيضًا:

المهام

الإرشادات التفصيلية: إنشاء الجدول المخصص باستخدام الشريط XML

موارد أخرى

نظرة عامة على الشريط

تخصيص واجهة Office