RibbonDropDownItem.OfficeImageId Свойство (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

Возврат или установка изображения, отображаемого на объекте RibbonDropDownItem при использовании встроенного значка 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 RibbonDropDownItem
Dim value As String

value = instance.OfficeImageId

instance.OfficeImageId = value

public string OfficeImageId { get; set; }

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

Тип: System.String
Изображение, отображаемое на объекте RibbonDropDownItem при использовании встроенного значка Microsoft Office.

Заметки

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

Список значений imageMso приведен на странице центра загрузок Майкрософт Надстройка для системы Office 2007: коллекция значков (на английском языке).

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

Примеры

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

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

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

Private Sub PopulateDropDown()
    Dim status1 As RibbonDropDownItem = New RibbonDropDownItem
    status1.Label = "Away"
    status1.OfficeImageId = "PersonaStatusAway"
    DropDown1.Items.Add(status1)
    Dim status2 As RibbonDropDownItem = New RibbonDropDownItem
    status2.Label = "Online"
    status2.OfficeImageId = "PersonaStatusOnline"
    DropDown1.Items.Add(status2)
End Sub

private void PopulateDropDown()
{
    RibbonDropDownItem status1 = new RibbonDropDownItem();
    status1.Label = "Away";
    status1.OfficeImageId = "PersonaStatusAway";
    dropDown1.Items.Add(status1);
    RibbonDropDownItem status2 = new RibbonDropDownItem();
    status2.Label = "Online";
    status2.OfficeImageId = "PersonaStatusOnline";
    dropDown1.Items.Add(status2);
}

Разрешения

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