RibbonComponent.Tag 속성
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
이 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
속성 값
이 RibbonComponent와 연결된 애플리케이션별 데이터를 나타내는 System.Object입니다.
예제
다음 예제에서는 개체의 Employee
배열을 그룹의 속성으로 Tag 설정하는 방법과 속성 값을 Tag 검색하는 방법을 보여 줍니다. 이 예제에서는 속성을 ID
노출 String 하는 라는 Employee
클래스를 정의하고 개체 배열 Employee
을 반환하는 메서드를 GetEmployees
정의해야 합니다.
이 코드 예제를 실행하려면 먼저 다음 단계를 수행해야 합니다.
Visual Studio에서 Office 개발 도구를 사용하여 만든 프로젝트에 리본 메뉴(Visual Designer) 항목을 추가합니다.
기본 그룹
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
수 있습니다.