チュートリアル : 操作ウィンドウから文書へのテキストの挿入

更新 : 2007 年 11 月

対象
このトピックの情報は、指定された Visual Studio Tools for Office プロジェクトおよび Microsoft Office のバージョンにのみ適用されます。 プロジェクトの種類 ドキュメント レベルのプロジェクト Microsoft Office のバージョン Word 2007 Word 2003 詳細については、「アプリケーションおよびプロジェクトの種類別の使用可能な機能」を参照してください。

このチュートリアルでは、Microsoft Office Word 文書で操作ウィンドウを作成する方法について説明します。操作ウィンドウには、入力を収集するコントロールと、そのテキストを文書に送信するコントロールがあります。

このチュートリアルでは、次のタスクについて説明します。

• 操作ウィンドウ コントロール上で Windows フォーム コントロールを使用してユーザー インターフェイスをデザインします。

• アプリケーションが開かれたときに操作ウィンドウを表示します。

メモ :
次の手順で参照している 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 文書プロジェクトを作成します。ウィザードで、[新規ドキュメントの作成] をクリックします。詳細については、「方法 : Visual Studio Tools for Office プロジェクトを作成する」を参照してください。

  Visual Studio により、デザイナで新しい Word 文書が開き、My Basic Actions Pane プロジェクトがソリューション エクスプローラに追加されます。

文書へのテキストとブックマークの追加

操作ウィンドウは、文書内のブックマークにテキストを送信します。文書をデザインするには、いくつかのテキストを入力して基本となるフォームを作成します。

文書にテキストを追加するには

• 次のテキストを Word 文書に入力します。

  March 21, 2008

  Name

  Address

  This is an example of a basic actions pane in Word.

文書に Bookmark コントロールを追加するには、Visual Studio でツールボックスからコントロールをドラッグするか、Word で [ブックマーク] ダイアログ ボックスを使用します。

文書に Bookmark コントロールを追加するには

1. ツールボックスの [Word コントロール] タブから Bookmark コントロールを文書にドラッグします。

   [ブックマーク コントロールの追加] ダイアログ ボックスが表示されます。

2. 文書内の "Name" という語を、段落記号は除いて選択し、[OK] をクリックします。

   メモ :
   段落記号はブックマークに含めないようにします。文書に段落記号が表示されていない場合は、[ツール] メニューをクリックし、[Microsoft Office Word ツール] をポイントして、[オプション] をクリックします。[表示] タブをクリックし、[オプション] ダイアログ ボックスの [編集記号の表示] セクションの [段落記号] チェック ボックスをオンにします。

3. [プロパティ] ウィンドウで [Name] プロパティを Bookmark1 から showName に変更します。

4. "Address" という語を、段落記号は除いて選択します。

5. 次のいずれかの操作を実行します。

   • Word 2003 の場合 : [挿入] メニューの [ブックマーク] をクリックします。

   • Word 2007 の場合 : リボンの [挿入] タブの [リンク] で [ブックマーク] をクリックします。

6. [ブックマーク] ダイアログ ボックスで、[ブックマーク名] ボックスに「showAddress」と入力し、[追加] をクリックします。

操作ウィンドウへのコントロールの追加

操作ウィンドウのインターフェイスをデザインするには、プロジェクトに操作ウィンドウ コントロールを追加し、追加した操作ウィンドウ コントロールに Windows フォーム コントロールを追加します。

操作ウィンドウ コントロールを追加するには

1. ソリューション エクスプローラで My Basic Actions Pane プロジェクトを選択します。

2. [プロジェクト] メニューの [新しい項目の追加] をクリックします。

3. [新しい項目の追加] ダイアログ ボックスで [操作ウィンドウ コントロール] をクリックし、コントロールに InsertTextControl という名前を指定して、[追加] をクリックします。

操作ウィンドウ コントロールに Windows フォーム コントロールを追加するには

