RibbonDialogLauncher.ImageName - свойство
Возврат или установка идентификатора, который используется для присваивания изображения объекту RibbonDialogLauncher при его добавлении на панель быстрого доступа.
Пространство имен: Microsoft.Office.Tools.Ribbon
Сборка: Microsoft.Office.Tools.Common (в Microsoft.Office.Tools.Common.dll)
Синтаксис
'Декларация
Property ImageName As String
string ImageName { get; set; }
Значение свойства
Тип: System.String
Идентификатор, который используется для присваивания изображения объекту RibbonDialogLauncher при его добавлении на панель быстрого доступа.
Заметки
Во время выполнения это свойство можно установить только при определенных условиях.Для получения дополнительной информации см. Общие сведения об объектной модели ленты.
Свойство ImageName не имеет видимого действия, если на группе ленты отображается объект RibbonDialogLauncher.Однако при добавлении объекта RibbonDialogLauncher на панель быстрого доступа это свойство определяет поведение отображаемого изображения (если одновременно с ним не установлено свойство Image или OfficeImageId).
Свойство ImageName определяет изображение, отображаемое на элементе управления.В целях повышения производительности в приложении Office это изображение извлекается из решения только один раз.Это свойство можно установить только во время разработки, так как идентифицируемое им изображение загружается в ходе события LoadImage.Событие LoadImage вызывается только один раз для каждого имени изображения при отображении ленты.После этого изменение изображения элемента управления с помощью данного свойства невозможно.
Чтобы загрузить изображение, добавьте соответствующий код в обработчик событий LoadImage.Проверьте значение свойства ImageName объекта RibbonLoadImageEventArgs и присвойте свойству Image объекта RibbonLoadImageEventArgs изображение, которое требуется загрузить.
Если установлено свойство Image или OfficeImageId, это свойство игнорируется.Изображения, определяемые свойством ImageName, загружаются несколько быстрее изображений, определяемых свойством Image, поскольку загрузка изображения из решения в приложение Office выполняется только при первом отображении ленты.
Безопасность платформы .NET Framework
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.
См. также
Ссылки
RibbonDialogLauncher Интерфейс
Microsoft.Office.Tools.Ribbon - пространство имен