RibbonButton.Image - свойство

Статья
05/19/2013

Возврат или установка изображения, отображаемого на кнопке.

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

Синтаксис

'Декларация
Property Image As Image

Image Image { get; set; }

Значение свойства

Тип: System.Drawing.Image
Объект Image, отображаемый на кнопке.

Заметки

Рекомендуется использовать изображения в формате PNG, поскольку для них поддерживается реализация прозрачности с использованием альфа-канала.

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

Если установлено свойство Image, свойства OfficeImageId и ImageName игнорируются.Свойство Image обеспечивает расширенные возможности управления по сравнению с двумя другими свойствами. Однако при его использовании возможно снижение производительности, поскольку при каждом обновлении элемента управления выполняется передача изображения в приложение Office.

Чтобы отобразить изображение элемента управления, для свойства ShowImage необходимо установить значение true.При установке свойства Image во время разработки Visual Studio автоматически задает для свойства ShowImage значение true.Если свойство Image устанавливается во время выполнения, в коде необходимо присвоить свойству ShowImage значение true.

Примеры

В следующем примере задается свойство Image для двух кнопок.Перед выполнением этого примера выполните следующие действия:

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

Private Sub LoadImages()
    button1.ShowImage = True
    Button2.ShowImage = True
    Button1.Image = My.Resources.Image1
    Button2.Image = My.Resources.Image2
End Sub

private void LoadImages()
{
    button1.ShowImage = true;
    button2.ShowImage = true;
    button1.Image = Properties.Resources.Image1;
    button2.Image = Properties.Resources.Image2;
}

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

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