チュートリアル : コントロール用のカスタム ツールボックス アイコンの作成
更新 : 2007 年 11 月
このチュートリアルでは、Windows Presentation Foundation (WPF) カスタム コントロール用のツールボックス アイコンを作成する方法について説明します。カスタム コントロールをツールボックスに追加すると、このアイコンがコントロールの名前の横に表示されます。
このチュートリアルでは次のタスクを行います。
WPF カスタム コントロール ライブラリ プロジェクトを作成する。
コントロールのツールボックス アイコンに使用するカスタム ビットマップ ファイルを作成する。
デザイン時にコントロールをテストする。
このチュートリアルを終了すると、カスタム コントロール用のツールボックス アイコンを作成する方法を習得できます。
メモ : |
---|
実際に画面に表示されるダイアログ ボックスやメニュー コマンドは、アクティブな設定やエディションによっては、ヘルプの説明と異なる場合があります。設定を変更するには、[ツール] メニューの [設定のインポートとエクスポート] をクリックします。詳細については、「Visual Studio の設定」を参照してください。 |
前提条件
このチュートリアルを実行するには、次のコンポーネントが必要です。
- Visual Studio 2008
カスタム ツールボックス アイコンの作成
コントロール用のカスタム ツールボックス アイコンを作成するには、コントロールのプロジェクトに埋め込みリソースとしてイメージを追加します。
カスタム ツールボックス アイコンを作成するには
Visual Basic または Visual C# で CustomControlWithToolboxIcon という名前の新しい WPF カスタム コントロール ライブラリ プロジェクトを作成します。
コード エディタで CustomControl1 のコードが開きます。
[プロジェクト] メニューの [新しい項目の追加] をクリックします。
[新しい項目の追加] ダイアログ ボックスが表示されます。
[新しい項目の追加] ダイアログ ボックスで、[全般] カテゴリをクリックします。
[テンプレート] ペインで [ビットマップ ファイル] を選択し、新しいファイルに CustomControl1.Icon.bmp という名前を付けて、[追加] をクリックします。イメージ エディタが開きます。
[プロパティ] ウィンドウで、ビットマップの Colors プロパティを [24 ビット] に設定します。
イメージ エディタの各種ツールを使用して、ビットマップでイメージを描画します。詳細については、「イメージ エディタ」を参照してください。
ソリューション エクスプローラで CustomControl1.Icon.bmp を選択します。
[プロパティ] ウィンドウで、[ビルド アクション] プロパティを [埋め込まれたリソース] に設定します。
ソリューションをビルドします。
詳細については、「ツールボックス アイコンと埋め込みリソース」を参照してください。
ツールボックス アイコンのテスト
カスタム ツールボックス アイコンをテストするには、ツールボックスに CustomControl1 を追加します。
ツールボックス アイコンをテストするには
Visual Basic または Visual C# で TestApplication という名前の新しい WPF アプリケーション プロジェクトをソリューションに追加します。
WPF デザイナで Window1.xaml が開きます。
CustomControlWithToolboxIcon プロジェクトへの参照を追加します。
ツールボックスを右クリックし、コンテキスト メニューの [アイテムの選択] をクリックします。
[ツールボックス アイテムの選択] ダイアログ ボックスが表示されます。
[ツールボックス アイテムの選択] ダイアログ ボックスで、[WPF コンポーネント] タブをクリックします。詳細については、「[ツールボックス アイテムの選択] ダイアログ ボックスの [WPF コンポーネント] タブ」を参照してください。
[参照] をクリックし、CustomControlWithToolboxIcon プロジェクトの bin\Debug フォルダに移動します。
CustomControlWithToolboxIcon.dll をダブルクリックして選択します。
[ツールボックス アイテムの選択] ダイアログ ボックスに、CustomControlWithToolboxIcon アセンブリの詳細が表示されます。[CustomControl1] にカスタム アイコンが表示されます。
[開く] をクリックします。
CustomControl1 が、対応するアイコンでツールボックスに表示されます。