프로그램 문서 수준 사용자 지정

  • 아티클

문서 수준 사용자 지정을 사용하여 Microsoft Office Word 또는 Microsoft Office Excel을 확장한 경우 다음 작업을 수행할 수 있습니다.

  • 개체 모델을 사용하여 애플리케이션을 자동화합니다.

  • 문서 화면에 컨트롤을 추가합니다.

  • 사용자 지정 어셈블리에서 문서에 VBA(Visual Basic for Applications) 코드를 호출합니다.

  • VBA에서 사용자 지정 어셈블리에 코드를 호출합니다.

  • Microsoft Office가 설치되지 않은 서버에서 문서의 특정 측면을 관리합니다.

  • 애플리케이션의 UI(사용자 인터페이스)를 사용자 지정합니다.

    적용 대상: 이 항목의 정보는 Excel 및 Word의 문서 수준 프로젝트에 적용됩니다. 자세한 내용은 Office 애플리케이션 및 프로젝트 형식에 따라 사용 가능한 기능을 참조하세요.

    문서 수준 프로젝트에서 코드 작성의 일부 측면은 Visual Studio의 다른 프로젝트 유형과 다릅니다. 이러한 차이점 대부분은 Office 개체 모델이 관리 코드에 표시되는 방식에 기인합니다. 자세한 내용은 Office 솔루션에서 코드 작성을 참조하세요.

    문서 수준 사용자 지정 및 Visual Studio에서 Office 개발 도구를 사용하여 만들 수 있는 다른 유형의 솔루션에 대한 일반 정보는 Office 솔루션 개발 개요(VSTO)를 참조하세요.

문서 수준 프로젝트에서 생성된 클래스 사용

문서 수준 프로젝트를 만들 때 Visual Studio에서 프로젝트에서 코드 작성을 시작하기 위해 사용할 수 있는 클래스를 자동으로 생성합니다. Visual Studio에서는 다양한 Word 및 Excel용 클래스를 생성합니다.

  • Word용 문서 수준 프로젝트에서는 ThisDocument 클래스가 기본적으로 호출됩니다.

  • Excel용 문서 수준 프로젝트에는 통합 문서에 대해 하나, 각 워크시트에 대해 하나씩 생성된 클래스가 여러 개 있습니다. 기본적으로 이러한 클래스에는 다음 이름이 있습니다.

    • ThisWorkbook

    • Sheet1

    • Sheet2

    • Sheet3

    생성된 클래스에는 문서가 열리거나 닫힐 때 호출되는 이벤트 처리기가 포함됩니다. 문서가 열릴 때 코드를 실행하려면 Startup 이벤트 처리기에 코드를 추가합니다. 문서가 닫히기 직전에 코드를 실행하려면 Shutdown 이벤트 처리기에 코드를 추가합니다. 자세한 내용은 Office 프로젝트의 이벤트를 참조하세요.

생성된 클래스 디자인 이해

.NET Framework 4 또는 .NET Framework 4.5를 대상으로 하는 프로젝트에서 Visual Studio Tools for Office 런타임의 호스트 항목 형식은 인터페이스이므로 생성된 클래스는 해당 클래스에서 구현을 파생할 수 없습니다. 대신, 생성된 클래스는 다음 기본 클래스에서 대부분의 멤버를 파생합니다.

  • ThisDocument: DocumentBase에서 파생됩니다.

  • ThisWorkbook: WorkbookBase에서 파생됩니다.

  • Sheetn: WorksheetBase에서 파생됩니다.

    이러한 기본 클래스는 해당 멤버에 대한 모든 호출을 Visual Studio Tools for Office 런타임에 있는 해당 호스트 항목 인터페이스의 내부 구현으로 리디렉션합니다. 예를 들어 ThisDocument 클래스의 Protect 메서드를 호출하는 경우 DocumentBase 클래스는 이 호출을 Visual Studio Tools for Office 런타임에 있는 Document 인터페이스의 내부 구현으로 리디렉션합니다.

