RibbonButton 類別 (2007 系統)

發行項
08/21/2008

更新：2007 年 11 月

表示自訂功能區上的按鈕。

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

語法

<ToolboxBitmapAttribute(GetType(RibbonButton), "RibbonButton.bmp")> _
Public NotInheritable Class RibbonButton _
    Inherits RibbonControl

Dim instance As RibbonButton

[ToolboxBitmapAttribute(typeof(RibbonButton), "RibbonButton.bmp")]
public sealed class RibbonButton : RibbonControl

備註

當您將 [Button] 控制項從 [工具箱] 的 [Office 功能區控制項] 索引標籤拖曳到 [功能區設計工具] 時，Visual Studio Tools for Office 會建立 RibbonButton 類別的執行個體。

您也可以在執行階段時建立這個控制項的執行個體，並加入至動態功能表中。如果您將功能表的 Dynamic 屬性設定為 true，就是動態的功能表。

這個控制項的某些屬性只能在功能區載入至 Office 應用程式前進行設定，或在執行階段控制項加入至動態功能表之前進行設定。如需這些屬性的設定資訊，請參閱功能區物件模型概觀。

一般工作

下表列出適用於一般工作的成員。

工作	成員
在執行階段，將按鈕加入至其 Dynamic 屬性設定為 true 的功能表。	使用 RibbonButton 建構函式 (Constructor)，建立 RibbonButton 類別的執行個體。將執行個體加入至功能表的 Items 集合。
變更按鈕的大小。	將 ControlSize 設定為您想要的值。例如，對於大型按鈕，將它設定為 Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge。
在按鈕上顯示影像。	有三種方式可以顯示影像：使用 Image 屬性。這個屬性提供最大的控制能力。將 OfficeImageId 設定為您要當做按鈕圖示顯示之內建 Microsoft Office 影像的 ID。將 ImageName 屬性與 LoadImage 事件一起使用。這個屬性可以提升一些效能。
停用或隱藏按鈕。	若要停用按鈕，請將 Enabled 設定為 false。若要隱藏按鈕，請將 Visible 設定為 false。
在使用者按一下按鈕時執行程式碼。	將程式碼加入至 Click 事件處理常式。

範例

下列範例會建立新按鈕、設定按鈕的各種屬性，然後將按鈕加入至功能表。若要執行這個程式碼範例，您必須先執行下列步驟：

將 [功能區 (視覺化設計工具)] 項目加入至 Visual Studio Tools for Office 專案。
將群組加入至自訂索引標籤。
將功能表加入至群組。
將功能表的 [Dynamic] 屬性設定為 true。
將功能表的 [ItemSize] 屬性設定為 RibbonControlSizeLarge。

Private Sub AddButtonsToMenu()
    Dim tempButton As New RibbonButton()
    tempButton.Label = "Button 1"
    tempButton.ControlSize = _
        Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge
    tempButton.Description = "My Ribbon Button"
    tempButton.ShowImage = True
    tempButton.ShowImage = True
    tempButton.Image = My.Resources.Image1
    tempButton.Image = My.Resources.Image2
    tempButton.KeyTip = "A1"
    menu1.Items.Add(tempButton)
End Sub

private void AddButtonsToMenu()
{
    RibbonButton tempButton = new RibbonButton();
    tempButton.Label = "Button 1";
    tempButton.ControlSize = 
        Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge;
    tempButton.Description = "My Ribbon Button";
    tempButton.ShowImage = true;
    tempButton.ShowImage = true;
    tempButton.Image = Properties.Resources.Image1;
    tempButton.Image = Properties.Resources.Image2;
    tempButton.KeyTip = "A1";
    menu1.Items.Add(tempButton);

}