HOW TO：將執行窗格加入至 Word 文件或 Excel 活頁簿

發行項
02/28/2013

若要將執行窗格加入至 Microsoft Office Word 文件或 Microsoft Excel 活頁簿，請先建立 Windows Forms 使用者控制項。然後，將這個控制項加入至 ThisDocument.ActionsPane 欄位 (Word) 或 ThisWorkbook.ActionsPane 欄位 (Excel) 的 Controls 屬性至您的專案中。

**適用於：**本主題中的資訊適用於下列應用程式的文件層級專案：Excel 2013 和 Excel 2010、Word 2013 和 Word 2010。如需詳細資訊，請參閱依 Office 應用程式和專案類型提供的功能。

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

建立使用者控制項

下列程序示範如何在 Word 或 Excel 專案的使用者控制項。它也會將按鈕時將文字寫入至文件或活頁簿的使用者控制項，當按下它時。

若要建立使用者控制項

開啟您在 Visual Studio 的 Word 或 Excel 文件層級專案。
在 [專案] 功能表上，按一下 [加入新項目]。
在 [加入新項目] 對話方塊中，選取 [執行窗格控制項]，將其命名為 HelloControl，然後按一下 [加入]。

注意事項

或者，您也可以將 [使用者控制項] 項目加入至專案中。[執行窗格控制項] 和 [使用者控制項] 項目所產生的類別具有相同功能。
從 [工具箱] 的 [Windows Forms] 索引標籤中，將 [按鈕] 控制項拖曳至控制項。

注意事項

如果在設計工具中看不到控制項，請按兩下 [方案總管] 中的 [HelloControl]。

注意事項
或者，您也可以將 [使用者控制項] 項目加入至專案中。[執行窗格控制項] 和 [使用者控制項] 項目所產生的類別具有相同功能。

注意事項
如果在設計工具中看不到控制項，請按兩下 [方案總管] 中的 [HelloControl]。

將程式碼加入至按鈕的 Click 事件處理常式。Microsoft Office Word 文件中的下列程式碼範例示範。

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
    Handles Button1.Click

    Globals.ThisDocument.Paragraphs(1).Range.Text = "Hello world!"
End Sub

private void button1_Click(object sender, System.EventArgs e)
{
    Globals.ThisDocument.Paragraphs[1].Range.Text = "Hello World!";
}

在 C# 中，您必須加入按鈕 Click 的事件處理常式。您可以將這個程式碼放在 HelloControl 建構函式 (Constructor) 中 (在 IntializeComponent 呼叫之後)。

如需如何建立事件處理常式的詳細資訊，請參閱 HOW TO：在 Office 專案中建立事件處理常式。
```
public HelloControl()
{
    InitializeComponent();
    this.button1.Click += new EventHandler(this.button1_Click);
}
```

將使用者控制項加入至執行窗格

若要顯示執行窗格，請將使用者控制項加入至 ThisDocument.ActionsPane 欄位 (Word) 或 ThisWorkbook.ActionsPane 欄位 (Excel) 的 Controls 屬性。

若要將使用者控制項加入至執行窗格

將下列程式碼加入至 ThisDocument 或 ThisWorkbook 類別中做為類別層級宣告 (請勿將這個程式碼加入至方法中)。
```
Dim hello As New HelloControl
```
```
private HelloControl hello = new HelloControl();
```
將下列程式碼加入至 ThisDocument 類別的 ThisDocument_Startup 事件處理常式或 ThisWorkbook 類別的 ThisWorkbook_Startup 事件處理常式。
```
Me.ActionsPane.Controls.Add(hello)
```
```
this.ActionsPane.Controls.Add(hello);
```