호스트 애플리케이션의 개체 모델 액세스

호스트 애플리케이션의 개체 모델에 액세스하려면 프로젝트에서 생성된 클래스의 멤버를 사용합니다. 이러한 각 클래스는 Excel 또는 Word의 개체 모델에 있는 개체에 해당하며 대부분의 동일한 속성, 메서드 및 이벤트를 포함합니다. 예를 들어 Word 문서 수준 프로젝트의 ThisDocument 클래스는 Word 개체 모델의 Document 개체와 동일한 대부분의 멤버를 제공합니다.

다음 코드 예제에서는 Word 개체 모델을 사용하여 Word 문서 수준 사용자 지정의 일부인 문서를 저장하는 방법을 보여 줍니다. 이 예제는 ThisDocument 클래스에서 실행하기 위한 것입니다.

this.Save();

ThisDocument 클래스 외부에서 동일한 작업을 수행하려면 Globals 개체를 사용하여 ThisDocument 클래스에 액세스합니다. 예를 들어 작업 창 UI에 저장 단추를 포함하려는 경우 작업 창 코드 파일에 이 코드를 추가할 수 있습니다.

Globals.ThisDocument.Save();

ThisDocument 클래스는 Document 호스트 항목에서 대부분의 멤버를 가져오므로 이 코드에 호출된 Save 메서드는 실제로 Save 호스트 항목의 Document 메서드입니다. 이 메서드는 Word 개체 모델의 Save 개체의 Document 메서드에 해당합니다.

Word 및 Excel의 개체 모델 사용에 대한 자세한 내용은 Word 개체 모델 개요 및 Excel 개체 모델 개요를 참조하세요.

Globals 개체에 대한 자세한 내용은 Office 프로젝트의 개체에 전역 액세스를 참조하세요.

문서에 컨트롤 추가

문서의 UI를 사용자 지정하려면 Windows Forms 컨트롤 또는 호스트 컨트롤 을 문서 화면에 추가하면 됩니다. 다양한 컨트롤 집합을 결합하고 코드를 작성하여 컨트롤을 데이터에 바인딩하고, 사용자로부터 정보를 수집하고, 사용자 작업에 응답할 수 있습니다.

호스트 컨트롤은 Word 및 Excel 개체 모델의 일부 개체를 확장한 클래스입니다. 예를 들어 ListObject 호스트 컨트롤은 Excel의 ListObject 기능을 모두 제공합니다. 그러나 ListObject 호스트 컨트롤에는 추가 이벤트 및 데이터 바인딩 기능도 있습니다.

자세한 내용은 호스트 항목 및 호스트 컨트롤 개요 및 Office 문서의 Windows Forms 컨트롤 개요를 참조하세요.

VBA 및 문서 수준 사용자 지정 결합

문서 수준 사용자 지정의 일부인 문서에서 VBA 코드를 사용할 수 있습니다. 사용자 지정 어셈블리에서 문서의 VBA 코드를 호출하거나, 문서의 VBA 코드에서 사용자 지정 어셈블리의 코드를 호출할 수 있도록 프로젝트를 구성할 수도 있습니다.

자세한 내용은 VBA 및 문서 수준 사용자 지정 결합을 참조하세요.

서버에서 문서 관리

Microsoft Office Word 또는 Microsoft Office Excel이 설치되지 않은 서버에서 문서 수준 사용자 지정의 다양한 측면을 관리할 수 있습니다. 예를 들어 문서의 데이터 캐시에 있는 데이터를 액세스 및 수정할 수 있습니다. 또한 문서와 연결된 사용자 지정 어셈블리를 관리할 수도 있습니다. 예를 들어 프로그래밍 방식으로 문서에서 어셈블리를 제거하여 문서에서 더 이상 코드를 실행하지 못하게 하거나 프로그래밍 방식으로 문서에 어셈블리를 연결할 수 있습니다.

자세한 내용은 ServerDocument 클래스를 사용하여 서버의 문서 관리를 참조하세요.

