カスタム作業ウィンドウ

作業ウィンドウは、通常、Microsoft Office アプリケーションのウィンドウの一方の側にドッキングされるユーザーインターフェイスパネルです。カスタム作業ウィンドウを使用すると、独自の作業ウィンドウを作成し、ユーザーにソリューションの機能にアクセスするための使い慣れたインターフェイスを提供できます。たとえば、インターフェイスには、ドキュメントを変更したり、データソースからデータを表示したりするためのコードを実行するコントロールを含めることができます。

適用対象: このトピックの情報は、Outlook 用 VSTO アドインプロジェクトに適用されます。詳細については、「 Office アプリケーションとプロジェクトの種類で使用できる機能」を参照してください。

注

カスタム作業ウィンドウは、操作ウィンドウとは異なります。操作ウィンドウは、Microsoft Office Word と Microsoft Office Excel のドキュメントレベルのカスタマイズの一部です。詳細については、「操作ウィンドウの概要」を参照してください。

カスタム作業ウィンドウの利点

カスタム作業ウィンドウを使用すると、使い慣れたユーザーインターフェイスに機能を統合できます。 Visual Studio ツールを使用すると、カスタム作業ウィンドウをすばやく作成できます。

使い慣れたユーザーインターフェイス

Microsoft Office システムのアプリケーションのユーザーは、Word の [スタイル] や [書式設定 ] 作業ウィンドウなどの作業ウィンドウの使用に既に慣れている。カスタム作業ウィンドウは、Microsoft Office システムの他の作業ウィンドウと同様に動作します。ユーザーは、カスタム作業ウィンドウをアプリケーションウィンドウのさまざまな側面にドッキングすることも、ウィンドウ内の任意の場所にカスタム作業ウィンドウをドラッグすることもできます。複数のカスタム作業ウィンドウを同時に表示する VSTO アドインを作成でき、ユーザーは各作業ウィンドウを個別に制御できます。

Windows フォームのサポート

Visual Studio の Office 開発ツールを使用して作成するカスタム作業ウィンドウのユーザーインターフェイスは、Windows フォームコントロールに基づいています。使い慣れた Windows フォームデザイナーを使用して、カスタム作業ウィンドウのユーザーインターフェイスを設計できます。 Windows フォームのデータバインディングのサポートを使用して、作業ウィンドウのコントロールにデータソースをバインドすることもできます。

カスタム作業ウィンドウを作成する

基本的なカスタム作業ウィンドウは、次の 2 つの手順で作成できます。

Windows フォームコントロールを UserControl オブジェクトに追加して、カスタム作業ウィンドウのユーザーインターフェイスを作成します。
VSTO アドインの CustomTaskPaneCollection オブジェクトにユーザーコントロールを渡して、カスタム作業ウィンドウをインスタンス化します。このコレクションは、作業ウィンドウの外観を変更し、ユーザーイベントに応答するために使用できる新しい CustomTaskPane オブジェクトを返します。

詳細については、「方法: カスタム作業ウィンドウをアプリケーションに追加する」を参照してください。

ユーザーインターフェイスを作成する

Visual Studio の Office 開発ツールを使用して作成されたすべてのカスタム作業ウィンドウには、 UserControl オブジェクトが含まれています。このユーザーコントロールは、カスタム作業ウィンドウのユーザーインターフェイスを提供します。ユーザーコントロールは、デザイン時または実行時に作成できます。デザイン時にユーザーコントロールを作成する場合は、Windows フォームデザイナーを使用して作業ウィンドウのユーザーインターフェイスを作成できます。

カスタム作業ウィンドウをインスタンス化する

カスタム作業ウィンドウのユーザーインターフェイスを含むユーザーコントロールを作成したら、 CustomTaskPaneをインスタンス化する必要があります。これを行うには、CustomTaskPaneCollection メソッドのいずれかを呼び出して、VSTO アドインのAddにユーザーコントロールを渡します。このコレクションは、CustomTaskPanes クラスのThisAddIn フィールドとして公開されます。次のコード例は、 ThisAddIn クラスから実行することを目的としています。

