RibbonLoadImageEventArgs - интерфейс

Статья
05/19/2013

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

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

Синтаксис

'Декларация
<GuidAttribute("faacd97a-39b2-4c40-a1c2-6eec43ce950f")> _
Public Interface RibbonLoadImageEventArgs

[GuidAttribute("faacd97a-39b2-4c40-a1c2-6eec43ce950f")]
public interface RibbonLoadImageEventArgs

Тип RibbonLoadImageEventArgs предоставляет следующие члены.

Свойства

	Имя	Описание
	Image	Возврат или установка загружаемого изображения для элемента управления ленты.
	ImageName	Возврат имени изображения, загружаемого на ленту.

В начало страницы

Заметки

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

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

Примеры

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

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

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

См. также

Ссылки

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

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