프로그램 VSTO 추가 기능

VSTO 추가 기능을 만들어 Microsoft Office 애플리케이션을 확장하는 경우 프로젝트의 ThisAddIn 클래스에 대해 직접 코드를 작성합니다. 이 클래스를 사용하여 Microsoft Office 호스트 애플리케이션의 개체 모델 액세스, 애플리케이션의 UI(사용자 인터페이스) 사용자 지정, 다른 Office 솔루션에 VSTO 추가 기능의 개체 표시 등의 작업을 수행할 수 있습니다.

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

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

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

ThisAddIn 클래스 사용

ThisAddIn 클래스에서 VSTO 추가 기능 코드 작성을 시작할 수 있습니다. Visual Studio는 VSTO 추가 기능 프로젝트의 ThisAddIn.vb(Visual Basic) 또는 ThisAddIn.cs(C#) 코드 파일에 이 클래스를 자동으로 생성합니다. Visual Studio Tools for Office 런타임은 Microsoft Office 애플리케이션에서 VSTO 추가 기능을 로드할 때 이 클래스를 자동으로 인스턴스화합니다.

ThisAddIn 클래스에는 두 가지 기본 이벤트 처리기가 있습니다. VSTO 추가 기능이 로드될 때 코드를 실행하려면 ThisAddIn_Startup 이벤트 처리기에 코드를 추가합니다. VSTO 추가 기능이 언로드되기 직전에 코드를 실행하려면 ThisAddIn_Shutdown 이벤트 처리기에 코드를 추가합니다. 이러한 이벤트 처리기에 대한 자세한 내용은 Office 프로젝트의 이벤트를 참조하세요.

참고 항목

Outlook에서는 기본적으로 VSTO 추가 기능이 언로드될 때 ThisAddIn_Shutdown 이벤트 처리기가 항상 호출되지는 않습니다. 자세한 내용은 Office 프로젝트의 이벤트를 참조하세요.

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

호스트 애플리케이션의 개체 모델에 액세스하려면 Application 클래스의 ThisAddIn 필드를 사용합니다. 이 필드는 호스트 애플리케이션의 현재 인스턴스를 나타내는 개체를 반환합니다. 다음 표에서는 각 VSTO 추가 기능 프로젝트에서 Application 필드에 대한 반환 값의 형식을 보여 줍니다.

호스트 애플리케이션	반환 값 형식
Microsoft Office Excel	Application
Microsoft Office InfoPath	Application
Microsoft Office Outlook	Application
Microsoft Office PowerPoint	애플리케이션
Microsoft Office Project	Microsoft.Office.Interop.MSProject.Application
Microsoft Office Visio	Microsoft.Office.Interop.Visio.Application
Microsoft Office Word	Application

다음 코드 예제에서는 Application 필드를 사용하여 Microsoft Office Excel용 VSTO 추가 기능에서 새 통합 문서를 만드는 방법을 보여 줍니다. 이 예제는 ThisAddIn 클래스에서 실행하기 위한 것입니다.

C#

Excel.Workbook newWorkbook = this.Application.Workbooks.Add(System.Type.Missing);

VB

Dim newWorkbook As Excel.Workbook = Me.Application.Workbooks.Add()

ThisAddIn 클래스 외부에서 동일한 작업을 수행하려면 Globals 개체를 사용하여 ThisAddIn 클래스에 액세스합니다. Globals 개체에 대한 자세한 내용은 Office 프로젝트의 개체에 전역 액세스를 참조하세요.

C#

Excel.Workbook newWorkbook = Globals.ThisAddIn.Application.Workbooks.Add(System.Type.Missing);

VB

Dim newWorkbook As Excel.Workbook = Globals.ThisAddIn.Application.Workbooks.Add()

특정 Microsoft Office 애플리케이션의 개체 모델에 대한 자세한 내용은 다음 항목을 참조하세요.

• Excel 개체 모델 개요

• Word 개체 모델 개요

• Outlook 개체 모델 개요

• InfoPath 솔루션

• PowerPoint 솔루션

• Project 솔루션

• Visio 개체 모델 개요

Office 애플리케이션이 시작될 때 문서 액세스

일부 Office 2010 애플리케이션은 시작될 때 자동으로 문서를 열지 않고, Office 2013 애플리케이션은 시작될 때 문서를 열지 않습니다. 따라서 코드에서 문서를 열어야 하는 경우 ThisAdd-In_Startup 이벤트 처리기에 코드를 추가하지 않습니다. 대신 사용자가 문서를 만들거나 열 때 Office 애플리케이션에서 발생하는 이벤트에 해당 코드를 추가합니다. 이런 식으로 코드에서 작업을 수행하기 전에 문서가 열리도록 할 수 있습니다.

다음 코드 예제에서는 사용자가 문서를 만들거나 기존 문서를 여는 경우에만 Word에서 문서로 작업합니다.

C#

    private void ThisAddIn_Startup(object sender, System.EventArgs e)
    {
        this.Application.DocumentOpen +=
new Word.ApplicationEvents4_DocumentOpenEventHandler(WorkWithDocument);

        ((Word.ApplicationEvents4_Event)this.Application).NewDocument +=
            new Word.ApplicationEvents4_NewDocumentEventHandler(WorkWithDocument);  
    }
    
    private void WorkWithDocument(Microsoft.Office.Interop.Word.Document Doc)
    {
        try
        {
            Word.Range rng = Doc.Range(0, 0);
            rng.Text = "New Text";
            rng.Select();
        }
        catch (Exception ex)
        {
            // Handle exception if for some reason the document is not available.
        }
    }

VB

Private Sub ThisAddIn_Startup() Handles Me.Startup

    AddHandler Application.NewDocument, AddressOf WorkWithDocument

End Sub

Private Sub WorkWithDocument(ByVal Doc As Microsoft.Office.Interop.Word.Document) _
    Handles Application.DocumentOpen

    Dim rng As Word.Range = Doc.Range(Start:=0, End:=0)
    rng.Text = " New Text "
    rng.Select()

End Sub

다른 작업에 사용할 ThisAddIn 멤버

다음 표에서는 다른 일반적인 작업에 대해 설명하고 작업을 수행하는 데 사용할 수 있는 ThisAddIn 클래스의 멤버를 보여 줍니다.

작업	사용할 멤버
VSTO 추가 기능이 로드될 때 코드를 실행하여 VSTO 추가 기능을 초기화합니다.	ThisAddIn_Startup 메서드에 코드를 추가합니다. Startup 이벤트에 대한 기본 이벤트 처리기입니다. 자세한 내용은 Office 프로젝트의 이벤트를 참조하세요.
VSTO 추가 기능이 언로드되기 전에 코드를 실행하여 VSTO 추가 기능에서 사용된 리소스를 정리합니다.	ThisAddIn_Shutdown 메서드에 코드를 추가합니다. Shutdown 이벤트에 대한 기본 이벤트 처리기입니다. 자세한 내용은 Office 프로젝트의 이벤트를 참조하세요. 참고: Outlook에서는 기본적으로 VSTO 추가 기능이 언로드될 때 ThisAddIn_Shutdown 이벤트 처리기가 항상 호출되지는 않습니다. 자세한 내용은 Office 프로젝트의 이벤트를 참조하세요.
사용자 지정 작업창을 표시합니다.	CustomTaskPanes 필드를 사용합니다. 자세한 내용은 사용자 지정 작업창을 참조하세요.
다른 Microsoft Office 솔루션에 VSTO 추가 기능의 개체를 표시합니다.	RequestComAddInAutomationService 메서드를 재정의합니다. 자세한 내용은 다른 Office 솔루션의 VSTO 추가 기능의 호출 코드를 참조하세요.
확장성 인터페이스를 구현하여 Microsoft Office 시스템의 기능을 사용자 지정합니다.	RequestService 메서드를 재정의하여 인터페이스를 구현하는 클래스의 인스턴스를 반환합니다. 자세한 내용은 확장성 인터페이스를 사용하여 UI 기능 사용자 지정을 참조하세요. 참고: 리본 UI를 사용자 지정하려면 CreateRibbonExtensibilityObject 메서드를 재정의할 수도 있습니다.

ThisAddIn 클래스의 디자인 이해

.NET Framework 4를 대상으로 하는 프로젝트에서 AddIn은 인터페이스입니다. ThisAddIn 클래스는 AddInBase 클래스에서 파생됩니다. 이 기본 클래스는 해당 멤버에 대한 모든 호출을 Visual Studio Tools for Office 런타인에서 AddIn 인터페이스의 내부 구현으로 리디렉션합니다.

Outlook의 VSTO 추가 기능 프로젝트에서 ThisAddIn 클래스는 .NET Framework 3.5를 대상으로 하는 프로젝트의 Microsoft.Office.Tools.Outlook.OutlookAddIn 클래스 및 .NET Framework 4를 대상으로 하는 프로젝트의 OutlookAddInBase에서 파생됩니다. 이러한 기본 클래스는 양식 영역을 지원하기 위해 몇 가지 추가 기능을 제공합니다. 양식 영역에 대한 자세한 내용은 Outlook 양식 영역 만들기를 참조하세요.

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

VSTO 추가 기능을 사용하여 Microsoft Office 애플리케이션의 UI를 프로그래밍 방식으로 사용자 지정할 수 있습니다. 예를 들어 리본을 사용자 지정하거나, 사용자 지정 작업창을 표시하거나, Outlook에서 사용자 지정 양식 영역을 만들 수 있습니다. 자세한 내용은 Office UI 사용자 지정 개요를 참조하세요.

Visual Studio는 사용자 지정 작업창, 리본 사용자 지정 및 Outlook 양식 영역을 만드는 데 사용할 수 있는 디자이너 및 클래스를 제공합니다. 이러한 디자이너 및 클래스를 사용하면 이러한 기능을 사용자 지정하는 프로세스를 간소화할 수 있습니다. 자세한 내용은 사용자 지정 작업창, 리본 디자이너, Outlook 양식 영역 만들기를 참조하세요.

클래스 및 디자이너에서 지원하지 않는 방식으로 이러한 기능 중 하나를 사용자 지정하려는 경우 VSTO 추가 기능에서 확장성 인터페이스 를 구현하여 이러한 기능을 사용자 지정할 수도 있습니다. 자세한 내용은 확장성 인터페이스를 사용하여 UI 기능 사용자 지정을 참조하세요.

또한 문서 및 통합 문서의 동작을 확장하는 호스트 항목을 생성하여 Word 문서 및 Excel 통합 문서의 UI를 수정할 수 있습니다. 그러면 문서 및 워크시트에 관리되는 컨트롤을 추가할 수 있습니다. 자세한 내용은 런타임 시 VSTO 추가 기능에서 Word 문서 및 Excel 통합 문서 확장을 참조하세요.

다른 솔루션에서 VSTO 추가 기능의 코드 호출

VSTO 추가 기능의 개체를 다른 Office 솔루션을 비롯한 다른 솔루션에 표시할 수 있습니다. 이는 해당 VSTO 추가 기능이 다른 솔루션에서 사용하도록 하려는 서비스를 제공하는 경우에 유용합니다. 예를 들어 웹 서비스의 재무 데이터에 대해 계산을 수행하는 Microsoft Office Excel용 VSTO 추가 기능이 있는 경우 다른 솔루션에서는 런타임에 이 Excel VSTO 추가 기능을 호출하여 이러한 계산을 수행할 수 있습니다.

자세한 내용은 다른 Office 솔루션의 VSTO 추가 기능의 호출 코드를 참조하세요.

관련 콘텐츠

• Office 솔루션 개발
• 런타임에 VSTO 추가 기능에서 Word 문서 및 Excel 통합 문서 확장
• 다른 Office 솔루션의 VSTO 추가 기능에서 코드 호출
• 연습: VBA에서 VSTO 추가 기능의 코드 호출
• 확장성 인터페이스를 사용하여 UI 기능 사용자 지정
• 방법: Visual Studio에서 Office 프로젝트 만들기
• Architecture of VSTO Add-ins
• Office 솔루션에서 코드 작성