共用方式為

RibbonMenu.OfficeImageId 屬性

  • 發行項

取得或設定要顯示在功能表上的影像 (如果您想要使用內建 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 圖示 (做為此功能表的圖示) 的 ID。

備註

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

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

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

ShowImage 屬性必須為 true，控制項才能顯示影像。當您在設計階段設定 OfficeImageId 屬性時，Visual Studio 會自動將 ShowImage 屬性設定為 true。如果是在執行階段設定 OfficeImageId 屬性，您必須在程式碼中，將 ShowImage 屬性設定為 true。

範例

下列範例會將 Microsoft Office 圖示指派給功能表。

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

  1. 將 功能區 (視覺化設計工具) 項目加入至 Office 專案。

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

  3. 將功能表加入至群組。

  4. 將功能表的 [Dynamic] 屬性設定為 true。

Private Sub SetMenuImage()
    Menu1.OfficeImageId = "HighImportance"
    Menu1.ShowImage = True
End Sub

private void SetMenuImage()
{
    menu1.OfficeImageId = "HighImportance";
    menu1.ShowImage = true;
}

.NET Framework 安全性

請參閱

參考

RibbonMenu 介面

Microsoft.Office.Tools.Ribbon 命名空間