Microsoft Office 애플리케이션의 사용자 인터페이스 사용자 지정

다음 방법으로 문서 수준 사용자 지정을 사용하여 Word 및 Excel의 UI를 사용자 지정할 수 있습니다.

문서 수준 사용자 지정의 네이티브 Office 개체에서 확장 개체 가져오기

많은 Office 이벤트용 이벤트 처리기에서는 이벤트를 발생시키는 통합 문서, 워크시트 또는 문서를 나타내는 네이티브 Office 개체를 수신합니다. 문서 수준 사용자 지정의 문서 또는 통합 문서에서 이벤트를 발생시킨 경우에만 일부 코드를 실행할 수도 있습니다. 예를 들어 Excel용 문서 수준 사용자 지정에서 사용자가 사용자 지정된 통합 문서의 워크시트 중 하나를 활성화할 때는 일부 코드가 실행되고, 동시에 열린 다른 일부 통합 문서의 워크시트를 활성화할 때는 코드가 실행되지 않도록 할 수 있습니다.

네이티브 Office 개체가 있을 때 개체가 문서 수준 사용자 지정의 호스트 항목 또는 호스트 컨트롤 로 확장되었는지 테스트할 수 있습니다. 호스트 항목 및 호스트 컨트롤은 Visual Studio Tools for Office 런타임에서 제공하는 형식으로, 기본적으로 Word 또는 Excel 개체 모델에 있는 개체(네이티브 Office 개체라고 함)에 기능을 추가합니다. 호스트 항목 및 호스트 컨트롤을 통칭하여 확장 개체라고도 합니다. 호스트 항목 및 호스트 컨트롤에 대한 자세한 내용은 호스트 항목 및 호스트 컨트롤 개요를 참조하세요.

GetVstoObject 및 HasVstoObject 메서드 이해

네이티브 Office 개체를 테스트하려면 프로젝트에서 HasVstoObject 및 GetVstoObject 메서드를 사용합니다.

  • 네이티브 Office 개체에 사용자 지정의 확장 개체가 있는지 확인하려면 HasVstoObject 메서드를 사용합니다. 네이티브 Office 개체에 확장 개체가 있는 경우 이 메서드는 true 를 반환하고 그렇지 않은 경우 false 를 반환합니다.

  • 네이티브 Office 개체에 대한 확장 개체를 가져오려면 GetVstoObject 메서드를 사용합니다. 지정한 네이티브 Office 개체에 ListObject, Workbook, Worksheet또는 Document 개체가 있는 경우 이 메서드는 해당 개체를 반환합니다. 그렇지 않으면 GetVstoObject에서 null을 반환합니다. 예를 들어 지정된 Document가 Word 문서 프로젝트의 문서에 대한 기본 개체인 경우 GetVstoObject 메서드는 Document를 반환합니다.

    문서 수준 프로젝트에서는 런타임에 GetVstoObject 메서드를 사용하여 새 Workbook, Worksheet 또는 Document 호스트 항목을 만들 수 없습니다. 이 메서드는 디자인 타임에 프로젝트에서 생성된 기존 호스트 항목에 액세스할 때만 사용할 수 있습니다. 런타임에 새 호스트 항목을 만들려면 VSTO 추가 기능 프로젝트를 개발해야 합니다. 자세한 내용은 호스트 항목 및 호스트 컨트롤의 프로그래밍에 대한 제한 사항 및 런타임에 VSTO 추가 기능에서 Word 문서 및 Excel 통합 문서 확장을 참조하세요.

GetVstoObject 및 HasVstoObject 메서드 사용

HasVstoObject 및 GetVstoObject 메서드를 호출하려면 Globals.Factory.GetVstoObject 또는 Globals.Factory.HasVstoObject 메서드를 사용하고 테스트하려는 네이티브 Word 또는 Excel 개체(예: Document 또는 Worksheet)를 전달합니다.

관련 콘텐츠