RibbonButton الواجهة

مقالة
09/21/2010

يمثل زر على "شريط" مخصصة.

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

بناء الجملة

'إقرار
<GuidAttribute("b57e6217-33f2-46bf-9625-c313526de60c")> _
Public Interface RibbonButton _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable

[GuidAttribute("b57e6217-33f2-46bf-9625-c313526de60c")]
public interface RibbonButton : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

ملاحظات

‏‫Visual Studio بإنشاء مثيل لفئة تطبيق RibbonButtonالواجهة عند يسحب زر عنصر تحكم من علامة تبويب "شريط" المكتب عنصر تحكم s من مربع أدوات التحكم إلى "مصمم" شريط ".

يمكنك أيضا إنشاء مثيل لعنصر التحكم هذا في وقت التشغيل و إضافة إلى قائمة حيوية. قائمة هو حيوي إذا قمت بتعيين به Dynamicخاصية إلى true.

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

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

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

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

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

يسرد الجدول التالي الأعضاء مفيدة للمهام عام.

المهمة	العضو
في وقت التنفيذ، إضافة زر لقائمة التي قام بها Dynamicتعيين خاصية إلى صواب.	إنشاء مثيل لفئة تطبيق RibbonButtonالواجهة باستخدامCreateRibbonButton أسلوب RibbonFactoryفئة. لمزيد من المعلومات، راجع العمومية الوصول إلى كائنات في مشاريع Office. إضافة المثيل قائمة Itemsمجموعة.
تغيير الالحجم زر.	التعيين ControlSizeإلى القيمة التي يريد. على سبيل المثال، لكبير زر، قم بتعيينه إلى Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge.
عرض نسخة تشغيل زر.	توجد ثلاث طرق إلى عرض نسخة: استخدم الخاصية Image. تتيح هذه خاصية الأكثر عنصر تحكم. تعيين OfficeImageIdلمعرف صورة Microsoft المكتب 2010 Suite المضمن الذي تريد عرض كـه كالرمز زر. استخدم ImageNameخاصية مع LoadImageحدث. تتيح هذه خاصية بعض مزايا الأداء.
يعطل أو إخفاء الأزرار.	لتعطيل زر، التعيين Enabledإلى false. لإخفاء زر، التعيين Visibleإلى false.
قم بتشغيل تعليمات برمجية عند قيام مستخدم بالنقر فوق زر.	إضافة التعليمة البرمجية إلى Clickمعالج الحدث.

ملاحظة

يتم تطبيق هذه الواجهة بواسطة 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) إلى مشروع تم إنشاؤه باستخدام أدوات تطوير المكتب في ‏‫Visual Studio.
إضافة مجموعة إلى علامة تبويب مخصص.
إضافة قائمة إلى مجموعة.
التعيين خاصية قائمة إلى الحيوي true.
التعيين ItemSize خاصية قائمة إلى من RibbonControlSizeLarge.

Private Sub AddButtonsToMenu()
    Dim tempButton = Me.Factory.CreateRibbonButton()
    tempButton.Label = "Button 1"
    tempButton.ControlSize = _
        Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge
    tempButton.Description = "My Ribbon Button"
    tempButton.ShowImage = True
    tempButton.ShowImage = True
    tempButton.Image = My.Resources.Image1
    tempButton.Image = My.Resources.Image2
    tempButton.KeyTip = "A1"
    menu1.Items.Add(tempButton)
End Sub

private void AddButtonsToMenu()
{
    RibbonButton tempButton = this.Factory.CreateRibbonButton();
    tempButton.Label = "Button 1";
    tempButton.ControlSize =
        Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge;
    tempButton.Description = "My Ribbon Button";
    tempButton.ShowImage = true;
    tempButton.ShowImage = true;
    tempButton.Image = Properties.Resources.Image1;
    tempButton.Image = Properties.Resources.Image2;
    tempButton.KeyTip = "A1";
    menu1.Items.Add(tempButton);

}