共用方式為

RibbonButton.OfficeImageId 屬性

  • 發行項

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

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

語法

'宣告
Property OfficeImageId As String
    Get
    Set

string OfficeImageId { get; set; }

屬性值

型別：System.String
內建之 Microsoft Office 圖示 (做為此控制項的圖示) 的 ID。

備註

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

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

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

其他資源

功能區物件模型概觀