RibbonDropDownItem.OfficeImageId 屬性

取得或設定要顯示在 RibbonDropDownItem 上的影像 (如果您想要使用內建 Microsoft Office 圖示的話)。

命名空間：  Microsoft.Office.Tools.Ribbon
組件：  Microsoft.Office.Tools.Common (在 Microsoft.Office.Tools.Common.dll 中)

語法

string OfficeImageId { get; set; }

屬性值

型別：System.String
要顯示在 RibbonDropDownItem 上的影像 (如果您想要使用內建 Microsoft Office 圖示的話)。

備註

OfficeImageId 屬性可以識別控制項所顯示的 Office 圖示。 屬性值是一個字串，會識別所選取項目的 imageMso 值。 這個屬性可以在設計階段或執行階段設定。 如果您在執行階段更新這個屬性，則控制項的外觀會更新以反應變更。

如需 imageMso 值的清單，請參閱 Microsoft 下載中心網頁 Office 2010 增益集:圖示繪製廊。

如果 Image 屬性已設定，則會忽略這個屬性。 因為會在 Office 應用程式中快取影像，所以載入 OfficeImageId 屬性識別的影像時，可能會比載入 Image 屬性識別的影像稍微快一些。

範例

下列範例會將 Microsoft Office 圖示指派給下拉式方塊中的兩個項目。

若要執行這個程式碼範例，您必須先執行下列步驟：

1. 將 [功能區 (視覺化設計工具)] 項目加入至在 Visual Studio 中使用 Office 開發工具建立的專案。

2. 將群組加入至自訂索引標籤。

3. 將下拉式方塊加入至群組。

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

.NET Framework 安全性

• 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。

請參閱

參考

RibbonDropDownItem 介面

Microsoft.Office.Tools.Ribbon 命名空間

其他資源

功能區物件模型概觀