RibbonSplitButton.ImageName Свойство

  • Ссылка

Определение

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

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

public:
 property System::String ^ ImageName { System::String ^ get(); void set(System::String ^ value); };
public string ImageName { get; set; }
member this.ImageName : string with get, set
Public Property ImageName As String

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

String

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

Комментарии

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

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

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

Применяется к