逐步解說：從執行窗格將文字插入文件

發行項
08/12/2011

這個逐步解說示範如何在 Microsoft Office Word 文件中建立執行窗格。執行窗格包含收集輸入後再將文字傳送至文件的兩個控制項。

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

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

在執行窗格控制項上使用 Windows Form 控制項來設計介面。
在應用程式開啟時顯示執行窗格。

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

必要條件

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

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

Word 2007 或 Word 2010。

建立專案

第一步就是建立 Word 文件專案。

若要建立新的專案

建立名為 My Basic Actions Pane 的 Word 文件專案。在精靈中選取 [建立新文件]。如需詳細資訊，請參閱 HOW TO：在 Visual Studio 中建立 Office 專案。

Visual Studio 會在設計工具中開啟新的 Word 文件，並將 [My Basic Actions Pane] 專案加入至 [方案總管]。

將文字和書籤加入至文件

執行窗格會將文字傳送給文件中的書籤。若要設計文件，請輸入一些文字以建立基本表單。

若要將文字加入至文件

在 Word 文件中輸入下列文字：

2008 年 3 月 21 日

名稱

地址

這是 Word 中的基本執行窗格範例。

您可以拖曳 Visual Studio [工具箱] 中的 Bookmark 控制項，或使用 Word 中的 [書籤] 對話方塊，將控制項加入至文件。

若要將書籤控制項加入至文件

從 [工具箱] 的 [Word 控制項] 索引標籤，拖曳 Bookmark 控制項至您的文件。

[加入書籤控制項] 對話方塊隨即出現。

選取 [名稱] 這個字，但是不要選取段落標記，然後按一下 [確定]。

注意事項
段落標記應該在書籤之外。如果在文件中未看見段落標記，請按一下 [工具] 功能表，指向 [Microsoft Office Word 工具]，然後按一下 [選項]。按一下 [檢視] 索引標籤，並且在 [選項] 對話方塊的 [格式化標記] 區域中選取 [段落標記] 核取方塊。

在 [屬性] 視窗中，將 [Bookmark1] 的 [Name] 屬性變更為 [showName]。
選取 [地址] 這個字，但是不要選取段落標記。
在功能區的 [插入] 索引標籤上，按一下 [連結] 群組中的 [書籤]。
在 [書籤] 對話方塊的 [書籤名稱] 方塊中輸入 showAddress，再按一下 [加入]。

將控制項加入至執行窗格

若要設計執行窗格介面，請將執行窗格控制項加入至專案，然後將 Windows Form 控制項加入至執行窗格控制項。

若要加入執行窗格控制項

在 [方案總管] 中選取 [My Basic Actions Pane]。
在 [專案] 功能表上，按一下 [加入新項目]。
在 [加入新項目] 對話方塊中，按一下 [執行窗格控制項]，將控制項命名為 InsertTextControl，再按 [加入]。

若要將 Windows Form 控制項加入至執行窗格控制項

如果在設計工具中看不到執行窗格控制項，請按兩下 [InsertTextControl]。
從 [工具箱] 的 [通用控制項] 索引標籤，拖曳 [Label] 控制項至執行窗格控制項。
將標籤控制項的 Text 屬性變更為名稱。
將 [Textbox] 控制項加入至執行窗格控制項，並變更下列屬性。

屬性

值

Name

getName

Size

130, 20
將第二個 [Label] 控制項加入至執行窗格控制項，並將 [Text] 屬性變更為地址。
將第二個 [Textbox] 控制項加入至執行窗格控制項，並變更下列屬性。

屬性

值

Name

getAddress

Accepts Return

True

Multiline

True

Size

130, 40
將 [Button] 控制項加入至執行窗格控制項，並變更下列屬性。

屬性

值

Name

addText

Text

插入

屬性	值
Name	getName
Size	130, 20

屬性	值
Name	getAddress
Accepts Return	True
Multiline	True
Size	130, 40

屬性	值
Name	addText
Text	插入

加入程式碼以將文字插入文件

在執行窗格中撰寫程式碼，將文字方塊中的文字插入文件中適當的 Bookmark 控制項。您可以使用 Globals 類別，從執行窗格上的控制項存取文件上的控制項。如需詳細資訊，請參閱全域存取 Office 專案中的物件。

若要將執行窗格中的文字插入至文件中的書籤

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

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

    If Me.getName.Text <> String.Empty Then
        Globals.ThisDocument.showName.Text = Me.getName.Text
    End If

    If Me.getAddress.Text <> String.Empty Then
        Globals.ThisDocument.showAddress.Text = Me.getAddress.Text
    End If

    Me.getName.Text = String.Empty
    Me.getAddress.Text = String.Empty
End Sub

private void addText_Click(object sender, System.EventArgs e)
{
    if (this.getName.Text != String.Empty) 
    {
        Globals.ThisDocument.showName.Text = this.getName.Text;
    }

    if (this.getAddress.Text != String.Empty)
    {
        Globals.ThisDocument.showAddress.Text = this.getAddress.Text;
    }

    this.getName.Text = String.Empty;
    this.getAddress.Text = String.Empty;
}

在 C# 中，您必須加入按鈕 Click 的事件處理常式。您可以在呼叫 IntializeComponent 之後，將這個程式碼放在 InsertTextControl 建構函式 (Constructor) 中。如需建立事件處理常式的詳細資訊，請參閱 HOW TO：在 Office 專案中建立事件處理常式。
```
public InsertTextControl()
{
    InitializeComponent();
    this.addText.Click += new EventHandler(addText_Click);
}
```

加入程式碼以顯示執行窗格

若要顯示執行窗格，請將建立的控制項加入至控制項集合。

若要顯示執行窗格

在 ThisDocument 類別中建立執行窗格控制項的新執行個體。

Dim insertText As New InsertTextControl

private InsertTextControl insertText = new InsertTextControl();

將下列程式碼加入至 ThisDocument 的 Startup 事件處理常式。

Me.ActionsPane.Controls.Add(insertText)

this.ActionsPane.Controls.Add(insertText);

測試應用程式

測試文件，確認在開啟文件時會開啟執行窗格，並會在按一下按鈕時將輸入文字方塊的文字插入書籤。

若要測試您的文件

請按 F5 執行您的專案。
確認可以看見執行窗格。
將您的名稱和地址輸入執行窗格上的文字方塊，並按一下 [插入]。

後續步驟

以下則是接下來的一些工作：

在 Excel 中建立執行窗格。如需詳細資訊，請參閱 HOW TO：將執行窗格加入至 Excel 活頁簿。
將資料繫結至執行窗格上的控制項。如需詳細資訊，請參閱逐步解說：在 Word 執行窗格將資料繫結至控制項。
顯示和隱藏執行窗格上的控制項。如需詳細資訊，請參閱逐步解說：根據使用者內容變更執行窗格。

請參閱

共用方式為