RibbonToggleButton.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 RibbonToggleButton
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.

Разрешения

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