RibbonEditBox.ImageName Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает имя, определяющее изображение в обработчике событий LoadImage.
public string ImageName { get; set; }
Значение свойства
Строка, определяющая изображение в обработчике событий LoadImage.
Комментарии
Это свойство может быть задано во время выполнения только при определенных условиях. Дополнительные сведения см. в разделе Общие сведения об объектной модели ленты.
ImageNameСвойство определяет изображение, отображаемое элементом управления. Приложение Office извлекает это изображение из решения только один раз, чтобы повысить производительность. Это свойство можно задать только во время разработки, так как определяемое им изображение загружается во время LoadImage события. LoadImageвызывается только один раз для каждого имени образа, когда отображается лента. После этого изображение элемента управления не может быть изменено с помощью этого свойства.
Чтобы загрузить изображение, добавьте код в LoadImage обработчик событий. Проверьте ImageName свойство RibbonLoadImageEventArgs и задайте Image RibbonLoadImageEventArgs для свойства объекта изображение, которое требуется загрузить.
Это свойство пропускается, если свойство Image или свойство OfficeImageId задано. Изображения, идентифицируемые ImageName свойством, могут загружаться немного быстрее, чем изображения Image , определяемые свойством, так как приложение Office извлекает изображение из решения только при первом отображении ленты.
ShowImageСвойство должно иметь значение true , чтобы элемент управления отображал изображение. При установке ImageName Свойства во время разработки Visual Studio автоматически задает ShowImage для свойства значение true . Если свойство задается ImageName во время выполнения, необходимо задать ShowImage для свойства значение true в коде.