RibbonGallery.OfficeImageId - свойство

Статья
05/19/2013

Возврат или установка изображения, отображаемого на элементе управления при использовании встроенного значка Microsoft Office.

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

Синтаксис

'Декларация
Property OfficeImageId As String

string OfficeImageId { get; set; }

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

Тип: System.String
Идентификатор встроенного значка Microsoft Office, который используется для этого элемента управления.

Заметки

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

Список значений imageMso см. на странице центра загрузки Майкрософт Надстройка Office 2010. Коллекция Значков.

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

Чтобы отобразить изображение элемента управления, для свойства ShowImage необходимо установить значение true.При установке свойства OfficeImageId во время разработки Visual Studio автоматически задает для свойства ShowImage значение true.Если свойство OfficeImageId устанавливается во время выполнения, в коде необходимо установить для свойства ShowImage значение true.

Примеры

В следующем примере двум элементам в галерее назначаются значки Microsoft Office.

Перед выполнением этого примера выполните следующие действия:

Добавьте элемент Лента (визуальный конструктор) в проект, созданный с использованием шаблонов проектов Office в Visual Studio.
Добавьте группу на пользовательскую вкладку.
Добавьте галерею в группу.

Private Sub SetGalleryImage()
    Gallery1.OfficeImageId = "PersonaStatusOnline"
    Gallery1.ShowImage = True
End Sub

private void SetGalleryImage()
{
    gallery1.OfficeImageId = "PersonaStatusOnline";
    gallery1.ShowImage = true;
}

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.