RibbonMenu الواجهة

مقالة
09/21/2010

تمثل قائمة على علامة تبويب "شريط" أو على قائمة Microsoft المكتب.

مساحة الاسم: Microsoft.Office.Tools.Ribbon
التجميع: Microsoft.Office.Tools.Common (في Microsoft.Office.Tools.Common.dll)

بناء الجملة

'إقرار
<GuidAttribute("59dc7f42-aca2-484a-9622-1ee34a6cfd7d")> _
Public Interface RibbonMenu _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable

[GuidAttribute("59dc7f42-aca2-484a-9622-1ee34a6cfd7d")]
public interface RibbonMenu : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

ملاحظات

ينشئ ‏‫Visual Studio RibbonMenuكائن عند يسحب قائمة عنصر تحكم من علامة تبويب "شريط" المكتب عنصر تحكم s من مربع أدوات التحكم إلى "مصمم" شريط ".

يمكنك إنشاء RibbonMenuفي وقت التشغيل بواسطة استخدام CreateRibbonMenuأسلوب RibbonFactoryالكائن.

هناك طريقتان للوصول إلى الكائن RibbonFactory :

باستخدام الخاصية Factory الخاصة بفئة الشريط استخدم هذه الطريقة من التعليمات البرمجية في فئة الشريط الخاصة بك .
باستخدام أسلوب Globals.Factory.GetRibbonFactory. استخدم هذه الطريقة من لتعليمات البرمجية خارج فئة الشريط الخاصة بك .

المهام الشائعة

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

المهمة	العضو
عرض نسخة تشغيل قائمة.	استخدم Imageأو ImageNameخاصية. يمكنك أيضا إعادة استخدام الصور التي تظهر في عناصر التحكم المضمنة للشريط. للقيام بذلك، قم بتعيين OfficeImageIdلمعرف مضمن Microsoft المكتب النسخة التي تريد عرض كـها كرمز قائمة.
تغيير الحجم قائمة.	التعيين ControlSizeخاصية إلى القيمة التي يريد. ل مثال، بالنسبة لقائمة قطر أيمن متوسط، بتعيين إلى Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge.
قم بتغيير الحجم عناصر في قائمة.	التعيين ItemSizeخاصية إلى القيمة التي يريد. ل مثال، لعرض أكبر عناصر، قم بتعيين إلى Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge.
تمكين تغييرات إلى قائمة في وقت التشغيل (على سبيل المثال، لتمكين عناصر التحكم المراد إضافتها إلى قائمة في وقت التشغيل).	قم بتعيين خاصية Dynamic إلى true(صواب).
الوصول إلى عناصر التحكم في قائمة إضافة عناصر إلى قائمة أو قم بإزالة عناصر التحكم من قائمة.	استخدم الخاصية Items.
إضافة قائمة إلى قائمة Microsoft المكتب في مجموعة، أو إلى عنصر تحكم آخر يحتوي على قوائم.	إضافة RibbonMenuإلى Itemsخاصية Microsoft المكتب قائمة أو مجموعة، أو عنصر التحكم.

ملاحظة

يتم تطبيق هذه الواجهة بواسطة Visual Studio Tools لوقت تشغيل Office. ولم يتم تصميمها لتطبيقها في التعليمة البرمجية الخاصة بك. لمزيد من المعلومات، راجع أدوات Visual Studio نظرة عامة وقت تشغيل Office.

الاستخدام

توضح هذه الوثائق الإصدار الخاص بهذا النوع المستخدم في مشاريع Office والذي يستهدف .NET Framework 4. وفي المشاريع التي تستهدف .NET Framework 3.5، قد يكون لدى هذا النوع أعضاء مختلفون وقد لا تعمل نماذج التعليمات البرمجية الخاصة بهذا النوع. للحصول على وثائق حول هذا النوع في المشاريع التي تستهدف .NET Framework 3.5، اطلع على جزء المرجع التالي في وثائق Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

أمثلة

يوضح المثال التالي كيفية إضافة و يملأ قائمة فرعية إلى قائمة موجودة وقت التشغيل.

على سبيل مثال غنى بتحديث عناصر التحكم أثناء وقت التشغيل و يشتمل على بيانات من قاعدة بيانات نموذج AdventureWorks استخدام اللغة-Integrated استعلامات (LINQ)، راجع الإرشادات التفصيلية: تحديث عناصر التحكم على شريط في وقت التشغيل.

إلى تشغيل هذا المثال تعليمات برمجية، يجب أولاً إجراء الخطوات التالية:

إضافة أحد عناصر "شريط" (مصمم Visual Basic) لمشروع المكتب.
إضافة مجموعة إلى علامة تبويب مخصص.
إضافة قائمة إلى مجموعة.
التعيين (الاسم) خاصية قائمة إلى من CustomerMenu.
التعيين التسمية خاصية قائمة للعملاء.
التعيين خاصية قائمة إلى الحيوي true.

يمكّنك هذا من إضافة وإزالة عناصر التحكم من القائمة في وقت التشغيل بعد تحميل الشريط إلى تطبيق Office.

Private Sub PopulateCustomerMenu()
    ' Add two sub-menus to EmployeeMenu and populate each sub-menu
    ' First sub-menu
    Dim subMenu1 As RibbonMenu = Me.Factory.CreateRibbonMenu()
    subMenu1.Dynamic = True
    subMenu1.Label = "A - M"
    subMenu1.Items.Add(Me.Factory.CreateRibbonToggleButton())
    CType(subMenu1.Items.Last(), RibbonToggleButton).Label = "Hall, Don"
    subMenu1.Items.Add(Me.Factory.CreateRibbonToggleButton())
    CType(subMenu1.Items.Last(), RibbonToggleButton).Label = "Valdez, Rachel"
    CustomerMenu.Items.Add(subMenu1)

    ' Second sub-menu
    Dim subMenu2 As RibbonMenu = Me.Factory.CreateRibbonMenu()
    subMenu2.Dynamic = True
    subMenu2.Label = "N - Z"
    subMenu2.Items.Add(Me.Factory.CreateRibbonToggleButton())
    CType(subMenu2.Items.Last(), RibbonToggleButton).Label = "Robinson, Alex"
    CustomerMenu.Items.Add(subMenu2)

End Sub

private void PopulateCustomerMenu()
{
    // Add two sub-menus to EmployeeMenu and populate each sub-menu
    // First sub-menu
    RibbonMenu subMenu1 = this.Factory.CreateRibbonMenu();
    subMenu1.Dynamic = true;
    subMenu1.Label = "A - M";
    subMenu1.Items.Add(this.Factory.CreateRibbonToggleButton());
    ((RibbonToggleButton)subMenu1.Items.Last()).Label = "Hall, Don";
    subMenu1.Items.Add(this.Factory.CreateRibbonToggleButton());
    ((RibbonToggleButton)subMenu1.Items.Last()).Label = "Valdez, Rachel";
    CustomerMenu.Items.Add(subMenu1);

    // Second sub-menu
    RibbonMenu subMenu2 = this.Factory.CreateRibbonMenu();
    subMenu2.Dynamic = true;
    subMenu2.Label = "N - Z";
    subMenu2.Items.Add(this.Factory.CreateRibbonToggleButton());
    ((RibbonToggleButton)subMenu2.Items.Last()).Label = "Robinson, Alex";
    CustomerMenu.Items.Add(subMenu2);
}