RibbonButton.Image 屬性

發行項
08/12/2011

取得或設定顯示在按鈕上的影像。

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

語法

'宣告
Property Image As Image
    Get
    Set

Image Image { get; set; }

屬性值

型別：System.Drawing.Image
顯示在按鈕上的 Image。

備註

建議的影像格式為 PNG，因為 PNG 格式的影像會透過 Alpha 色頻 (Alpha Channel) 支援透明度。

Image 屬性可以識別控制項顯示的影像。這個屬性可以在設計階段或執行階段設定。如果您在執行階段更新這個屬性，則控制項的外觀會更新以反應變更。

如果 Image 屬性已設定，則會忽略 OfficeImageId 和 ImageName 屬性。雖然 Image 屬性較另外兩個屬性提供更多的控制能力，但是每當控制項更新時，它就會將影像物件傳送至 Office 應用程式，因此可能比較慢。

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

範例

下列範例會設定兩個按鈕的 Image 屬性。若要執行這個程式碼範例，您必須先執行下列步驟：

將 [功能區 (視覺化設計工具)] 項目加入至在 Visual Studio 中使用 Office 開發工具建立的專案。
將群組加入至自訂索引標籤。
將兩個按鈕加入至群組。
將兩個影像加入至專案資源。如需詳細資訊，請參閱HOW TO：加入或移除資源。

Private Sub LoadImages()
    button1.ShowImage = True
    Button2.ShowImage = True
    Button1.Image = My.Resources.Image1
    Button2.Image = My.Resources.Image2
End Sub

private void LoadImages()
{
    button1.ShowImage = true;
    button2.ShowImage = true;
    button1.Image = Properties.Resources.Image1;
    button2.Image = Properties.Resources.Image2;
}