RibbonSplitButton.ImageName Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает имя, которое можно использовать в обработчике событий 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, setPublic Property ImageName As StringЗначение свойства
Строка, которую можно использовать в обработчике событий E:Microsoft.Office.Tools.Ribbon.OfficeRibbon.LoadImage для идентификации изображения элемента управления.
Комментарии
Свойство ImageName определяет изображение, отображаемое элементом управления . Приложение Office извлекает этот образ из решения только один раз, чтобы повысить производительность. Это свойство можно задать только во время разработки, так как идентифицирующее изображение загружается во время LoadImage события . LoadImage вызывается только один раз для каждого имени образа при отображении ленты. После этого образ элемента управления нельзя изменить с помощью этого свойства.
Чтобы загрузить изображение, добавьте код в LoadImage обработчик событий. ImageName Проверьте свойство RibbonLoadImageEventArgs объекта и задайте Image для свойства RibbonLoadImageEventArgs объекта изображение, которое требуется загрузить.
Это свойство игнорируется, если Image задано свойство или OfficeImageId свойство . Изображения, определяемые свойством ImageName , загружаются немного быстрее, чем изображения, определенные свойством Image , так как приложение Office извлекает изображение из решения только при первом отображении ленты.