1. デザイナで操作ウィンドウ コントロールが非表示になっている場合は、InsertTextControl をダブルクリックします。

2. ツールボックスの [コモン コントロール] タブから Label コントロールを操作ウィンドウ コントロールにドラッグします。

3. Label コントロールの Text プロパティを Name に変更します。

4. 操作ウィンドウ コントロールに Textbox コントロールを追加し、以下のプロパティを変更します。

   プロパティ	値
   Name	getName
   Size	130, 20

5. 操作ウィンドウ コントロールに 2 番目の Label コントロールを追加し、Text プロパティを Address に変更します。

6. 操作ウィンドウ コントロールに 2 番目の Textbox コントロールを追加し、以下のプロパティを変更します。

   プロパティ	値
   Name	getAddress
   AcceptsReturn	True
   Multiline	True
   Size	130, 40

7. 操作ウィンドウ コントロールに Button コントロールを追加し、以下のプロパティを変更します。

   プロパティ	値
   Name	addText
   Text	Insert

文書にテキストを挿入するコードの追加

操作ウィンドウで、テキスト ボックスのテキストを文書内の対応する Bookmark コントロールに挿入するコードを記述します。Globals クラスを使用して、操作ウィンドウ上のコントロールから文書上のコントロールにアクセスできます。詳細については、「Visual Studio Tools for Office プロジェクト内のオブジェクトへのグローバル アクセス」を参照してください。

操作ウィンドウから文書内のブックマークにテキストを挿入するには

1. 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;
   }
   

2. C# では、ボタン クリックのイベント ハンドラを追加する必要があります。このコードは、IntializeComponent の呼び出しの後の InsertTextControl コンストラクタに追加できます。イベンド ハンドラの作成方法の詳細については、「方法 : Visual Studio Tools for Office でイベント ハンドラを作成する」を参照してください。

   public InsertTextControl()
   {
       InitializeComponent();
       this.addText.Click += new EventHandler(addText_Click);
   }
   

操作ウィンドウを表示するコードの追加

操作ウィンドウを表示するには、作成したコントロールをコントロール コレクションに追加します。

操作ウィンドウを表示するには

1. ThisDocument クラスで、操作ウィンドウ コントロールの新しいインスタンスを作成します。

   Dim insertText As New InsertTextControl
   

   private InsertTextControl insertText = new InsertTextControl();
   

2. ThisDocument の Startup イベント ハンドラに次のコードを追加します。

   Me.ActionsPane.Controls.Add(insertText)
   

   this.ActionsPane.Controls.Add(insertText);
   

アプリケーションのテスト

文書をテストして、文書を開いたときに操作ウィンドウが開くこと、およびボタンをクリックしたときにテキスト ボックスに入力したテキストがブックマークに挿入されることを確認します。

文書をテストするには

1. F5 キーを押してプロジェクトを実行します。

2. 操作ウィンドウが表示されていることを確認します。

3. 操作ウィンドウ上のテキスト ボックスに自分の名前と住所を入力し、[Insert] をクリックします。

次の手順

次に行う作業は以下のとおりです。

• Excel の操作ウィンドウの作成。詳細については、「方法 : Excel ブックに操作ウィンドウを追加する」を参照してください。

• 操作ウィンドウ上のコントロールへのデータのバインド。詳細については、「チュートリアル : Word の操作ウィンドウ上のコントロールへのデータ バインディング」を参照してください。

• 操作ウィンドウ上のコントロールの表示および非表示。詳細については、「チュートリアル : ユーザー コンテキストに応じた操作ウィンドウの変更」を参照してください。

参照

処理手順

方法 : Word 文書に操作ウィンドウを追加する

方法 : Excel ブックに操作ウィンドウを追加する

チュートリアル : ユーザー コンテキストに応じた操作ウィンドウの変更

方法 : アクション ペイン上のコントロールのレイアウトを管理する

概念

操作ウィンドウの概要

Bookmark コントロール