OfficeRibbon.LoadImage Событие (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

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

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

Синтаксис

'Декларация
<RibbonEventAttribute("loadImage")> _
Public Event LoadImage As EventHandler(Of RibbonLoadImageEventArgs)
'Применение
Dim instance As OfficeRibbon
Dim handler As EventHandler(Of RibbonLoadImageEventArgs)

AddHandler instance.LoadImage, handler

[RibbonEventAttribute("loadImage")]
public event EventHandler<RibbonLoadImageEventArgs> LoadImage

Заметки

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

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

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

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

Примеры

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

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

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

Разрешения

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

См. также

Ссылки

OfficeRibbon Класс

OfficeRibbon - члены

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

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