RibbonGallery.OfficeImageId Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает изображение, отображаемое на элементе управления при использовании встроенного значка Microsoft Office.
public string OfficeImageId { get; set; }
Значение свойства
Идентификатор встроенного значка Microsoft Office, который используется для этого элемента управления.
Примеры
Следующий пример назначает значки Microsoft Office двум элементам в элементе управления галереи.
Чтобы запустить этот пример кода, необходимо сначала выполнить следующие действия.
Добавьте элемент Лента (визуальный конструктор) в проект, созданный с помощью шаблонов проектов Office в Visual Studio.
Добавьте группу на настраиваемую вкладку.
Добавьте коллекцию в группу.
private void SetGalleryImage()
{
gallery1.OfficeImageId = "PersonaStatusOnline";
gallery1.ShowImage = true;
}
Private Sub SetGalleryImage()
Gallery1.OfficeImageId = "PersonaStatusOnline"
Gallery1.ShowImage = True
End Sub
Комментарии
OfficeImageIdСвойство определяет значок Office, отображаемый элементом управления. Значение свойства — это строка, которая определяет imageMso значение выбранного значка. Это свойство можно задать во время разработки или во время выполнения. При обновлении этого свойства во время выполнения внешний вид элемента управления обновляется в соответствии с изменением.
Список imageMso значений см. на странице центра загрузки Майкрософт надстройка Office 2010: коллекция значков.
Это свойство игнорируется, если Image свойство задано. Изображения, идентифицируемые OfficeImageId свойством, могут загружаться немного быстрее, чем изображения Image , определяемые свойством, так как изображения кэшируются в приложении Office.
ShowImageСвойство должно иметь значение true , чтобы элемент управления отображал изображение. При установке OfficeImageId Свойства во время разработки Visual Studio автоматически задает ShowImage для свойства значение true . Если свойство задается OfficeImageId во время выполнения, необходимо задать ShowImage для свойства значение true в коде.