RibbonBase.LoadImage - событие

Статья
08/11/2011

Вызывается при загрузке объекта 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 позволяет повысить производительность за счет кэширования изображений в настройке ленты.

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

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

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

Примеры

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

Перед выполнением этого примера выполните следующие действия:

Добавьте элемент Лента (визуальный конструктор) в проект 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;
    }
}

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

RibbonBase Класс

Microsoft.Office.Tools.Ribbon - пространство имен

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