myUserControl1 = new MyUserControl();
myCustomTaskPane = this.CustomTaskPanes.Add(myUserControl1, "My Task Pane");
myCustomTaskPane.Visible = true;

myUserControl1 = New MyUserControl
myCustomTaskPane = Me.CustomTaskPanes.Add(myUserControl1, "My Task Pane")
myCustomTaskPane.Visible = True

Add メソッドは、新しいCustomTaskPane オブジェクトを返します。このオブジェクトを使用すると、作業ウィンドウの外観を変更したり、ユーザーイベントに応答したりできます。

複数のウィンドウで作業ウィンドウを制御する

カスタム作業ウィンドウは、ユーザーにドキュメントまたはアイテムのビューを表示するドキュメントフレームウィンドウに関連付けられます。作業ウィンドウは、関連付けられたウィンドウが表示されている場合にのみ表示されます。

カスタム作業ウィンドウを表示するウィンドウを決定するには、作業ウィンドウを作成するときに適切な Add メソッドオーバーロードを使用します。

作業ウィンドウをアクティブウィンドウに関連付けるには、 Add メソッドを使用します。
作業ウィンドウを、指定したウィンドウでホストされているドキュメントに関連付けるには、 Add メソッドを使用します。

一部の Office アプリケーションでは、複数のウィンドウが開いているときに作業ウィンドウを作成または表示する場合の明示的な指示が必要です。これにより、コード内のカスタム作業ウィンドウをインスタンス化する場所を検討して、作業ウィンドウがアプリケーション内の適切なドキュメントまたはアイテムと共に表示されるようにすることが重要になります。詳細については、「アプリケーションウィンドウでのカスタム作業ウィンドウの管理」を参照してください。

作業ウィンドウからアプリケーションにアクセスする

ユーザーコントロールからアプリケーションを自動化する場合は、コード内の Globals.ThisAddIn.Application を使用してオブジェクトモデルに直接アクセスできます。静的 Globals クラスは、 ThisAddIn オブジェクトへのアクセスを提供します。このオブジェクトの Application フィールドは、アプリケーションのオブジェクトモデルへのエントリポイントです。

Application オブジェクトのThisAddIn フィールドの詳細については、「プログラム VSTO アドイン」を参照してください。カスタム作業ウィンドウからアプリケーションを自動化する方法を示すチュートリアルについては、「チュートリアル: カスタム作業ウィンドウからアプリケーションを自動実行する」を参照してください。 Globals クラスの詳細については、「Office プロジェクトのオブジェクトへのグローバルアクセス」を参照してください。

作業ウィンドウのユーザーインターフェイスを管理する

作業ウィンドウを作成したら、 CustomTaskPane オブジェクトのプロパティとイベントを使用して作業ウィンドウのユーザーインターフェイスを制御し、ユーザーが作業ウィンドウを変更したときに応答できます。

カスタム作業ウィンドウを表示する

既定では、作業ウィンドウは表示されません。作業ウィンドウを表示するには、 Visible プロパティを true に設定する必要があります。

ユーザーは、作業ウィンドウの隅にある [ 閉じる ] ボタン (X) をクリックすることで、いつでも作業ウィンドウを閉じます。ただし、ユーザーがカスタム作業ウィンドウをもう一度開く既定の方法はありません。ユーザーがカスタム作業ウィンドウを閉じると、そのユーザーはカスタム作業ウィンドウを表示する方法を提供しない限り、その作業ウィンドウをもう一度表示できません。

VSTO アドインでカスタム作業ウィンドウを作成する場合は、ユーザーがクリックしてカスタム作業ウィンドウを表示または非表示にできる UI 要素 (ボタンなど) も作成する必要があります。リボンのカスタマイズをサポートするカスタム作業ウィンドウを Microsoft Office アプリケーションで作成する場合は、カスタム作業ウィンドウを表示または非表示にするボタンを使用して、コントロールグループをリボンに追加できます。この方法を示すチュートリアルについては、「チュートリアル: カスタム作業ウィンドウをリボンボタンと同期する」を参照してください。

