逐步解說：建立 PowerPoint 的第一個應用程式層級增益集

更新： 2008 年 7 月

本逐步解說將示範如何建立 Microsoft Office PowerPoint 的應用程式層級增益集。不論開啟哪一份簡報，您在這類方案中建立的功能都可供應用程式本身使用。如需詳細資訊，請參閱 Office 方案開發概觀。

這個逐步解說將說明下列工作：

• 建立 PowerPoint 2003 或 PowerPoint 2007 的增益集專案。

• 撰寫使用 PowerPoint 物件模型將文字方塊加入至每張新投影片的程式碼。

• 建置和執行專案來進行測試。

• 清除專案，好讓增益集不要在開發電腦上自動執行。

注意事項：
您的電腦可能會在下列說明中，以不同名稱或位置顯示某些 Visual Studio 使用者介面項目。您所擁有的 Visual Studio 版本以及使用的設定會決定這些項目。如需詳細資訊，請參閱 Visual Studio 設定。

必要條件

您需要下列元件才能完成此逐步解說：

• Visual Studio Tools for Office (Visual Studio 2008 Professional 和 Visual Studio Team System 的選擇性元件)。

• PowerPoint 2003 或 PowerPoint 2007。

根據預設，Visual Studio Tools for Office 會與列出的 Visual Studio 版本一起安裝。若要檢查電腦上是否已安裝此元件，請參閱安裝 Visual Studio Tools for Office。

建立專案

若要建立新的專案

1. 啟動 Visual Studio。

2. 在 [檔案] 功能表上，指向 [新增]，然後按一下 [專案]。

3. 在 [專案類型] 窗格中，展開 [Visual C#] 或 [Visual Basic]，然後再展開 [Office]。

4. 如果您要開發 PowerPoint 2007 增益集，請選取 [2007] 資料夾，如果要開發 PowerPoint 2003 增益集，則請選取 [2003] 資料夾。

5. 在 [範本] 窗格中，選取 [PowerPoint 2007 增益集] 或 [PowerPoint 2003 增益集]。

6. 在 [名稱] 方塊中輸入 FirstPowerPointAddIn。

7. 按一下 [確定]。

   Visual Studio 會建立 FirstPowerPointAddIn 專案，並在編輯器中開啟 ThisAddIn 程式碼檔。

撰寫可將文字加入至每張新投影片的程式碼

接著，將程式碼加入至 ThisAddIn 程式碼檔。新的程式碼會使用 PowerPoint 的物件模型，將文字方塊加入至每張新投影片。根據預設，ThisAddIn 程式碼檔包含下列產生的程式碼：

• ThisAddIn 類別的部分定義。這個類別提供您撰寫程式碼的進入點 (Entry Point)，並提供對 PowerPoint 物件模型的存取。如需詳細資訊，請參閱 AddIn 主項目。ThisAddIn 類別的其餘部分則定義於您不應修改的隱藏程式碼檔中。

• ThisAddIn_Startup 和 ThisAddIn_Shutdown 事件處理常式。當 PowerPoint 載入和卸載增益集時，會呼叫這些事件處理常式。請使用這些事件處理常式，在增益集載入時將它初始化，以及在增益卸載時清除它所用的資源。如需詳細資訊，請參閱 Visual Studio Tools for Office 專案事件。

若要將文字方塊加入至每張投影片

1. 在 ThisAddIn 程式碼檔中，加入下列程式碼至 ThisAddIn 類別。這段程式碼會定義 Microsoft.Office.Interop.PowerPoint.Application 類別之 PresentationNewSlide 事件的事件處理常式。

   當使用者將新投影片加入至現用簡報時，這個事件處理常式會在新投影片頂端加入文字方塊，並將一些文字加入至文字方塊。

   Private Sub Application_PresentationNewSlide(ByVal Sld As PowerPoint.Slide) _
       Handles Application.PresentationNewSlide
       Dim textBox As PowerPoint.Shape = Sld.Shapes.AddTextbox( _
           Office.MsoTextOrientation.msoTextOrientationHorizontal, 0, 0, 500, 50)
       textBox.TextFrame.TextRange.InsertAfter("This text was added by using code.")
   End Sub
   

   void Application_PresentationNewSlide(PowerPoint.Slide Sld)
   {
       PowerPoint.Shape textBox = Sld.Shapes.AddTextbox(
           Office.MsoTextOrientation.msoTextOrientationHorizontal, 0, 0, 500, 50);
       textBox.TextFrame.TextRange.InsertAfter("This text was added by using code.");
   }
   

2. 如果使用的是 C#，請將下列程式碼加入 ThisAddIn_Startup 事件處理常式中。這是連接 Application_PresentationNewSlide 事件處理常式和 PresentationNewSlide 事件時的必要程式碼。

   this.Application.PresentationNewSlide += 
       new PowerPoint.EApplication_PresentationNewSlideEventHandler(
       Application_PresentationNewSlide);
   

若要修改每張新投影片，前面的程式碼範例可以使用下列物件：

• ThisAddIn 類別的 Application 欄位。Application 欄位會傳回 Microsoft.Office.Interop.PowerPoint.Application 物件，代表 PowerPoint 目前的執行個體。

• PresentationNewSlide 事件的事件處理常式的 Sld 參數。Sld 參數是 Microsoft.Office.Interop.PowerPoint.Slide 物件，代表新投影片。如需詳細資訊，請參閱 PowerPoint 方案。

測試專案

當您建置和執行專案時，請確認該文字方塊有出現在您加入至簡報的新投影片中。

若要測試專案

1. 按 F5 建置及執行專案。

   當您建置專案時，程式碼會編譯為放置在專案建置輸出資料夾中的組件。Visual Studio 也會建立一組登錄項目，好讓 PowerPoint 探索和載入增益集，而且會設定開發電腦中的安全性設定以執行增益集。如需詳細資訊，請參閱 Office 方案建置程序概觀。

2. 在 PowerPoint 中，將新投影片加入至現用簡報。

3. 確認下列文字已加入至投影片頂端的新文字方塊中。

   This text was added by using code.

4. 關閉 PowerPoint。

清除專案

當您完成專案開發時，請從開發電腦移除增益集組件、登錄項目和安全性設定。否則，每次在開發電腦上開啟 PowerPoint 時，增益集就會執行。

若要清除專案

• 在 Visual Studio 中，按一下 [建置] 功能表上的 [清除方案]。

後續步驟

現在您已經建立 PowerPoint 的基本應用程式層級增益集，可以從下列主題進一步了解如何開發增益集：

• 您可以透過 PowerPoint 增益集執行的一般程式設計工作。如需詳細資訊，請參閱應用程式層級增益集程式設計。

• 使用 PowerPoint 物件模型。如需詳細資訊，請參閱 PowerPoint 方案。

• 自訂 PowerPoint 的 UI，例如，透過將自訂索引標籤加入至功能區，或建立您專屬自訂工作窗格的方式。如需詳細資訊，請參閱 Office UI 自訂。

• 建置及偵錯 PowerPoint 應用程式層級增益集。如需詳細資訊，請參閱建置和偵錯 Office 方案。

• 部署 PowerPoint 應用程式層級增益集。如需詳細資訊，請參閱部署 Office 方案。

請參閱

概念

應用程式層級增益集程式設計

PowerPoint 方案

Office UI 自訂

Visual Studio Tools for Office 專案範本概觀

參考

2003 Microsoft Office 增益集專案範本

2007 Microsoft Office 增益集專案範本

其他資源

建置和偵錯 Office 方案

部署 Office 方案

變更記錄