應用程式層級增益集程式設計
更新：2007 年 11 月
適用於 |
|---|
本主題中的資訊僅適用於指定的 Visual Studio Tools for Office 專案和 Microsoft Office 版本。 專案類型
Microsoft Office 版本
如需詳細資訊，請參閱依應用程式和專案類型提供的功能。 |
透過建立 Visual Studio Tools for Office 增益集 (Add-In) 擴充 Microsoft Office 應用程式時，是直接對專案中的 ThisAddIn 類別 (Class) 撰寫程式碼。您可以使用這個類別來執行工作，例如存取 Microsoft Office 主應用程式 (Host Application) 的物件模型 (Object Model)、自訂應用程式的使用者介面 (UI)，以及將增益集中的物件公開 (Expose) 給其他 Office 方案。
如需應用程式層級增益集和其他可以使用 Visual Studio Tools for Office 建立之方案類型的一般資訊，請參閱 Office 方案開發概觀。
在增益集專案中撰寫程式碼
您可以在 ThisAddIn 類別中開始撰寫增益集程式碼。Visual Studio Tools for Office 會在增益集專案的 ThisAddIn.vb (Visual Basic) 或 ThisAddIn.cs (C#) 程式碼檔中自動產生這個類別。
ThisAddIn 類別有兩個預設事件處理常式。若要在載入增益集時執行程式碼，請將程式碼加入至 ThisAddIn_Startup 事件處理常式中。若要在卸載增益集之前執行程式碼，則請將程式碼加入至 ThisAddIn_Shutdown 事件處理常式中。如需詳細資訊，請參閱 Visual Studio Tools for Office 專案事件。
ThisAddIn 類別的大部分功能是衍生自 AddIn 類別。AddIn 提供所有 Visual Studio Tools for Office 增益集都有的核心功能。如需 AddIn 類別的詳細資訊，請參閱 AddIn 主項目。
存取主應用程式的物件模型
若要存取主應用程式的物件模型，請使用 ThisAddIn 的 Application 欄位。此欄位會傳回代表目前主應用程式執行個體的物件。
下列程式碼範例顯示如何使用 Application 欄位，在 Microsoft Office Excel 的增益集中建立新的活頁簿。這個範例適合從 ThisAddIn 類別執行。
Dim newWorkbook As Excel.Workbook = Me.Application.Workbooks.Add()
Excel.Workbook newWorkbook = this.Application.Workbooks.Add(System.Type.Missing);
若要從 ThisAddIn 類別外執行同樣的動作，請使用 Globals 物件存取 ThisAddIn 類別。如需 Globals 物件的詳細資訊，請參閱全域存取 Visual Studio Tools for Office 專案中的物件。
Dim newWorkbook As Excel.Workbook = Globals.ThisAddIn.Application.Workbooks.Add()
Excel.Workbook newWorkbook = Globals.ThisAddIn.Application.Workbooks.Add(System.Type.Missing);
下表列出每個增益集專案之 Application 欄位的傳回值型別。
主應用程式 |
傳回實值型別 |
|---|---|
Microsoft Office Excel |
|
Microsoft Office InfoPath |
Microsoft.Office.Interop.InfoPath.Application |
Microsoft Office Outlook |
Microsoft.Office.Interop.Outlook.Application |
Microsoft Office PowerPoint |
Microsoft.Office.Interop.PowerPoint.Application |
Microsoft Office Project |
Microsoft.Office.Interop.MSProject.Application |
Microsoft Office Visio |
Microsoft.Office.Interop.Visio.Application |
Microsoft Office Word |
自訂 Microsoft Office 應用程式的使用者介面
您可以使用應用程式層級增益集，以程式設計的方式自訂 Microsoft Office 應用程式的 UI。如果是 Microsoft Office 2003 應用程式，可以自訂的 UI 功能包括功能表和工具列。如果是 2007 Microsoft Office system 的應用程式，則部分可自訂的 UI 功能會不同。這些功能包括功能區、自訂工作窗格和 Outlook 表單區域。如需詳細資訊，請參閱 Office UI 自訂。
Visual Studio Tools for Office 提供一些設計工具和類別，可以用來建立自訂工作窗格、功能區自訂和 Outlook 表單區域。這些設計工具和類別有助於簡化自訂這些功能的流程。如需詳細資訊，請參閱自訂工作窗格概觀、功能區設計工具 和 建立 Outlook 表單區域。
如果想要使用 Visual Studio Tools for Office 類別和設計工具不支援的方式來自訂上述其中一個功能，也可以透過在增益集中實作「擴充性介面」(Extensibility Interface) 來自訂這些功能。如需詳細資訊，請參閱使用擴充性介面自訂 UI 功能。
從 Visual Studio 2008 Service Pack 1 (SP1) 開始，您也可以藉由產生可擴充文件和活頁簿行為的主項目，修改 Word 文件和 Excel 活頁簿的 UI。這可讓您將 Managed 控制項和 Visual Studio Tools for Office 智慧標籤加入至文件和工作表。如需詳細資訊，請參閱在應用程式層級增益集的執行階段中擴充 Word 文件和 Excel 活頁簿。
在應用程式層級增益集中呼叫其他 Office 方案的程式碼
您可以將增益集中的物件公開給其他 Office 方案。如果您想要讓其他 Office 方案也能使用增益集提供的服務時，這就很有用。例如，如果有個 Microsoft Office Excel 增益集會計算 Web 服務的財務資料，則其他 Office 方案可以在執行階段呼叫這個 Excel 增益集來執行這些計算。
如需詳細資訊，請參閱在應用程式層級增益集中呼叫其他 Office 方案的程式碼。
請參閱
工作
HOW TO：建立 Visual Studio Tools for Office 專案