مشاركة عبر

RibbonBase.LoadImage الحدث

  • مقالة

يحدث عند RibbonBaseتحميل، إذا كان ImageName خاصية هو تعيينها لعنصر تحكم واحد أو أكثر.

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

بناء الجملة

'إقرار
Public Event LoadImage As RibbonLoadImageEventHandler

public event RibbonLoadImageEventHandler LoadImage

ملاحظات

LoadImageيمكنك أحداث من ذاكرة تخزين مؤقت للصور في التخصيص "شريط"، مما يؤدي إلى تحسين الأداء.

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

استخدام LoadImageحدث لتعيين نسخة عنصر تحكم. عندما يقوم مستخدم بتحديد علامة تبويب تشغيل شريط Microsoft المكتب تطبيق باستخدام الصورة المخزنة مؤقتاً. إذا قمت بتعديل خاصية عنصر تحكم أثناء وقت التشغيل، Microsoft المكتب لا يقوم تطبيق إعادة تحميل الصورة الموجودة في عنصر التحكم. هذا يمكن أن توفر لك الربح أداء صغيرة.

إذا كنت تريد إلى ذاكرة التخزين المؤقت الخاصة بعنصر تحكم الصورة، قم بتعيين ImageName خاصية عنصر التحكم. LoadImageحدث هو لا raهوed إلا إذا قمت بتعيين ImageName خاصية عنصر تحكم واحد على الأقل.

أمثلة

المثال التالي تقوم بتخزين الصور لجهازي RibbonButtonعناصر التحكم.

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

  • إضافة شريط (مصمم Visual Basic) إلى مشروع المكتب.

  • إذا كنت تستخدم مشروع Visual أساسى، إضافة العبارة التالية إلى أعلى "شريط" ‏‏رمز الملف: Imports Microsoft.Office.Tools.Ribbon

يمكنك ثم تشغيل هذه تعليمات برمجية في فئة "شريط" الذي تم إنشاؤه.

Private Sub Ribbon1_LoadImage(sender As Object, e As RibbonLoadImageEventArgs)
   Select Case e.ImageName
      Case "Button1Image"
         e.Image = My.Resources.Image1
      Case "Button2Image"
         e.Image = My.Resources.Image2
   End Select
End Sub

private void Ribbon1_LoadImage(object sender, RibbonLoadImageEventArgs e)
{
    switch (e.ImageName)
    {
        case "Button1Image":
            e.Image = Properties.Resources.Image1;
            break;
        case "Button2Image":
            e.Image = Properties.Resources.Image2;
            break;
    }
}

أمن NET Framework.

راجع أيضًَا

المرجع

RibbonBase الفئة

RibbonBase الأعضاء

Microsoft.Office.Tools.Ribbon مساحة الاسم