XMLNodes 컨트롤
업데이트: 2007년 11월
적용 대상 |
|---|
이 항목의 정보는 지정된 Visual Studio Tools for Office 프로젝트 및 Microsoft Office 버전에만 적용됩니다. 프로젝트 형식
Microsoft Office 버전
자세한 내용은 응용 프로그램 및 프로젝트 형식에 따라 사용 가능한 기능을 참조하십시오. |
XMLNodes 컨트롤은 이벤트를 노출하는 매핑된 XML 노드 개체의 컬렉션입니다. XMLNodes 컨트롤은 반복되는 스키마 요소를 Microsoft Office Word 문서에 매핑하는 경우에만 작성됩니다. 반복되는 요소에 자식 요소가 포함되어 있으면 각 자식 요소도 XMLNodes 컨트롤로 작성됩니다.
Visual Studio Tools for Office에서 XML 노드의 컬렉션을 만들면 Word 개체 모델을 순회하지 않고도 컨트롤에 대한 프로그램을 직접 작성할 수 있습니다. XMLNodes 컨트롤은 문서에서 요소 매핑을 제거해야만 삭제할 수 있습니다.
.gif "참고") 참고: |
|---|
Item 속성을 통해 XMLNodes 컨트롤의 자식 요소에 액세스하면 Microsoft.Office.Tools.Word.XMLNode 컨트롤 대신 Microsoft.Office.Interop.Word.XMLNode 개체가 반환됩니다. 자세한 내용은 호스트 항목 및 호스트 컨트롤의 프로그래밍에 대한 제한 사항을 참조하십시오. |
컨트롤에 데이터 바인딩
XMLNodes 컨트롤은 데이터 바인딩을 지원하지 않습니다. XMLNodes 컨트롤에는 복합 데이터 바인딩 기능이 없고 단순 데이터 바인딩에서는 반복되는 데이터를 표현할 수 없기 때문입니다.
형식 지정
문서 내의 텍스트에 적용할 수 있는 모든 형식을 XMLNodes 컨트롤에 적용할 수 있습니다.
이벤트
XMLNodes 컨트롤에 사용할 수 있는 이벤트는 다음과 같습니다.
이벤트 비교
사용자가 특정 XMLNodes 컨트롤의 컨텍스트 안으로 커서를 옮기면 이벤트를 캡처할 수 있습니다. 예를 들어 다음과 같이 Customer라는 XMLNodes 컨트롤에 Company라는 자식 XMLNodes 컨트롤 하나가 있고 Company에 CompanyName 및 CompanyRegion이라는 자식 XMLNodes 컨트롤 두 개가 있는 경우를 생각해 볼 수 있습니다.
<Customer>
<Company>
<CompanyName>
<CompanyRegion>
커서가 Company 노드로 이동할 때마다 작업 창에 컨트롤을 표시하려는 경우 커서가 CompanyName에 있는지 CompanyRegion에 있는지 여부는 중요하지 않습니다. 이 두 컨트롤은 모두 Company의 컨텍스트 내에 있기 때문입니다. 이 경우 Company의 ContextEnter 이벤트에 코드를 작성할 수 있습니다.
대부분의 경우 커서가 XMLNodes 컨트롤로 이동하면 Select 및 ContextEnter 이벤트가 모두 발생합니다. 다음 표에서는 이러한 이벤트의 차이점을 보여 줍니다.
Select 이벤트 |
ContextEnter 이벤트 |
|---|---|
커서가 XMLNodes 컬렉션의 노드 중 하나에 배치된 경우에 발생합니다. |
커서가 노드의 컨텍스트 바깥쪽 영역에서 XMLNodes 컬렉션의 노드나 하위 노드 중 하나에 배치된 경우에 발생합니다. 즉, 이 이벤트는 컨텍스트가 변경되어 여러 개의 중첩된 XMLNodes 컨트롤이 발생할 수 있는 경우에만 발생합니다. |
예를 들어 Customer의 바깥쪽에서 CompanyName으로 커서를 옮기면 Customer, Company 및 CompanyName에 대한 ContextEnter 이벤트가 발생합니다. CompanyName에서 CompanyRegion으로 커서를 옮기면 CompanyRegion에 대한 ContextEnter 이벤트만 발생합니다. Company 및 Customer 모두에 대한 컨텍스트가 동일하기 때문입니다. 문서에 여러 개의 Company 노드가 있을 수 있습니다. 한 Company의 CompanyName 노드에서 다른 Company의 CompanyName 노드로 커서를 옮기면 컨텍스트가 동일하므로 Select 이벤트만 발생합니다.
ContextLeave 이벤트와 Deselect 이벤트 사이에도 이와 같은 차이점이 있습니다.
참고 항목
작업
방법: Visual Studio 내부의 Word 문서에 스키마 매핑
개념
호스트 항목 및 호스트 컨트롤의 프로그래밍에 대한 제한 사항