RibbonSplitButton.ImageName Свойство (2007 System)

Статья
11/16/2008

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

Возврат или установка имени, определяющего изображение элемента управления в обработчике событий E:Microsoft.Office.Tools.Ribbon.LoadImage.

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

Синтаксис

'Декларация
Public Property ImageName As String
'Применение
Dim instance As RibbonSplitButton
Dim value As String

value = instance.ImageName

instance.ImageName = value

public string ImageName { get; set; }

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

Тип: System.String
Строка, определяющая изображение элемента управления в обработчике событий E:Microsoft.Office.Tools.Ribbon.OfficeRibbon.LoadImage.

Заметки

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

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

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

Разрешения

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