RibbonMenu.OfficeImageId Свойство (2007 System)
Обновлен: Ноябрь 2007
Возврат или установка изображения, отображаемого в меню при использовании встроенного значка Microsoft Office.
Пространство имен: Microsoft.Office.Tools.Ribbon
Сборка: Microsoft.Office.Tools.Common.v9.0 (в Microsoft.Office.Tools.Common.v9.0.dll)
Синтаксис
'Декларация
Public Property OfficeImageId As String
'Применение
Dim instance As RibbonMenu
Dim value As String
value = instance.OfficeImageId
instance.OfficeImageId = value
public string OfficeImageId { get; set; }
Значение свойства
Тип: System.String
Идентификатор встроенного значка Microsoft Office, который используется для этого меню.
Заметки
Свойство OfficeImageId определяет значок Office, отображаемый на элементе управления. Значение свойства представляет собой строку, определяющую значение imageMso для выбранного значка. Это свойство можно установить во время разработки или во время выполнения. При изменении значения данного свойства во время выполнения внешний вид элемента управления обновляется в соответствии с изменениями.
Список значений imageMso приведен на странице центра загрузок Майкрософт Надстройка для системы Office 2007: коллекция значков (на английском языке).
Если установлено свойство Image, это свойство игнорируется. Изображения, определяемые свойством OfficeImageId, загружаются несколько быстрее изображений, определяемых свойством Image, поскольку в приложении Office осуществляется их кэширование.
Чтобы отобразить изображение элемента управления, для свойства ShowImage необходимо установить значение true. Если свойство OfficeImageId устанавливается во время разработки, в Visual Studio Tools for Office для свойства ShowImage автоматически устанавливается значение true. Если свойство OfficeImageId устанавливается во время выполнения, в коде необходимо установить для свойства ShowImage значение true.
Примеры
В следующем примере меню назначается значок Microsoft Office.
Перед выполнением этого примера выполните следующие действия:
Добавьте элемент Лента (визуальный конструктор) в проект Visual Studio Tools for Office.
Добавьте группу на пользовательскую вкладку.
Добавьте меню в группу.
Установите для свойства Dynamic меню значение true.
Private Sub SetMenuImage()
Menu1.OfficeImageId = "HighImportance"
Menu1.ShowImage = True
End Sub
private void SetMenuImage()
{
menu1.OfficeImageId = "HighImportance";
menu1.ShowImage = true;
}
Разрешения
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.