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

發行項
09/10/2008

更新：2007 年 11 月

適用於
本主題中的資訊僅適用於指定的 Visual Studio Tools for Office 專案和 Microsoft Office 版本。專案類型文件層級專案 Microsoft Office 版本 Word 2007 Word 2003 如需詳細資訊，請參閱依應用程式和專案類型提供的功能。

本主題中的資訊僅適用於指定的 Visual Studio Tools for Office 專案和 Microsoft Office 版本。

專案類型

文件層級專案

Microsoft Office 版本

Word 2007
Word 2003

如需詳細資訊，請參閱依應用程式和專案類型提供的功能。

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

這個逐步解說會說明以下工作：

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

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

必要條件

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

Visual Studio Tools for Office (Visual Studio 2008 Professional 和 Visual Studio Team System 的選擇性元件)。
Microsoft Office Word 2003 或 Microsoft Office Word 2007。

根據預設會隨所列出的 Visual Studio 版本安裝 Visual Studio Tools for Office。若要查看是否已安裝，請參閱安裝 Visual Studio Tools for Office。

建立專案

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

若要建立新的專案

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

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

將文字和書籤加入至文件

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

若要將文字加入至文件

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

March 21, 2008

Name

Address

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

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

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

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

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

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

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

在 [屬性] 視窗中，將 [Bookmark1] 的 [Name] 屬性變更為 [showName]。
選取 [Address] 這個字，但是不要選取段落標記。
請執行下列其中一個步驟：
- 若為 Word 2003：按一下 [插入] 功能表上的 [書籤]。
- 若為 Word 2007：在功能區的 [插入] 索引標籤中，按一下 [連結] 群組中的 [書籤]。
在 [書籤] 對話方塊的 [書籤名稱] 方塊中輸入 showAddress，再按一下 [加入]。

將控制項加入至執行窗格

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

若要加入執行窗格控制項

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

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

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

屬性

值

Name

getName

Size

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

屬性

值

Name

getAddress

Accepts Return

True

Multiline

True

Size

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

屬性

值

Name

addText

Text

Insert

屬性	值
Name	getName
Size	130, 20

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

屬性	值
Name	addText
Text	Insert

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

在執行窗格中撰寫程式碼，將文字方塊中的文字插入文件中適當的 Bookmark 控制項。您可以使用 Globals 類別，從執行窗格上的控制項存取文件上的控制項。如需詳細資訊，請參閱全域存取 Visual Studio Tools for 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：在 Visual Studio Tools for 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 執行窗格將資料繫結至控制項。
顯示和隱藏執行窗格上的控制項。如需詳細資訊，請參閱逐步解說：根據使用者內容變更執行窗格。

請參閱

工作

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

HOW TO：將執行窗格加入至 Excel 活頁簿

逐步解說：根據使用者內容變更執行窗格

HOW TO：管理執行窗格的控制項配置

概念

執行窗格概觀

書籤控制項

共用方式為