문서 호스트 항목

업데이트: 2008년 7월

Document 호스트 항목은 이벤트를 노출하고 호스트 컨트롤과 Windows Forms 컨트롤의 컨테이너로 사용되는 Word 문서를 나타냅니다. 또한 Document 호스트 항목은 Word용 주 interop 어셈블리의 Microsoft.Office.Interop.Word.Document 클래스와 동일한 속성, 메서드 및 이벤트를 모두 제공합니다.

문서 수준 프로젝트에는 프로젝트의 문서를 나타내는 Document 호스트 항목이 있습니다. Visual Studio 2008 SP1(서비스 팩 1)부터는 런타임에 Word 2007용 응용 프로그램 수준 추가 기능을 사용하여 Document 호스트 항목을 생성할 수도 있습니다.

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

프로젝트의 문서에 프로그래밍 방식으로 액세스하려면 ThisDocument 클래스를 사용합니다. 문서 수준 프로젝트를 만드는 경우 Visual Studio Tools for Office에서는 Word와 사용자 지정 코드 사이의 통신 링크 역할을 하는 ThisDocument 클래스를 생성합니다. ThisDocument 클래스는 Document 호스트 항목 클래스에서 파생됩니다. Visual Studio Tools for Office에서는 런타임에 문서가 열릴 때 자동으로 ThisDocument 클래스를 인스턴스화합니다. 따라서 코드에서 직접 Document 클래스를 인스턴화하면 안 됩니다.

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

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

문서 호스트 항목의 제한 사항

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

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

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

SP1부터는 런타임에 Word에 열려 있는 문서에 대한 Document 호스트 항목을 생성할 수 있습니다. Document 호스트 항목을 사용하여 관련 문서에 컨트롤과 스마트 태그를 추가할 수도 있습니다.

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

참고 항목

개념

호스트 항목 및 호스트 컨트롤 개요

Word 개체 모델 개요

호스트 항목 및 호스트 컨트롤의 프로그래밍에 대한 제한 사항

런타임에 응용 프로그램 수준 추가 기능의 Word 문서 및 Excel 통합 문서 확장

기타 리소스

Word 호스트 컨트롤

Excel 호스트 컨트롤

변경 기록