Share via

RibbonComponent.Tag 屬性

  • 發行項

取得或設定與這個 RibbonComponent 關聯的應用程式特定資料。

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

語法

'宣告
Property Tag As Object

Object Tag { get; set; }

屬性值

型別：System.Object
System.Object，表示與這個 RibbonComponent 關聯的應用程式特定資料。

備註

衍生自 System.Object 類別的任何類型都可以指定至這個屬性。 不過，如果您在 Visual Studio 的 [屬性] 視窗中設定 Tag 屬性，則只能指派文字。

Tag 屬性的常見用途是儲存與控制項密切關聯的資料。 例如，如果您有一個顯示客戶相關資訊的按鈕，您可以將包含客戶訂單記錄的 System.Data.DataSet 儲存在該按鈕的 Tag 屬性中，以便快速存取資料。

範例

下列範例示範如何將 Employee 物件陣列設定為群組的 Tag 屬性，以及如何擷取 Tag 屬性的值。 這個範例要求您必須已經定義一個負責公開 (Expose) String 屬性 ID 的 Employee 類別，以及一個負責傳回 Employee 物件陣列的 GetEmployees 方法。

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

  1. 將 [功能區 (視覺化設計工具)] 項目加入至在 Visual Studio 中使用 Office 開發工具建立的專案。

  2. 將按鈕加入至預設群組 Group1。

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) Handles Button1.Click
    ' Set the group's Tag property
    Group1.Tag = GetEmployees()

    ' Show all customers by retrieving them from the group's Tag property
    For Each emp As Employee In CType(Group1.Tag, Employee())
        System.Windows.Forms.MessageBox.Show(emp.ID)
    Next
End Sub

private void button1_Click(object sender, RibbonControlEventArgs e)
{
    // Set the group's Tag property
    group1.Tag = GetEmployees();

    // Show all customers by retrieving them from the group's Tag property
    foreach (Employee emp in (Employee[])group1.Tag)
    {
        System.Windows.Forms.MessageBox.Show(emp.ID);
    }
}

.NET Framework 安全性

請參閱

參考

RibbonComponent 介面

Microsoft.Office.Tools.Ribbon 命名空間