RibbonDropDownItem.OfficeImageId 屬性

  • 發行項

取得或設定要顯示在 RibbonDropDownItem 上的影像 (如果您想要使用內建 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
要顯示在 RibbonDropDownItem 上的影像 (如果您想要使用內建 Microsoft Office 圖示的話)。

備註

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

如需 imageMso 值的清單，請參閱 Microsoft 下載中心頁面的 Office 2010 增益集: 圖示庫 (英文)。

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

範例

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

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

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

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

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

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

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 命名空間

其他資源

功能區物件模型概觀