문서 호스트 항목

아티클
08/10/2011

Document 호스트 항목은 Word의 주 interop 어셈블리의 Microsoft.Office.Interop.Word.Document 형식을 확장하는 형식입니다. Document 호스트 항목에서는 Microsoft.Office.Interop.Word.Document 개체와 동일한 모든 속성, 메서드 및 이벤트를 제공하지만 추가 이벤트도 노출하며 호스트 컨트롤 및 Windows Forms 컨트롤의 컨테이너 역할도 합니다.

적용 대상: 이 항목의 정보는 Word 2007 및 Word 2010의 문서 수준 프로젝트 및 응용 프로그램 수준 프로젝트에 적용됩니다. 자세한 내용은 Office 응용 프로그램 및 프로젝트 형식에 따라 사용 가능한 기능을 참조하십시오.

문서 수준 프로젝트에는 프로젝트의 문서를 나타내는 기본 Document 호스트 항목이 있습니다. 응용 프로그램 수준 프로젝트에서는 런타임에 Document 호스트 항목을 생성할 수 있습니다.

문서 수준 프로젝트의 Document 호스트 항목 이해

프로젝트의 문서에 액세스하려면 ThisDocument 클래스를 사용합니다. 문서 수준 프로젝트를 만들면 Word와 사용자 지정 코드 사이의 통신 링크 역할을 하는 ThisDocument 클래스가 생성됩니다. ThisDocument 클래스를 통해 Document 호스트 항목의 멤버에 액세스하여 사용자 지정에서 문서가 열리거나 닫힐 때 코드를 실행하는 등의 기본 작업을 수행할 수 있습니다. 이 클래스를 사용하여 문서에 컨트롤과 스마트 태그를 추가할 수도 있습니다. 다양한 컨트롤 집합을 조합하고 코드를 작성하여 컨트롤을 데이터에 바인딩하고 사용자로부터 정보를 수집하고 사용자 작업에 응답할 수 있습니다. 자세한 내용은 문서 수준 사용자 지정 프로그래밍을 참조하십시오.

참고

Excel 2010 및 Word 2010에서 스마트 태그는 더 이상 사용되지 않습니다. 자세한 내용은 스마트 태그 개요를 참조하십시오.

ThisDocument 클래스를 프로젝트의 코드를 작성하는 출발점으로 삼을 수 있습니다. ThisDocument 클래스에서는 Word용 주 interop 어셈블리의 Microsoft.Office.Interop.Word.Document 개체와 동일한 속성, 메서드 및 이벤트를 모두 제공하므로 이 클래스를 사용하여 Word의 개체 모델에 액세스할 수도 있습니다. 자세한 내용은 Word 개체 모델 개요를 참조하십시오.

문서 수준 프로젝트의 문서 호스트 항목의 제한 사항

문서 수준 프로젝트에는 Document 호스트 항목, 즉 ThisDocument 클래스만 포함될 수 있습니다. 디자인 타임에 새 Document 호스트 항목을 프로젝트에 추가할 수는 없으며 런타임에 문서 수준 사용자 지정에서 새 Document 호스트 항목을 만들 수도 없습니다.

런타임에 새 Word 문서를 만들면 해당 문서는 Microsoft.Office.Interop.Word.Document 형식이 됩니다. 이 문서는 호스트 항목이 아니므로 호스트 컨트롤이나 Windows Forms 컨트롤을 포함할 수 없습니다. 런타임에 문서 만들기에 대한 자세한 내용은 방법: 새 문서 만들기를 참조하십시오.

응용 프로그램 수준 프로젝트의 Document 호스트 항목 이해

응용 프로그램 수준 프로젝트에서는 런타임에 Word에 열려 있는 문서에 대한 Document 호스트 항목을 생성할 수 있습니다. Document 호스트 항목을 사용하여 컨트롤 및 스마트 태그를 연결된 문서에 추가하거나 Microsoft.Office.Interop.Word.Document 개체에서 사용할 수 없는 이벤트를 처리할 수 있습니다.

Document 호스트 항목을 생성하려면 GetVstoObject 메서드를 사용합니다. 자세한 내용은 런타임에 응용 프로그램 수준 추가 기능의 Word 문서 및 Excel 통합 문서 확장을 참조하십시오.