チュートリアル : ツールボックスへのカスタム コンポーネントの自動設定
更新 : 2007 年 11 月
現在開いているソリューションのプロジェクトで定義されたコンポーネントは、[ツールボックス] に自動的に表示され、独自の操作は必要ありません。[ツールボックス] には、[ツールボックス アイテムの選択] ダイアログ ボックス (Visual Studio) を使用してカスタム コンポーネントを手動で設定することもできますが、[ツールボックス] は、ソリューションのビルド出力で次の特徴をすべて備えた項目に対応します。
IComponent を実装する。
ToolboxItemAttribute が false に設定されていない。
DesignTimeVisibleAttribute が false に設定されていない。
.gif "メモ") メモ : |
|---|
[ツールボックス] は参照チェーンに従わないため、ソリューションのプロジェクトで構築されていない項目は表示されません。 |
このチュートリアルでは、構築されたカスタム コンポーネントが [ツールボックス] にどのように自動表示されるかについて説明します。このチュートリアルでは、以下のタスクを行います。
Windows フォーム プロジェクトの作成
カスタム コンポーネントの作成
カスタム コンポーネントのインスタンスの作成
カスタム コンポーネントのアンロードと再読み込み
このチュートリアルでは最終的に、作成したコンポーネントが [ツールボックス] に読み込まれていることを確認します。
| メモ : |
|---|
使用している設定またはエディションによっては、表示されるダイアログ ボックスやメニュー コマンドがヘルプに記載されている内容と異なる場合があります。設定を変更するには、[ツール] メニューの [設定のインポートとエクスポート] をクリックします。詳細については、「Visual Studio の設定」を参照してください。 |
プロジェクトの作成
最初にプロジェクトを作成し、フォームを設定します。
プロジェクトを作成するには
ToolboxExample という名前の Windows ベース アプリケーション プロジェクトを作成します。
詳細については、「方法 : Windows アプリケーション プロジェクトを作成する」を参照してください。
プロジェクトに新しいコンポーネントを追加します。このコンポーネントに「DemoComponent」という名前を付けます。
詳細については、「方法 : 新しいプロジェクト項目を追加する」を参照してください。
プロジェクトをビルドします。
[ツール] メニューの [オプション] 項目をクリックします。[Windows フォーム デザイナ] 項目の [全般] をクリックし、[AutoToolboxPopulate] オプションが [True] に設定されていることを確認します。
カスタム コンポーネントのインスタンスの作成
次に、カスタム コンポーネントのインスタンスをフォームで作成します。[ツールボックス] は新しいコンポーネントに自動的に対応するため、これは、他のコンポーネントやコントロールを作成するのと同じように簡単です。
カスタム コンポーネントのインスタンスを作成するには
プロジェクトのフォームをフォーム デザイナで開きます。
[ツールボックス] で、[ToolboxExample コンポーネント] という新しいタブをクリックします。
このタブをクリックすると、[DemoComponent] が表示されます。
メモ :パフォーマンス上の理由により、[ツールボックス] の自動設定領域のコンポーネントはカスタム ビットマップを表示せず、ToolboxBitmapAttribute はサポートされません。カスタム コンポーネントのアイコンを [ツールボックス] に表示するには、[ツールボックス アイテムの選択] ダイアログ ボックスを使用してコンポーネントを読み込みます。
コンポーネントをフォームにドラッグします。
コンポーネントのインスタンスが作成され、[コンポーネント トレイ] に追加されます。
カスタム コンポーネントのアンロードと再読み込み
[ツールボックス] は、読み込まれた各プロジェクトのコンポーネントに対応し、プロジェクトがアンロードされると、プロジェクトのコンポーネントへの参照が削除されます。
ツールボックスに対するコンポーネントのアンロードと再読み込みの影響を確認するには
プロジェクトをソリューションからアンロードします。
プロジェクトのアンロードの詳細については、「方法 : プロジェクトをアンロードして再読み込みする」を参照してください。保存するかどうかを確認するダイアログ ボックスが表示された場合は、[はい] をクリックします。
ソリューションに新しい Windows アプリケーション プロジェクトを追加します。デザイナでフォームを開きます。
前のプロジェクトの [ToolboxExample コンポーネント] タブは削除されています。
ToolboxExample プロジェクトを再読み込みします。
[ToolboxExample コンポーネント] タブが再表示されます。
次の手順
このチュートリアルでは、[ツールボックス] がプロジェクトのコンポーネントに対応することを説明してきましたが、[ツールボックス] は、コントロールにも対応します。コントロール プロジェクトをソリューションに追加および削除して、独自のカスタム コントロールについても確認してみてください。
参照
処理手順
参照
[全般] ([オプション] ダイアログ ボックス - [Windows フォーム デザイナ])
[ツールボックス アイテムの選択] ダイアログ ボックス (Visual Studio)