リボンのカスタマイズをサポートしていない Microsoft Office アプリケーションでカスタム作業ウィンドウを作成する場合は、カスタム作業ウィンドウを表示または非表示にする CommandBarButton を追加できます。

作業ウィンドウの外観を変更する

CustomTaskPane オブジェクトのプロパティを使用して、カスタム作業ウィンドウのサイズと場所を制御できます。カスタム作業ウィンドウに含まれる UserControl オブジェクトのプロパティを使用して、カスタム作業ウィンドウの外観に他の多くの変更を加えることができます。たとえば、ユーザーコントロールの BackgroundImage プロパティを使用して、カスタム作業ウィンドウの背景イメージを指定できます。

次の表に、 CustomTaskPane プロパティを使用してカスタム作業ウィンドウに加えることができる変更を示します。

Task	プロパティ
作業ウィンドウのサイズを変更するには	Height Width
作業ウィンドウの場所を変更するには	DockPosition
作業ウィンドウを表示・非表示にするには	Visible
ユーザーが作業ウィンドウの場所を変更できないようにするには	DockPositionRestrict

カスタム作業ウィンドウイベントをプログラムする

ユーザーがカスタム作業ウィンドウを変更したときに VSTO アドインが応答するようにしたい場合があります。たとえば、ユーザーがウィンドウの向きを垂直方向から水平方向に変更する場合は、コントロールの位置を変更できます。

次の表に、ユーザーがカスタム作業ウィンドウに加えた変更に対応するために処理できるイベントを示します。

Task	Event
ユーザーが作業ウィンドウの場所を変更したときに応答します。	DockPositionChanged
ユーザーが作業ウィンドウを非表示にしたとき、または作業ウィンドウを表示したときに応答します。	VisibleChanged

作業ウィンドウで使用されるリソースをクリーンアップする

カスタム作業ウィンドウを作成した後、VSTO アドインが実行されている限り、 CustomTaskPane オブジェクトはメモリ内に残ります。ユーザーが作業ウィンドウの隅にある [閉じる ] ボタン (X) をクリックしても、オブジェクトはメモリ内に残ります。

VSTO アドインの実行中に作業ウィンドウで使用されるリソースをクリーンアップするには、 Remove または RemoveAt メソッドを使用します。これらのメソッドは、指定した CustomTaskPane オブジェクトを CustomTaskPanes コレクションから削除し、オブジェクトの Dispose メソッドを呼び出します。

Visual Studio Tools for Office ランタイムは、VSTO アドインがアンロードされたときに、カスタム作業ウィンドウで使用されるリソースを自動的にクリーンアップします。プロジェクトのRemove イベントハンドラーでRemoveAtまたはThisAddIn_Shutdownメソッドを呼び出さないでください。これらのメソッドはObjectDisposedExceptionをスローします。というのも、Visual Studio Tools for Office ランタイムは、ThisAddIn_Shutdownが呼び出される前にCustomTaskPaneオブジェクトによって使用されたリソースをクリーンアップするからです。 ThisAddIn_Shutdownの詳細については、「Office プロジェクトのイベント」を参照してください。

複数のアプリケーションウィンドウでカスタム作業ウィンドウを管理する

複数のウィンドウを使用してドキュメントやその他のアイテムを表示するカスタム作業ウィンドウをアプリケーションで作成する場合は、ユーザーが作業ウィンドウを予期したときに作業ウィンドウが確実に表示されるように、追加の手順を実行する必要があります。

すべてのアプリケーションのカスタム作業ウィンドウは、ユーザーにドキュメントまたはアイテムのビューを表示するドキュメントフレームウィンドウに関連付けられます。作業ウィンドウは、関連付けられたウィンドウが表示されている場合にのみ表示されます。ただし、すべてのアプリケーションでドキュメントフレームウィンドウが同じように使用されるわけではありません。

