다음을 통해 공유

문서 호스트 항목

  • 아티클

Document 호스트 항목은 Word용 주 interop 어셈블리의 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 통합 문서 확장을 참조하세요.

관련 콘텐츠