RibbonComponent.Tag 속성

정의

네임스페이스:

Microsoft.Office.Tools.Ribbon

어셈블리:

Microsoft.Office.Tools.Common.dll, Microsoft.Office.Tools.Common.v4.0.Utilities.dll, Microsoft.Office.Tools.Excel.v4.0.Utilities.dll, Microsoft.Office.Tools.Word.v4.0.Utilities.dll

이 RibbonComponent와 연결된 애플리케이션별 데이터를 가져오거나 설정합니다.

public:
 property System::Object ^ Tag { System::Object ^ get(); void set(System::Object ^ value); };

public object Tag { get; set; }

member this.Tag : obj with get, set

Public Property Tag As Object

속성 값

Object

이 RibbonComponent와 연결된 애플리케이션별 데이터를 나타내는 System.Object입니다.

예제

다음 예제에서는 개체의 Employee 배열을 그룹의 속성으로 Tag 설정하는 방법과 속성 값을 Tag 검색하는 방법을 보여 줍니다. 이 예제에서는 속성을 ID 노출 String 하는 라는 Employee 클래스를 정의하고 개체 배열 Employee 을 반환하는 메서드를 GetEmployees 정의해야 합니다.

이 코드 예제를 실행하려면 먼저 다음 단계를 수행해야 합니다.

1. Visual Studio에서 Office 개발 도구를 사용하여 만든 프로젝트에 리본 메뉴(Visual Designer) 항목을 추가합니다.

2. 기본 그룹 Group1에 단추를 추가합니다.

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);
    }
}

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

설명

클래스에서 파생된 모든 형식을 System.Object 이 속성에 할당할 수 있습니다. 그러나 Visual Studio 속성 창에서 속성을 설정하는 Tag 경우 텍스트만 할당할 수 있습니다.

속성의 Tag 일반적인 용도는 컨트롤과 밀접하게 연결된 데이터를 저장하는 것입니다. 예를 들어 고객에 대한 정보를 표시하는 단추가 있는 경우 데이터에 빠르게 액세스할 수 있도록 단추의 Tag 속성에 고객의 주문 기록이 포함된 를 저장할 System.Data.DataSet 수 있습니다.