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

發行項
08/12/2011

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

**適用於：**本主題中的資訊適用於 PowerPoint 2007 和 PowerPoint 2010 的應用程式層級專案。如需詳細資訊，請參閱依 Office 應用程式和專案類型提供的功能。

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

建立 PowerPoint 的 PowerPoint 增益集專案。
撰寫使用 PowerPoint 物件模型將文字方塊加入至每張新投影片的程式碼。
建置和執行專案來進行測試。
清除專案，好讓增益集不要在開發電腦上自動執行。

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

視訊的連結如需觀看相關示範影片，請參閱如何建立 Microsoft PowerPoint 的增益集？(英文)。

必要條件

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

包含 Microsoft Office 開發者工具的 Visual Studio 2010 版本。 如需詳細資訊，請參閱[設定電腦以開發 Office 方案](bb398242\(v=vs.100\).md)。

PowerPoint 2007 或 PowerPoint 2010。

建立專案

若要建立新的專案

啟動 Visual Studio。
在 [檔案] 功能表上，指向 [新增]，然後按一下 [專案]。
在 [範本] 窗格中，展開 [Visual C#] 或 [Visual Basic]，然後展開 [Office]。
在展開的 [Office] 節點底下，選取 [2007] (如果您已安裝 PowerPoint 2007) 或選取 [2010] 節點 (如果您已安裝 PowerPoint 2010)。
在專案範本清單中，選取 [PowerPoint 2007 增益集] 或 [PowerPoint 2010 增益集]。
在 [名稱] 方塊中輸入 FirstPowerPointAddIn。
按一下 [確定]。

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

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

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

ThisAddIn 類別的部分定義。這個類別提供您撰寫程式碼的進入點 (Entry Point)，並提供對 PowerPoint 物件模型的存取。如需詳細資訊，請參閱應用程式層級增益集程式設計。 ThisAddIn 類別的其餘部分則定義於您不應修改的隱藏程式碼檔中。
ThisAddIn_Startup 和 ThisAddIn_Shutdown 事件處理常式。當 PowerPoint 載入和卸載增益集時，會呼叫這些事件處理常式。請使用這些事件處理常式，在增益集載入時將它初始化，以及在增益卸載時清除它所用的資源。如需詳細資訊，請參閱 Office 專案中的事件。

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

在 ThisAddIn 程式碼檔中，加入下列程式碼至 ThisAddIn 類別。這段程式碼會定義 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.");
}

如果使用的是 C#，請將下列程式碼加入 ThisAddIn_Startup 事件處理常式中。這是連接 Application_PresentationNewSlide 事件處理常式和 PresentationNewSlide 事件時的必要程式碼。
```
this.Application.PresentationNewSlide += 
    new PowerPoint.EApplication_PresentationNewSlideEventHandler(
    Application_PresentationNewSlide);
```

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

ThisAddIn 類別的 Application 欄位。 Application 欄位會傳回 Application 物件，代表 PowerPoint 目前的執行個體。
PresentationNewSlide 事件的事件處理常式的 Sld 參數。 Sld 參數是 Slide 物件，代表新投影片。如需詳細資訊，請參閱 PowerPoint 方案。

測試專案

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

若要測試專案

按 F5 建置及執行專案。

當您建置專案時，程式碼會編譯為放置在專案建置輸出資料夾中的組件。 Visual Studio 也會建立一組登錄項目，好讓 PowerPoint 探索和載入增益集，而且會設定開發電腦中的安全性設定以執行增益集。如需詳細資訊，請參閱 Office 方案建置程序概觀。
在 PowerPoint 中，將新投影片加入至現用簡報。
確認下列文字已加入至投影片頂端的新文字方塊中。

This text was added by using code.
關閉 PowerPoint。