【Word改造】最初のアドインを作成してみた

福田寅成

2014.11.07

この記事は公開されてから1年以上経過しています。情報が古い可能性がありますので、ご注意ください。

Wordドキュメントの作成

これまで当ブログにおいてExcelの改造をいくつか行ってきました。「お客様向けのAWS仕様書作成コストを下げたい」というモチベーションから行ってきたものになります。Office関連の課題として「お客様向けのPDFを作成する際にWordベースで文書を作成し、PDFで出力する」際の文書の作成コストがあると思います。

同じような文書を作成するケースは多く、できれば自動化したいと日頃考えていました。

Excelの改造に慣れてきたので、今回はWordのアドオンをまずは簡単なものから作成て、Word改造の雰囲気を掴んで行きたいと思います。

開発環境

Windows 8.1
Visual Studio 2012(C#)
Word 2013
AWS SDK for .NET 2.3.5

Wordアドインプロジェクトの作成

Visual Studioを起動し、Word 2013のアドインプロジェクトを作成します。

AWSWordAddIn 01

プロジェクト名は自由につけてもらって構いません。

★この画面をよく見ると、PowerPointやVisioも改造できそうですね。Officeアドインの情報は特に日本語ではゼロに近く、今のところ手を出せるのはVBAで情報が出ているExcel、Wordあたりと考えています（Web上のExcel VBAのテクニックはExcelアドインにそのまま流用可能でした）

文書を保存した際にテキストを書き込む

下記MSDNのドキュメントではExcelの場合もそうでしたが、最初のサンプルアプリケーションとして文書保存時に処理を行うアプリケーションを作成しています。

Walkthrough: Creating Your First Application-Level Add-in for Word

今回はこのサンプルを動かしてみます。

文書保存イベントハンドラの作成

プロジェクトを作成すると下記のようにファイルが作成されますので、ThisAddIn.csファイルを開いてコードを編集していきます。

AWSWordAddIn 05

コードとしてはアドインの初期化処理である ThisAddIn_Startup イベントで文書保存時のイベント DocumentBeforeSave のイベントハンドラ Application_DocumentBeforeSave を登録します。

        private void ThisAddIn_Startup(object sender, System.EventArgs e)
        {
            this.Application.DocumentBeforeSave += Application_DocumentBeforeSave;
        }

文書保存イベントハンドラでは空のパラグラフを作成し、そのRangeのText（ExcelでいうValue）に任意のテキストを設定しています。

        void Application_DocumentBeforeSave(Word.Document Doc, ref bool SaveAsUI, ref bool Cancel)
        {
            Doc.Paragraphs[1].Range.InsertParagraphBefore();
            Doc.Paragraphs[1].Range.Text = "ハローWordアドイン！";
        }

早速実行してみましょう。（実行時に謎のエラーが出る方は本記事の最後の部分を参照下さい）。Word文書新規作成画面が開くので、ここでは白紙の文書を選択します。

AWSWordAddIn 06