RibbonGallery الواجهة

مقالة
09/21/2010

يمثل عنصر تحكم يعرض قائمة من RibbonDropDownItemالكائنات و RibbonButtonعناصر التحكم.

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

بناء الجملة

'إقرار
<GuidAttribute("c1cff037-81e7-44a0-8f9d-150237dfd312")> _
Public Interface RibbonGallery _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable

[GuidAttribute("c1cff037-81e7-44a0-8f9d-150237dfd312")]
public interface RibbonGallery : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

ملاحظات

في RibbonDropDownالواجهة، RibbonGalleryيعرض قائمة من RibbonDropDownItemالكائنات و RibbonButtonعناصر التحكم.

عكس RibbonDropDownواجهة، RibbonGalleryيرفع واجهة Clickالأحداث، بدلاً من SelectionChangedالأحداث، وعند قيام مستخدم بالنقر فوق RibbonDropDownItem. Th هو يعني، على سبيل المثال، Clickحدث هو raهوed مرتين عند قيام مستخدم بالنقر فوق نفس RibbonDropDownItemمرتين. ( SelectionChangedحدث هل يمكن رفع مرة واحدة تشغيل الأكثر عندما تم إجراء تحديد الأولى للسيناريو نفسه تشغيل RibbonDropDown، حسب تشغيل ما تم تحديد قبل النقر أولاً.)

ShowItemSelectionخاصية عناصر التحكم ما إذا كان المحدد حاليا RibbonDropDownItemالتمييز ما بين هو بصريا تقسيمها من العناصر غير محددة. واحد العنصر في نفس وقت يمكن محددها في RibbonGallery.

ItemImageSizeيمكن استخدام الخاصية إلى تحديد أحجام الصور غير 16 × 16 و 32 × 32.

إلى إضافة الكائنات RibbonDropDownItem في وقت التصميم

انقر فوق خاصية عناصر في خصائص نافذة.
انقر فوق علامة القطع ( ... ).
في محرر مجموعة منسدلة، إضافة، وطلب، و تحرير عناصر جديدة.

يمكنك إضافة RibbonButtonعناصر التحكم إلى RibbonGalleryفي وقت التصميم.

إلى إضافة RibbonButإلىn عناصر تحكم وقت التصميم

انقر فوق خاصية الأزرار في الإطار خصائص.
انقر فوق علامة القطع ( ... ).
في زر مجموعة محرر ، قم بإضافة طلب وتحرير جديدة زر عناصر التحكم.

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

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

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

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

ملاحظة

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