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

  • [アーティクル]

更新 : 2007 年 11 月

対象

このトピックの情報は、指定された Visual Studio Tools for Office プロジェクトおよび Microsoft Office のバージョンにのみ適用されます。

プロジェクトの種類

  • ドキュメント レベルのプロジェクト

Microsoft Office のバージョン

  • Word 2007

  • Word 2003

詳細については、「アプリケーションおよびプロジェクトの種類別の使用可能な機能」を参照してください。

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

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

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

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

d6sb8dyb.alert_note(ja-jp,VS.90).gifメモ :

次の手順で参照している 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] をクリックします。

    d6sb8dyb.alert_note(ja-jp,VS.90).gifメモ :

    段落記号はブックマークに含めないようにします。文書に段落記号が表示されていない場合は、[ツール] メニューをクリックし、[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] をクリックします。

次の手順

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

参照

処理手順

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

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

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

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

概念

操作ウィンドウの概要

Bookmark コントロール