Поделиться через

RibbonBase.LoadImage Событие

  • Ссылка

Определение

Пространство имен:
Microsoft.Office.Tools.Ribbon
Сборка:
Microsoft.Office.Tools.Common.v4.0.Utilities.dll

Возникает при загрузке объекта RibbonBase, если для одного или нескольких элементов управления установлено свойство ImageName.

public:
 event Microsoft::Office::Tools::Ribbon::RibbonLoadImageEventHandler ^ LoadImage;
public event Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventHandler LoadImage;
member this.LoadImage : Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventHandler 
Public Custom Event LoadImage As RibbonLoadImageEventHandler

Тип события

RibbonLoadImageEventHandler

Примеры

В следующем примере изображения кэшируются для двух RibbonButton элементов управления.

Чтобы запустить этот пример кода, необходимо сначала выполнить следующие действия:

  • Добавление ленты (visual Designer) в проект Office.

  • Если вы используете проект Visual Basic, добавьте следующий оператор в начало файла кода ленты: 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;  
    }  
}

Комментарии

Событие LoadImage позволяет кэшировать образы в настройке ленты, что может повысить производительность.

По умолчанию изображение загружается на ленту каждый раз, когда пользователь отображает вкладку с изображением. Изображение перезагружается каждый раз, когда вы программно изменяете свойства элемента управления, на котором отображается изображение.

Используйте событие , LoadImage чтобы назначить изображение элементу управления. Когда пользователь выбирает вкладку на ленте, приложение Microsoft Office использует кэшированное изображение. Если изменить свойство элемента управления во время выполнения, приложение Microsoft Office не перезагрузит изображение элемента управления. Это может привести к небольшому повышению производительности.

Если вы хотите кэшировать изображение элемента управления, задайте свойство ImageName элемента управления . Событие LoadImage не вызывается, если не задано свойство ImageName хотя бы одного элемента управления.

Применяется к