次のアプリケーショングループには、異なる開発要件があります。

アウトルック
Word、InfoPath、およびPowerPoint

前途

Outlook 用のカスタム作業ウィンドウを作成すると、カスタム作業ウィンドウは特定のエクスプローラーまたはインスペクターウィンドウに関連付けられます。エクスプローラーはフォルダーの内容を表示するウィンドウで、インスペクターはメールメッセージやタスクなどのアイテムを表示するウィンドウです。

複数のエクスプローラーウィンドウまたはインスペクターウィンドウでカスタム作業ウィンドウを表示する場合は、エクスプローラーまたはインスペクターウィンドウが開いたときにカスタム作業ウィンドウの新しいインスタンスを作成する必要があります。これを行うには、エクスプローラーまたはインスペクターウィンドウの作成時に発生するイベントを処理し、イベントハンドラーで作業ウィンドウを作成します。エクスプローラーとインスペクターのイベントを処理して、表示されているウィンドウに応じて作業ウィンドウを非表示または表示することもできます。

作業ウィンドウを特定のエクスプローラーまたはインスペクターに関連付けるには、 Add メソッドを使用して作業ウィンドウを作成し、 Explorer または Inspector オブジェクトを ウィンドウ パラメーターに渡します。カスタム作業ウィンドウの作成の詳細については、「カスタム作業ウィンドウの概要」を参照してください。

NewExplorer
Activate
Close
Deactivate

インスペクターウィンドウの状態を監視するには、次のインスペクター関連のイベントを処理できます。
NewInspector
Activate
Close
Deactivate

Outlook でカスタム作業ウィンドウの複数のインスタンスを禁止する

Outlook ウィンドウにカスタム作業ウィンドウの複数のインスタンスが表示されないようにするには、各ウィンドウを閉じるときに、CustomTaskPanes クラスのThisAddIn コレクションからカスタム作業ウィンドウを明示的に削除します。 RemoveやCloseなど、ウィンドウが閉じられたときに発生するイベントで、Close メソッドを呼び出します。

カスタム作業ウィンドウを明示的に削除しない場合、Outlook ウィンドウにカスタム作業ウィンドウの複数のインスタンスが表示されることがあります。 Outlook ではウィンドウがリサイクルされることがあり、再利用されたウィンドウには、そのウィンドウにアタッチされたカスタム作業ウィンドウへの参照が保持されます。

Word、InfoPath、およびPowerPoint

Word、InfoPath、PowerPointでは、各ドキュメントが異なるドキュメントフレームウィンドウに表示されます。これらのアプリケーションのカスタム作業ウィンドウを作成すると、カスタム作業ウィンドウは特定のドキュメントにのみ関連付けられます。ユーザーが別のドキュメントを開いた場合、前のドキュメントが再び表示されるまで、カスタム作業ウィンドウは非表示になります。

複数のドキュメントを含むカスタム作業ウィンドウを表示する場合は、ユーザーが新しいドキュメントを作成するか、既存のドキュメントを開いたときに、カスタム作業ウィンドウの新しいインスタンスを作成します。これを行うには、ドキュメントの作成時または開くときに発生するイベントを処理し、イベントハンドラーで作業ウィンドウを作成します。また、表示するドキュメントに応じて、ドキュメントイベントを処理して作業ウィンドウを非表示または表示することもできます。

作業ウィンドウを特定のドキュメントウィンドウに関連付けるには、Add メソッドを使用して作業ウィンドウを作成し、Window WindowObject (Word の場合)、 (InfoPath の場合)、または DocumentWindow (PowerPoint) を渡します。

Word イベント

Word でドキュメントウィンドウの状態を監視するには、次のイベントを処理できます。

InfoPath イベント

InfoPath でドキュメントウィンドウの状態を監視するには、次のイベントを処理します。

PowerPoint イベント

PowerPointでドキュメントウィンドウの状態を監視するには、次のイベントを処理できます。

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-12-12