1. [ファイル] メニューの [新規作成] をポイントし、[プロジェクト] をクリックして [新しいプロジェクト] ダイアログ ボックスを表示します。

2. [Visual J# プロジェクト] ボックスの一覧の [Windows コントロール ライブラリ] プロジェクト テンプレートをクリックし、[プロジェクト名] ボックスに「ctlClockLib」と入力します。

   既定では、ctlClockLib というプロジェクト名がルート パッケージにも割り当てられます。ルート パッケージは、アセンブリ内のコンポーネントの名前を限定するために使用されます。たとえば、ctlClock という名前のコンポーネントが 2 つのアセンブリに含まれる場合は、ctlClockLib.ctlClock という形で目的の ctlClock コンポーネントを指定できます。

3. ソリューション エクスプローラで UserControl1.jsl を右クリックし、ショートカット メニューの [コードの表示] をクリックします。

4. ソリューション エクスプローラで、UserControl1.jsl を右クリックし、[名前の変更] をクリックします。名前を UserControl1.jsl から ctlClock.jsl に変更します。

5. クラス定義とクラス コンストラクタを調べて、それぞれの名前が public class UserControl1 から public class ctlClock、public UserControl1() から public ctlClock() に変更されていることを確認します。

6. [ファイル] メニューの [すべてを保存] をクリックして、プロジェクトを保存します。

1. ソリューション エクスプローラで ctlClock.jsl を右クリックし、[デザイナの表示] をクリックします。

2. ツールボックスの [すべての Windows フォーム] タブをクリックし、[label] をダブルクリックします。

   label1 という名前のラベル コントロールが、ユーザー コントロール デザイナのコントロールに追加されます。

3. デザイナで [label1] をクリックします。[プロパティ] ウィンドウで、次のプロパティを設定します。

   プロパティ	変更後の値
   Name	lblDisplay
   Text	(空白)
   TextAlign	MiddleCenter
   Font.Size	14

4. ツールボックスの [すべての Windows フォーム] をクリックし、[Timer] をダブルクリックします。

   タイマはコンポーネントであるため、実行時には表示できる形式を持ちません。そのため、タイマはユーザー コントロール デザイナ上のコントロールと共には表示されず、コンポーネント トレイに表示されます。

5. コンポーネント トレイで、[timer1] をクリックし、Interval プロパティを 1000 に設定し、Enabled プロパティを True に設定します。

   Interval プロパティは、タイマ コンポーネントが時を刻む頻度を制御します。timer1 が時を刻むたびに、timer1_Tick イベントのコードが実行されます。時を刻む間隔は、ミリ秒単位で表します。

6. コンポーネント トレイで、[timer1] をダブルクリックして、ctlClock の timer1_Tick イベントに移動します。

7. コードを次のように変更します。

   // Visual J#
   protected void timer1_Tick (Object sender, System.EventArgs e)
   {
       lblDisplay.set_Text(System.DateTime.get_Now().ToLongTimeString()); 
   }

   このコードは、現在の時刻を lblDisplay に表示します。timer1 の間隔は「1000」に設定されているため、このイベントは 1000 ミリ秒ごとに発生します。したがって、現在の時刻は 1 秒ごとに更新されます。

   既定では、[timer1] のダブルクリックによって追加された timer1_Tick メソッドは、private スコープを持ちます。上のコード セグメントで、このスコープを protected に変更したことに注意してください。

8. [ファイル] メニューの [すべてを保存] をクリックしてプロジェクトを保存します。

1. ソリューション エクスプローラで ctlClock.jsl を右クリックし、ショートカット メニューの [コードの表示] をクリックします。

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

2. public class ctlClock ステートメントを探します。始まりの中かっこ ({) の下に、次のように入力します。

   // Visual J#
   private Color colFColor;
   private Color colBColor;

   これらのステートメントは、これから作成するカスタム プロパティの値を格納するためのプライベート変数を作成します。

3. 前の手順の変数宣言の下に、次のコードを追加します。

   // Visual J#
   /** @property */
   public Color get_ClockBackColor()
   {
       return colBColor;
   }
   /** @property */
   public void set_ClockBackColor(Color value)
   {
       colBColor = value;
       lblDisplay.set_BackColor(colBColor);
   }
   /** @property */
   public Color get_ClockForeColor()
   {
       return colFColor;
   }
   /** @property */
   public void set_ClockForeColor(Color value)
   {
       colFColor = value;
       lblDisplay.set_ForeColor(colFColor);
   }

   上のコードにより、このコントロールの後続のユーザーは、ClockForeColor と ClockBackColor の 2 つのカスタム プロパティを使用できるようになります。get_ ステートメントと set_ ステートメントは、カスタム プロパティの値を格納および取得し、適切な機能を実装するコードです。

4. [ファイル] メニューの [すべてを保存] をクリックしてプロジェクトを保存します。

• [ビルド] メニューの [ソリューションのビルド] をクリックします。

1. [ファイル] メニューの [追加] をポイントし、[新しいプロジェクト] をクリックして [新しいプロジェクトの追加] ウィンドウを開きます。

2. [Windows アプリケーション] をクリックし、[プロジェクト名] ボックスに「Test」と入力します。

3. ソリューション エクスプローラで、Test プロジェクトの [参照設定] ノードを右クリックします。[参照の追加] をクリックして [参照の追加] ダイアログ ボックスを表示します。

4. [プロジェクト] タブをクリックします。[プロジェクト名] ボックスにユーザー コントロール プロジェクトの名前が表示されます。

   プロジェクトをダブルクリックします。これで ctlClockLib Components という新しいタブがツールボックスに追加されました。

1. デザイン ビューに Form1 を表示した状態で、ツールボックスの [ctlClockLib コンポーネント] をクリックし、[ctlClock] を表すコントロール アイコンが表示されるまで、下にスクロールします。

2. [ctlClock] アイコンをダブルクリックします。

   コントロールのコピーがフォームに追加されます。このコントロールには現在の時刻が表示され、毎秒ごとに更新されます。

3. アイコンを選択し、フォーム上にマウスを移動します。

4. フォーム上でマウスを移動する間、マウスの左ボタンを押したままにします。

   コントロールのコピーがもう 1 つフォーム上に作成されます。必要に応じて、タイマのコピーをいくつでもフォームに追加できます。

5. デザイナで ctlClock のインスタンスの 1 つをクリックします。

   このインスタンスのプロパティが [プロパティ] ウィンドウに表示されます。

6. [プロパティ] ウィンドウで ClockBackColor プロパティを選択して、カラー パレットを表示します。

7. 任意の色をクリックして選択します。

   コントロールの背景色が、選択した色に変更されます。

8. 同様なイベントのシーケンスを使用して、ClockForeColor プロパティが予想どおりに機能することを確認します。

9. F5 キーを押し、[ユーザー コントロール テスト コンテナ] ウィンドウでこのコントロールを実行します。UserControl TestContainer の詳細については、「方法 : UserControl の実行時の動作をテストする」を参照してください。

10. [ユーザー コントロール テスト コンテナ] を閉じるには、[閉じる] をクリックします。

継承コントロールの作成の最初の手順は、親コントロールからの派生です。これにより、親コントロールのプロパティ、メソッド、およびグラフィカル特性をすべて持つ新しいコントロールが作成されます。このコントロールに基づいて、新しい機能を追加したり機能を変更したりできます。

継承コントロールを作成するには

ユーザー コントロールにプロパティを追加する場合と同じ方法で、継承コントロールにプロパティを追加できます。ここでは、プロパティ宣言構文を使って、コントロールに 2 つのプロパティを追加します。

• AlarmTime は、アラームが鳴り出す日付と時刻の値を格納します。

• AlarmSet は、アラームが設定されているかどうかを示します。

ユーザー コントロールにプロパティを追加するには

継承したコントロールには、継承元のコントロールと同じビジュアル インターフェイスがあります。継承したコントロールには親コントロールと同じ内在コントロールがありますが、内在コントロールのプロパティは特に公開されない限り使用できません。任意のユーザー コントロールに追加する場合と同じ方法で、継承されたユーザー コントロールのグラフィカル インターフェイスに追加できます。引き続き、アラーム クロックのビジュアル インターフェイスに、アラームが鳴ったときに点滅するラベル コントロールを追加します。

ラベル コントロールを追加するには

前のセクションでは、ユーザー コントロールのアラーム機能を使用できるようにするカスタム メンバおよびコントロールを追加しました。このセクションでは、現在の時刻とアラームの時刻を比較し、一致した場合は、アラームを点滅させるコードを追加します。ctlClock の timer1_Tick メソッドをオーバーライドして、ctlClock の固有の機能をすべて維持したまま、ctlAlarmClock の機能を拡張します。

ctlClock の timer1_Tick メソッドをオーバーライドするには

このコードを追加することで、いくつかのタスクが実行されます。これにより、基本コントロールから継承したメソッドの代わりに、このメソッドがコントロールで使用されます。このメソッドを呼び出した場合、super.timer1_Tick ステートメントが呼び出されて、元のコントロールに組み込まれていたすべての機能がこのコントロールで再生されます。次に、追加のコードが実行され、アラーム機能が組み込まれます。アラームが作動すると、点滅するラベル コントロールが表示されます。

アラーム クロック コントロールは、ほとんど完成しています。後は、アラームを止める手段を実装するだけです。この方法を実装するには、ボタンを追加し、btnAlarmOff_Click メソッドにコードを追加します。

アラームを止める手段を実装するには

標準ユーザー コントロールと同様に、継承ユーザー コントロールはスタンドアロン型ではないため、フォームまたは他のコンテナでホストする必要があります。ctlAlarmClock には他にも機能があるため、テストを実行するには追加のコードが必要です。ここでは、ctlAlarmClock の機能をテストするための簡単なプログラムを記述します。ctlAlarmClock の AlarmTime プロパティを設定および表示するコードを作成し、固有の機能をテストします。

コントロールをビルドしてテスト フォームに追加するには

このチュートリアルでは、多数の重要な概念を扱いました。ユーザー コントロール コンテナにコントロールやコンポーネントを組み込んでユーザー コントロールを作成する方法を学びました。また、コントロールにプロパティを追加する方法や、カスタム機能を実装するコードを記述する方法も学びました。2 番目のセクションでは、継承によって特定のユーザー コントロールの機能を拡張し、オーバーライドによりホストのメソッドの機能を変更する方法を学びました。