RibbonLoadImageEventArgs Класс (2007 System)

Статья
11/16/2008

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

Предоставляет данные для события LoadImage.

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

Синтаксис

'Декларация
Public NotInheritable Class RibbonLoadImageEventArgs _
    Inherits EventArgs
'Применение
Dim instance As RibbonLoadImageEventArgs

public sealed class RibbonLoadImageEventArgs : EventArgs

Заметки

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

Чтобы загрузить изображение для элемента управления, добавьте соответствующий код в обработчик событий LoadImage. Если значение свойства ImageName объекта RibbonLoadImageEventArgs соответствует значению свойства ImageName элемента управления, присвойте свойству Image изображение, которое необходимо загрузить.

Примеры

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

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

Добавьте элемент Лента (визуальный конструктор) в проект Visual Studio Tools for Office.
Добавьте группу на пользовательскую вкладку.
Добавьте две кнопки в группу.
Добавьте два изображения в ресурсы проекта. Дополнительные сведения см. в разделе Практическое руководство. Добавление или удаление ресурсов.

Private Sub Ribbon1_LoadImage(ByVal sender As Object, _
    ByVal 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;
    }
}

Иерархия наследования

System.Object
System.EventArgs
Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventArgs

Потокобезопасность

Любые открытые члены этого типа, объявленные как static (Shared в Visual Basic), являются потокобезопасными. Потокобезопасность членов экземпляров не гарантируется.

См. также

Ссылки

RibbonLoadImageEventArgs - члены

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

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