Office ドキュメントでの Windows フォーム コントロールの概要

  • [アーティクル]

Windows フォーム コントロールは、データを入力または操作するときにユーザーが取り扱うオブジェクトです。 Microsoft Office Excel および Microsoft Office Word のドキュメント レベルのプロジェクトでは、デザイン時に Windows フォーム コントロールをプロジェクトのドキュメントまたはブックに追加したり、実行時にこれらのコントロールをプログラミングで追加したりできます。 Excel または Word 用の VSTO アドインでは、実行時に開いているドキュメントやワークシートにこれらのコントロールをプログラムで追加できます。

詳細については、「方法: Office ドキュメントに Windows フォーム コントロールを追加する」を参照してください。

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

Windows フォーム コントロールを使用する

Windows フォーム コントロールをドキュメントに、あるいは操作ウィンドウ、カスタム作業ウィンドウ、Windows フォームなどのカスタマイズ可能なユーザー インターフェイス (UI) 要素に追加できます。 Windows フォーム コントロールの動作は、ドキュメント上でも上述のその他の UI 要素上でも通常は同じですが、いくつかの相違点が存在します。 詳細については、「Office ドキュメントの Windows フォーム コントロールの制限事項」を参照してください。

Windows フォーム コントロールをドキュメントに追加するか、その他の UI 要素に追加するかは、いくつかの要因を考慮して決定します。 ソリューションの UI を設計する場合は、次の表の説明に従って Windows フォーム コントロールの使用をご検討ください。

ドキュメント上

  • 常時コントロールを表示する場合。

  • ユーザーにドキュメントに直接データを入力させる場合 (たとえば、編集サーフェスがロックされているフォーム ベースのドキュメント)。

  • コントロールをドキュメントのデータに沿って表示する場合。 たとえば、ボタンをリスト オブジェクトの各行に追加する場合、リストの各項目に沿って一直線に配置します。

操作ウィンドウまたはカスタム作業ウィンドウ上

  • コンテキスト情報をユーザーに提供する場合。

  • ドキュメントにクエリのコントロールやデータではなく、結果のみを表示する場合。

  • コントロールがドキュメントに印刷されないようにする場合。

  • コントロールがドキュメントの表示を妨げないようにする場合。

Windows フォーム上

  • UI のサイズを制御する場合。

  • ユーザーがコントロールを非表示にしたり、削除したりできないようにする場合。

  • ユーザーから入力を取得し、入力を受信するまではユーザーがドキュメントで何も処理できないようにする場合。

プログラムで Windows フォーム コントロールを追加する

実行時に Windows フォーム コントロールを Word 文書や Excel ワークシートに追加できます。 Visual Studio Tools for Office ランタイムには、最も一般的な Windows フォーム コントロールを追加するためのヘルパー メソッドが用意されています。 これらのヘルパー メソッドを使用すると、コントロールを Office ドキュメントにすばやく追加して、Windows フォーム コントロールの機能とこれらのコントロールの Office 関連機能とを組み合わせたものにアクセスできます。

詳細については、「実行時に Office 文書にコントロールを追加する」を参照してください。

ドキュメント レベルのプロジェクトで Windows フォーム コントロールを使用する

ドキュメントでの Windows フォーム コントロールの使用方法のいくつかは、ドキュメント レベルのプロジェクトに固有です。これらにより、Visual Studio デザイナーを使用してドキュメントの UI をデザインできます。

カスタム ユーザー コントロールを作成する

ユーザー コントロールをプロジェクトに追加してから、それを ツールボックスに追加します。 ドキュメントに Windows フォーム コントロールを追加するのと同じ方法で、ドキュメントにユーザー コントロールを直接ドラッグできます。 ユーザー コントロールを作成するときには、以下の点にご注意ください。

  • sealed ユーザー コントロールは作成しないでください。 ドキュメントにコントロールをドラッグすると、Visual Studio はユーザー コントロールから派生するラッパー クラスを生成して、そのクラスを拡張したり、ドキュメントでの使用をサポートしたりします。 ユーザー コントロールが sealedである場合、Visual Studio はラッパー クラスを生成することができません。

  • ユーザー コントロールでは、 ComVisibleAttribute 属性を true」を参照してください。 Office プロジェクト内で作成されたユーザー コントロールでは、この属性は既定で true に設定されますが、プロジェクト外部のユーザー コントロールでは、この属性は trueに設定されていない場合があります。

  • ユーザー コントロールをドキュメントに追加した後は、 UserControl クラスの名前を変更したり、プロジェクトから削除したりしないでください。 ユーザー コントロールの名前を変更する必要がある場合は、ドキュメントからまず削除し、名前を変更した後でもう一度追加する必要があります。

デザイン時にコントロールを配置する

