HOW TO：將執行窗格加入至 Word 文件

發行項
08/12/2011

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

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

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

建立使用者控制項

下列程序顯示如何在 Word 專案中建立使用者控制項。也會將按鈕加入至使用者控制項，以在使用者按一下按鈕時將文字寫入至文件。

若要建立使用者控制項

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

注意事項

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

注意事項

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

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

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

將下列程式碼加入至按鈕的 Click 事件處理常式。

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 欄位的 Controls 屬性中。

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

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