チュートリアル : コントロール用のカスタム ツールボックス アイコンの作成

更新 : 2007 年 11 月

このチュートリアルでは、Windows Presentation Foundation (WPF) カスタム コントロール用のツールボックス アイコンを作成する方法について説明します。カスタム コントロールをツールボックスに追加すると、このアイコンがコントロールの名前の横に表示されます。

このチュートリアルでは次のタスクを行います。

  • WPF カスタム コントロール ライブラリ プロジェクトを作成する。

  • コントロールのツールボックス アイコンに使用するカスタム ビットマップ ファイルを作成する。

  • デザイン時にコントロールをテストする。

このチュートリアルを終了すると、カスタム コントロール用のツールボックス アイコンを作成する方法を習得できます。

Cc165606.alert_note(ja-jp,VS.90).gifメモ :

実際に画面に表示されるダイアログ ボックスやメニュー コマンドは、アクティブな設定やエディションによっては、ヘルプの説明と異なる場合があります。設定を変更するには、[ツール] メニューの [設定のインポートとエクスポート] をクリックします。詳細については、「Visual Studio の設定」を参照してください。

前提条件

このチュートリアルを実行するには、次のコンポーネントが必要です。

  • Visual Studio 2008

カスタム ツールボックス アイコンの作成

コントロール用のカスタム ツールボックス アイコンを作成するには、コントロールのプロジェクトに埋め込みリソースとしてイメージを追加します。

カスタム ツールボックス アイコンを作成するには

  1. Visual Basic または Visual C# で CustomControlWithToolboxIcon という名前の新しい WPF カスタム コントロール ライブラリ プロジェクトを作成します。

    コード エディタで CustomControl1 のコードが開きます。

  2. [プロジェクト] メニューの [新しい項目の追加] をクリックします。

    [新しい項目の追加] ダイアログ ボックスが表示されます。

  3. [新しい項目の追加] ダイアログ ボックスで、[全般] カテゴリをクリックします。

  4. [テンプレート] ペインで [ビットマップ ファイル] を選択し、新しいファイルに CustomControl1.Icon.bmp という名前を付けて、[追加] をクリックします。イメージ エディタが開きます。

  5. [プロパティ] ウィンドウで、ビットマップの Colors プロパティを [24 ビット] に設定します。

  6. イメージ エディタの各種ツールを使用して、ビットマップでイメージを描画します。詳細については、「イメージ エディタ」を参照してください。

  7. ソリューション エクスプローラで CustomControl1.Icon.bmp を選択します。

  8. [プロパティ] ウィンドウで、[ビルド アクション] プロパティを [埋め込まれたリソース] に設定します。

  9. ソリューションをビルドします。

    詳細については、「ツールボックス アイコンと埋め込みリソース」を参照してください。

ツールボックス アイコンのテスト

カスタム ツールボックス アイコンをテストするには、ツールボックスに CustomControl1 を追加します。

ツールボックス アイコンをテストするには

  1. Visual Basic または Visual C# で TestApplication という名前の新しい WPF アプリケーション プロジェクトをソリューションに追加します。

    WPF デザイナで Window1.xaml が開きます。

  2. CustomControlWithToolboxIcon プロジェクトへの参照を追加します。

  3. ツールボックスを右クリックし、コンテキスト メニューの [アイテムの選択] をクリックします。

    [ツールボックス アイテムの選択] ダイアログ ボックスが表示されます。

  4. [ツールボックス アイテムの選択] ダイアログ ボックスで、[WPF コンポーネント] タブをクリックします。詳細については、「[ツールボックス アイテムの選択] ダイアログ ボックスの [WPF コンポーネント] タブ」を参照してください。

  5. [参照] をクリックし、CustomControlWithToolboxIcon プロジェクトの bin\Debug フォルダに移動します。

  6. CustomControlWithToolboxIcon.dll をダブルクリックして選択します。

    [ツールボックス アイテムの選択] ダイアログ ボックスに、CustomControlWithToolboxIcon アセンブリの詳細が表示されます。[CustomControl1] にカスタム アイコンが表示されます。

  7. [開く] をクリックします。

    CustomControl1 が、対応するアイコンでツールボックスに表示されます。

参照

処理手順

方法 : アイコンをアセンブリに埋め込む

概念

ツールボックス アイコンと埋め込みリソース

その他の技術情報

基本的な機能拡張という概念