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

發行項
02/28/2013

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

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

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

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

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

必要條件

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

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

Word 2013 或 Word 2010。

建立專案

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

若要建立新的專案

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

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

將文字和書籤加入至文件

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

若要將文字加入至文件

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

2008 年 3 月 21 日

名稱

Address

這是 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] 控制項加入至執行窗格控制項，並變更下列屬性。

屬性

值

名稱

getName

Size

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

屬性

值

名稱

getAddress

Accepts Return

True

Multiline

True

Size

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

屬性

值

名稱

addText

文字

Insert

屬性	值
名稱	getName
Size	130, 20

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

屬性	值
名稱	addText
文字	Insert

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

在執行窗格中撰寫程式碼，將文字方塊中的文字插入文件中適當的 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: Add an Actions Pane to Excel Workbooks。
將資料繫結至執行窗格上的控制項。如需詳細資訊，請參閱逐步解說：在 Word 執行窗格將資料繫結至控制項。

請參閱

共用方式為