共用方式為

RibbonButton.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. 將 [功能區 (視覺化設計工具)] 項目加入至在 Visual Studio 中使用 Office 開發工具建立的專案。

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

  3. 將按鈕加入至群組。

  4. 將按鈕的 [(Name)] 屬性設定為 mySaveButton。

Private Sub SetButtonImage()
    mySaveButton.OfficeImageId = "FileSave"
    mySaveButton.ShowImage = True
End Sub

private void SetButtonImage()
{
    mySaveButton.OfficeImageId = "FileSave";
    mySaveButton.ShowImage = true;
}

.NET Framework 安全性

請參閱

參考

RibbonButton 介面

Microsoft.Office.Tools.Ribbon 命名空間

其他資源

功能區物件模型概觀