RibbonOfficeMenu الواجهة

مقالة
09/21/2010

يوفر الوصول إلى عناصر التحكم التي تقوم بإضافتها إلى "قائمة Microsoft المكتب 2010 Suite".

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

بناء الجملة

'إقرار
<GuidAttribute("49cea6a9-3670-4ae0-9a36-9305e27f302b")> _
Public Interface RibbonOfficeMenu _
    Inherits RibbonComponent, IComponent, IDisposable

[GuidAttribute("49cea6a9-3670-4ae0-9a36-9305e27f302b")]
public interface RibbonOfficeMenu : RibbonComponent, 
    IComponent, IDisposable

ملاحظات

عند إضافة عنصر شريط (مصمم Visual Basic) إلى مشروع الخاص بك، يقوم ‏‫Visual Studio تلقائياً بتعيين جديد RibbonOfficeMenuكائن OfficeMenuخاصية تم إنشاؤه OfficeRibbonالواجهة. استخدام هذا الكائن لإضافة عناصر جديدة إلى قائمة Microsoft المكتب في وقت التشغيل، أو لعناصر التحكم في الوصول التي قمت بإضافتها إلى قائمة Microsoft المكتب.

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

ملاحظة

يتم تطبيق هذه الواجهة بواسطة 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.

أمثلة

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

إضافة أحد عناصر "شريط" (مصمم Visual Basic) لمشروع المكتب.
إضافة زر إلى زر Microsoft المكتب.
قم بتعيين خاصية (اسم) من زر إلى myOfficeMenu زر .
PositionType خاصية تعيين إلى AfterOfficeID تحت خاصية الموضع.
OfficeID خاصية تعيين إلى FilePrintMenu تحت خاصية الموضع.

Private Sub ListOfficeRibbonCustomControls()
    System.Windows.Forms.MessageBox.Show( _
            "Listing all Office Menu custom controls...")
    For Each control As RibbonComponent In Globals.Ribbons.Ribbon1.OfficeMenu.Items
        System.Windows.Forms.MessageBox.Show("Control name: " + control.Name)
    Next
End Sub

private void ListOfficeRibbonCustomControls()
{
    System.Windows.Forms.MessageBox.Show(
        "Listing all Office Menu custom controls...");
    foreach (RibbonComponent control in Globals.Ribbons.Ribbon1.OfficeMenu.Items)
    {
        System.Windows.Forms.MessageBox.Show("Control name: " + control.Name);
    }
}