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