RibbonToggleButton.OfficeImageId 屬性

取得或設定要顯示在 RibbonToggleButton 上的影像 (如果您想要使用內建 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 下載中心網頁 2010 Office 系統增益集:圖示繪製廊。

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

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

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

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

Private Sub SetToggleButtonImage()
    ToggleButton1.OfficeImageId = "PersonaStatusOnline"
    ToggleButton1.ShowImage = True
End Sub

private void SetToggleButtonImage()
{
    toggleButton1.OfficeImageId = "PersonaStatusOnline";
    toggleButton1.ShowImage = true;
}