추가 기능 호스트 항목
업데이트: 2008년 7월
적용 대상 |
|---|
이 항목의 정보는 지정된 Visual Studio Tools for Office 프로젝트 및 Microsoft Office 버전에만 적용됩니다. 프로젝트 형식
Microsoft Office 버전
자세한 내용은 응용 프로그램 및 프로젝트 형식에 따라 사용 가능한 기능을 참조하십시오. |
Microsoft.Office.Tools.AddIn 클래스는 Visual Studio Tools for Office를 사용하여 만드는 응용 프로그램 수준 추가 기능의 호스트 항목입니다. 호스트 항목은 코드에 대한 진입점을 제공하는 Visual Studio Tools for Office 솔루션의 클래스입니다.
AddIn 및 ThisAddIn 클래스 이해
AddIn 클래스에서는 모든 Visual Studio Tools for Office 추가 기능에서 공유하는 핵심 기능을 제공합니다. 그러나 이 클래스를 명시적으로 인스턴스화하거나 코드에서 직접 사용해서는 안 됩니다.
대신 ThisAddIn 클래스를 사용합니다. Visual Studio Tools for Office에서는 Microsoft Office 응용 프로그램과 추가 기능 코드 사이의 통신 링크 역할을 하도록 추가 기능 프로젝트에 이 클래스를 생성합니다. ThisAddIn 클래스는 AddIn에서 파생됩니다. Microsoft Office 응용 프로그램에서 추가 기능을 로드할 때 Visual Studio Tools for Office에서는 자동으로 이 클래스를 인스턴스화합니다.
ThisAddIn 클래스를 프로젝트의 코드를 작성하는 출발점으로 삼을 수 있습니다. ThisAddIn을 사용하여 호스트 응용 프로그램의 개체 모델에 액세스하는 등의 작업을 수행할 수도 있습니다. 자세한 내용은 응용 프로그램 수준 추가 기능 프로그래밍을 참조하십시오.
Outlook 2007 추가 기능 프로젝트에서 AddIn 및 ThisAddIn 사용
Microsoft Office Outlook 2007용 추가 기능 프로젝트에서는 다른 호스트 항목인 Microsoft.Office.Tools.Outlook.OutlookAddIn을 사용합니다. 이 클래스는 AddIn에서 파생되며 양식 영역을 지원하기 위해 몇 가지 기능을 추가합니다. 양식 영역에 대한 자세한 내용은 Outlook 양식 영역 만들기를 참조하십시오.
Outlook 2007용 추가 기능 프로젝트에서 ThisAddIn 클래스는 OutlookAddIn에서 파생됩니다. Outlook 2007 추가 기능에서 ThisAddIn 클래스를 사용하는 방법은 다른 Microsoft Office 응용 프로그램의 추가 기능에서 이 클래스를 사용할 때와 같습니다.
다양한 작업에 사용되는 멤버
다음 표에서는 일반적인 작업을 설명하고 작업을 수행하는 데 사용할 수 있는 ThisAddIn 클래스의 멤버를 보여 줍니다.
작업 |
사용할 멤버 |
|---|---|
추가 기능이 로드될 때 추가 기능을 초기화하는 코드를 실행합니다. |
ThisAddIn_Startup 메서드에 코드를 추가합니다. 이 메서드는 Startup 이벤트의 기본 이벤트 처리기입니다. 자세한 내용은 Visual Studio Tools for Office 프로젝트 이벤트를 참조하십시오. |
추가 기능이 언로드되기 전에 추가 기능에 사용된 리소스를 정리하는 코드를 실행합니다. |
ThisAddIn_Shutdown 메서드에 코드를 추가합니다. 이 메서드는 Shutdown 이벤트의 기본 이벤트 처리기입니다. 자세한 내용은 Visual Studio Tools for Office 프로젝트 이벤트를 참조하십시오. |
개체 모델에 액세스하여 호스트 응용 프로그램 자동화 |
ThisAddIn 클래스의 Application 필드를 사용합니다. 그러면 추가 기능이 작동하는 응용 프로그램의 Application 클래스 인스턴스가 반환됩니다. 자세한 내용은 응용 프로그램 수준 추가 기능 프로그래밍을 참조하십시오. |
열려 있는 Word 문서나 Excel 통합 문서에서 인식할 수 있는 스마트 태그를 만듭니다. 이 기능은 Visual Studio 2008 SP1(서비스 팩 1)에서 새로 추가되었습니다. |
ThisAddIn 클래스의 VstoSmartTags 필드를 사용합니다. 이 필드는 SP1을 설치한 후에 만든 Excel 2007 및 Word 2007용 추가 기능 프로젝트에서만 사용할 수 있습니다. 자세한 내용은 스마트 태그 개요를 참조하십시오. |
다른 Microsoft Office 솔루션에 추가 기능의 개체를 노출합니다. |
RequestComAddInAutomationService 메서드를 재정의합니다. 자세한 내용은 다른 Office 솔루션에서 응용 프로그램 수준 추가 기능의 코드 호출을 참조하십시오. |
확장성 인터페이스를 구현하여 2007 Microsoft Office system의 기능을 사용자 지정합니다. |
인터페이스를 구현하는 클래스의 인스턴스를 반환하려면 RequestService 메서드를 재정의합니다. 자세한 내용은 확장성 인터페이스를 사용하여 UI 기능 사용자 지정을 참조하십시오. .gif "참고") 참고:
리본 UI를 사용자 지정하기 위해 CreateRibbonExtensibilityObject 메서드를 재정의할 수도 있습니다.
|
참고 항목
작업
연습: VBA에서 응용 프로그램 수준 추가 기능의 코드 호출
개념
런타임에 응용 프로그램 수준 추가 기능의 Word 문서 및 Excel 통합 문서 확장
다른 Office 솔루션에서 응용 프로그램 수준 추가 기능의 코드 호출
Visual Studio Tools for Office 프로젝트 이벤트
변경 기록
날짜 |
변경 내용 |
원인 |
|---|---|---|
|
2008년 7월 |
응용 프로그램 수준 추가 기능을 사용하여 문서에 스마트 태그를 추가하는 방법에 대한 정보가 추가되었습니다. |
SP1 기능 변경 |