デザイン時に Word および Excel のドキュメントに複数のコントロールを追加する場合、Visual Studio の Microsoft Office Word および Microsoft Office Excel ツール バーを使用して、選んだすべてのコントロールの配置をすばやく設定することができます。 これらのツール バーは、ドキュメントまたはワークシートがデザイナーで開かれている場合にのみ使用できます。

デザイナーで複数のコントロールを選ぶ場合、コントロールを配置するために、それらのツール バーにある以下のボタンを使用できます。

  • [左揃え]

  • [中央揃え]

  • [右揃え]

  • [上揃え]

  • [上下中央揃え]

  • [下揃え]

  • 左右の間隔を均等にする

  • 上下の間隔を均等にする

Note

Word プロジェクトでは、選んだコントロールが行内にない場合にのみ、これらのボタンが有効になります。 既定では、デザイン時にドキュメントに追加したコントロールは、行内にあります。

読み込み中に古いデータが Excel ブックに表示されないようにする

デザイン時にドキュメントやワークシートに Windows フォーム コントロールを追加すると、ユーザーがドキュメントを閉じても、コントロールはドキュメント内に残ります。 デザイン時に追加されたコントロールは、 スタティック コントロールとも呼ばれます。

スタティック コントロールが格納されている Excel ブックを開くと、カスタマイズ コードが実行されて実際のコントロールが読み込まれるまで、ブックでは ActiveX コントロールにコントロールのビットマップが表示されます。 Excel はこのビットマップを作成し、ブックが保存されるたびに、このブックにそのビットマップを格納します。 ビットマップには、ブックを最後に保存したときの状態でコントロールが表示され、コントロールに表示されていたすべてのデータも一緒に含められます。 Windows フォーム コントロールとビットマップを含んだ ActiveX コントロールについて詳しくは、「Office ドキュメントでの Windows フォーム コントロールの制限事項」をご覧ください。

ユーザーがデザイン モードでブックを開くとなど特定の条件では、コードは読み込まれず、ビットマップのみが表示されます。 また、Visual Studio Tools for Office ランタイムがインストールされていないコンピューターでユーザーがブックを開く場合、コントロールを読み込むためのカスタマイズは実行できず、コントロールのビットマップのみが表示されます。 個人情報が誤って公開されないようにするため、ブックを保存して別のユーザーに送信する前に、必ず個人情報をブックのコントロールから削除する必要があります。

Excel ワークシートでコントロールのサイズをセルのサイズに一致させる

親のセルのサイズが変更されたときに、自動的にサイズ変更されるようにコントロールを設定することができます。 詳細については、「方法: ワークシートのセル内のコントロールをサイズ変更する」を参照してください。

すべてのワークシートによって共有されるコンポーネントを追加する

DataSetなどすべてのワークシート間で共有するコンポーネントを、ワークシートではなくブックのデザイナーに追加することができます。 このコンポーネントは、コンポーネント トレイに表示されます。

Excel ワークシートにコントロールを埋め込むための数式

Excel 内でコントロールを選択すると、数式バーに =EMBED("WinForms.Control.Host","") と表示されます。 このテキストは必要なので、削除しないでください。

Word ドキュメントのコントロールのレイアウト スタイル

Visual Studio デザイナーを使用してコントロールをドキュメント レベルのプロジェクトの Word 文書に追加する場合、コントロールは行内に追加されます。 コントロールのレイアウト スタイルを変更するには、コントロールを右クリックし、 [コントロールの書式設定]をクリックします。 [オブジェクトの書式設定] ダイアログ ボックスの [レイアウト] ページで折り返しのスタイルを選びます。

実行時にコントロールを Word 文書に追加する場合、ControlCollection クラスの異なる Add<control class> メソッド オーバーロードを使用して新しいコントロールのレイアウト スタイルを指定できます。

  • 行内のコントロールを追加するには、コントロールの場所を指定する Range を受け取るオーバーロードを使用します。

  • 固定されていない図形としてコントロールを追加するには、コントロールの左と上の座標を受け入れるオーバーロードを使用します。

    詳細については、「実行時に Office 文書にコントロールを追加する」を参照してください。

    Visual Studio デザイナーで Word テンプレートを開く場合、Visual Studio でテンプレートが 標準 表示で開かれるために、テンプレートのインラインでないコントロールを表示できない可能性があります。 コントロールを表示するには、表示を 印刷レイアウトに変更します。

ドキュメントの本体外のコントロール

Windows フォーム コントロールは、ヘッダーまたはフッター内、あるいはサブドキュメント内ではサポートされません。

デザイン時にコンポーネントを追加する

特定のコントロールやコンポーネントは、ドキュメントに表示されずに、コンポーネント トレイに表示されます。 Visual Studio では、各ドキュメント ウィンドウに対して 1 つのコンポーネント トレイが提供されます。 コンポーネント トレイは、コンポーネントがドキュメントに存在する場合にのみ画面に表示されます。

関連するコンテンツ