Share via


將執行窗格新增至 Word 文件或 Excel 活頁簿

先建立 Windows Forms 使用者控制項,將動作窗格新增至 Microsoft Office Word 文件或 Microsoft Excel 活頁簿。 然後,將使用者控制項新增至專案中 ThisDocument.ActionsPane 欄位 (Word) 或 ThisWorkbook.ActionsPane 欄位 (Excel) 的 Controls 屬性。

適用對象:本主題資訊適用於 Excel 及 Word 的文件層級專案。 如需詳細資訊,請參閱依 Office 應用程式和專案類型提供的功能

注意

在下列指示的某些 Visual Studio 使用者介面項目中,您的電腦可能會顯示不同的名稱或位置: 您所擁有的 Visual Studio 版本以及使用的設定會決定這些項目。 如需詳細資訊,請參閱將 Visual Studio IDE 個人化

建立使用者控制項

下列程序示範如何在 Word 或 Excel 專案中建立使用者控制項。 它也會將按鈕新增至使用者控制項,以在按下時將文字寫入文件或活頁簿。

建立使用者控制項

  1. 在 Visual Studio 中開啟 Word 或 Excel 文件層級專案。

  2. 在 [專案] 功能表上,按一下 [加入新項目]

  3. 在 [新增項目] 對話方塊中,選取 [動作窗格控制項],將它命名為 HelloControl,然後按一下 [新增]。

    注意

    或者,您可以將 [使用者控制項] 項目新增至專案。 [動作窗格控制項] 和 [使用者控制項] 項目所產生的類別在功能上是等效的。

  4. 從 [工具箱] 的 [Windows Forms] 索引標籤,將 [按鈕] 控制項拖曳到控制項上。

    注意

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

  5. 將程式碼新增至按鈕的 Click 事件處理常式。 下列範例顯示 Microsoft Office Word 文件的程式碼。

    private void button1_Click(object sender, System.EventArgs e)
    {
        Globals.ThisDocument.Paragraphs[1].Range.Text = "Hello World!";
    }
    
  6. 在 C# 中,您必須為按鈕按一下新增事件處理常式。 您可以將此程式碼放在 InitializeComponent 呼叫之後的 HelloControl 建構函式中。

    如需如何建立事件處理常式的詳細資訊,請參閱如何:在 Office 專案中建立事件處理常式

    public HelloControl()
    {
        InitializeComponent();
        this.button1.Click += new EventHandler(this.button1_Click);
    }
    

將使用者控制項新增至動作窗格

若要顯示動作窗格,請將使用者控制項新增至 ThisDocument.ActionsPane 欄位 (Word) 或 ThisWorkbook.ActionsPane 欄位 (Excel) 的 Controls 屬性。

將使用者控制項新增至動作窗格

  1. 將下列程式碼新增至 ThisDocumentThisWorkbook 類別做為類別層級宣告 (請勿將此程式碼新增至方法)。

    private HelloControl hello = new HelloControl();
    
  2. 將下列程式碼新增至 ThisDocument 類別的 ThisDocument_Startup 事件處理常式或 ThisWorkbook 類別的 ThisWorkbook_Startup 事件處理常式。

    this.ActionsPane.Controls.Add(hello);