RibbonButton.Image Свойство (2007 System)

Статья
11/16/2008

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

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

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

Синтаксис

'Декларация
Public Property Image As Image
'Применение
Dim instance As RibbonButton
Dim value As Image

value = instance.Image

instance.Image = value

public Image Image { get; set; }

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

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

Заметки

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

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

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

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

Примеры

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

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

Private Sub LoadImages()
    button1.ShowImage = True
    CustomerButton.ShowImage = True
    Button1.Image = My.Resources.Image1
    CustomerButton.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;
}

Разрешения

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