Document 호스트 항목은 Word의 Document 기본 상호 운용 어셈블리에서 형식을 확장하는 유형입니다. 호스트 항목은 Document 개체와 동일한 속성, 메서드 및 이벤트를 Document 모두 제공하지만 추가 이벤트를 노출하고 호스트 컨트롤 및 Windows Forms 컨트롤에 대한 컨테이너 역할을 합니다.
적용 대상: 이 항목의 정보는 Word용 문서 수준 프로젝트 및 VSTO 추가 기능 프로젝트에 적용됩니다. 자세한 내용은 Office 응용 프로그램 및 프로젝트 유형에서 사용할 수 있는 기능을 참조하세요.
문서 수준 프로젝트에는 프로젝트의 문서를 나타내는 기본 Document 호스트 항목이 있습니다. VSTO 추가 기능 프로젝트에서 런타임에 호스트 항목을 생성 Document 할 수 있습니다.
문서 수준 프로젝트의 문서 호스트 항목 이해
프로젝트의 문서에 액세스하려면 클래스를 ThisDocument 사용합니다. 문서 수준 프로젝트를 만들 때 Visual Studio는 ThisDocument Word와 사용자 지정 코드 간의 통신 링크 역할을 하는 클래스를 생성합니다. 이 클래스는 ThisDocument 문서를 열거나 닫을 때 코드 실행과 같이 사용자 지정에서 기본 작업을 수행하기 위해 호스트 항목의 멤버 Document 에 액세스할 수 있도록 합니다. 클래스를 사용하여 문서에 컨트롤을 추가할 수도 있습니다. 다양한 컨트롤 집합을 결합하고 코드를 작성하면 컨트롤을 데이터에 바인딩하고, 사용자로부터 정보를 수집하고, 사용자 작업에 응답할 수 있습니다. 자세한 내용은 프로그램 문서 수준 사용자 지정을 참조하세요.
클래스는 ThisDocument 프로젝트에서 코드 작성을 시작할 수 있는 위치를 제공합니다. 클래스는 Word의 기본 interop 어셈블리에 있는 Document 개체와 동일한 속성, 메서드 및 이벤트를 모두 제공하므로 ThisDocument를 사용하여 Word의 개체 모델에 액세스할 수 있습니다. 자세한 내용은 Word 개체 모델 개요를 참조하세요.
문서 수준 프로젝트에서 문서 호스트 항목의 제한 사항
문서 수준 프로젝트는 하나의 Document 호스트 항목(즉, ThisDocument 클래스)만 포함할 수 있습니다. 디자인 타임에는 프로젝트에 새 Document 호스트 항목을 추가할 수 없으며 런타임에 문서 수준 사용자 지정에서 새 Document 호스트 항목을 만들 수 없습니다.
런타임에 새 Word 문서를 만들면 형식 Document이 됩니다. 호스트 항목이 아니므로 호스트 컨트롤 또는 Windows Forms 컨트롤을 포함할 수 없습니다. 런타임에 문서를 만드는 방법에 대한 자세한 내용은 방법: 프로그래밍 방식으로 새 문서 만들기를 참조하세요.
애플리케이션 수준 프로젝트의 문서 호스트 항목 이해
VSTO 추가 기능 프로젝트에서는 Word에서 열려 있는 Document 모든 문서에 대해 런타임에 호스트 항목을 생성할 수 있습니다. 호스트 항목을 사용하여 Document 연결된 문서에 컨트롤을 추가하거나 개체에서 Document 사용할 수 없는 이벤트를 처리할 수 있습니다.
호스트 항목을 생성 Document 하려면 메서드를 GetVstoObject 사용합니다. 자세한 내용은 런타임에 VSTO 추가 기능에서 Word 문서 및 Excel 통합 문서 확장을 참조하세요.