チュートリアル: C を使用して Windows フォームコントロールから継承する#

C# では、継承を通じて強力なカスタムコントロールを作成できます。継承により、標準の Windows フォームコントロールに固有のすべての機能を保持するだけでなく、カスタム機能も組み込むコントロールを作成できます。このチュートリアルでは、 ValueButtonと呼ばれる単純な継承コントロールを作成します。このボタンは、標準の Windows フォーム Button コントロールから機能を継承し、 ButtonValueと呼ばれるカスタムプロパティを公開します。

プロジェクトの作成

新しいプロジェクトを作成するときは、ルート名前空間、アセンブリ名、プロジェクト名を設定し、既定のコンポーネントが正しい名前空間に含まれるように、その名前を指定します。

ValueButtonLib コントロールライブラリと ValueButton コントロールを作成するには

Visual Studio で、新しい Windows フォームコントロールライブラリプロジェクトを 作成し、 ValueButtonLib という名前を付けます。

プロジェクト名 ValueButtonLibは、既定でルート名前空間にも割り当てられます。ルート名前空間は、アセンブリ内のコンポーネントの名前を修飾するために使用されます。たとえば、2 つのアセンブリに ValueButton という名前のコンポーネントが用意されている場合は、ValueButtonを使用してValueButtonLib.ValueButton コンポーネントを指定できます。詳細については、「名前空間」を参照してください。
ソリューションエクスプローラーでUserControl1.cs右クリックし、ショートカットメニューから [名前の変更] を選択します。ファイル名を ValueButton.csに変更します。コード要素 '' へのすべての参照の名前を変更するかどうかを確認するメッセージが表示されたら、[UserControl1] ボタンをクリックします。
ソリューションエクスプローラーで、ValueButton.csを右クリックし、[コードの表示] を選択します。
classステートメント行を見つけてpublic partial class ValueButtonし、このコントロールの継承元の型をUserControlからButtonに変更します。これにより、継承されたコントロールは、 Button コントロールのすべての機能を継承できます。
ソリューションエクスプローラーでValueButton.cs ノードを開き、デザイナーによって生成されたコードファイル (ValueButton.Designer.cs) を表示します。 コードエディターでこのファイルを開きます。
InitializeComponentメソッドを見つけて、AutoScaleMode プロパティを割り当てる行を削除します。このプロパティは、 Button コントロールには存在しません。
[ ファイル ] メニューの [ すべて保存] を選択してプロジェクトを保存します。

注

ビジュアルデザイナーは使用できなくなりました。 Button コントロールは独自の描画を行うため、デザイナーでその外観を変更することはできません。コードで変更しない限り、そのビジュアル表現は継承するクラス (つまり、 Button) とまったく同じになります。 UI 要素のないコンポーネントをデザインサーフェイスに追加することもできます。

継承したコントロールにプロパティを追加する

継承された Windows フォームコントロールの 1 つの使用可能な用途は、標準の Windows フォームコントロールの外観は同じですが、カスタムプロパティを公開するコントロールの作成です。このセクションでは、 ButtonValue というプロパティをコントロールに追加します。

Value プロパティを追加するには

ソリューションエクスプローラーで、ValueButton.csを右クリックし、ショートカットメニューの [コードの表示] をクリックします。
class ステートメントを見つけます。 {の直後に、次のコードを入力します。
```
// Creates the private variable that will store the value of your
// property.
private int varValue;
// Declares the property.
public int ButtonValue
{
   // Sets the method for retrieving the value of your property.
   get
   {
      return varValue;
   }
   // Sets the method for setting the value of your property.
   set
   {
      varValue = value;
   }
}
```
このコードでは、 ButtonValue プロパティの格納と取得に使用するメソッドを設定します。 get ステートメントは、プライベート変数varValueに格納されている値に返される値を設定し、set ステートメントは、value キーワードを使用してプライベート変数の値を設定します。
[ ファイル ] メニューの [ すべて保存] を選択してプロジェクトを保存します。

コントロールをテストする

コントロールはスタンドアロンプロジェクトではありません。これらはコンテナーでホストされている必要があります。コントロールをテストするには、コントロールを実行するためのテストプロジェクトを指定する必要があります。また、テストプロジェクトをビルド (コンパイル) して、コントロールにアクセスできるようにする必要があります。このセクションでは、コントロールをビルドし、Windows フォームでテストします。

コントロールを構築するには

[ビルド] メニューの [ソリューションのビルド] をクリックします。ビルドは、コンパイラエラーや警告なしで成功するはずです。

テストプロジェクトを作成するには

[ ファイル ] メニューの [ 追加 ] をポイントし、[ 新しいプロジェクト ] をクリックして [ 新しいプロジェクトの追加 ] ダイアログボックスを開きます。
Visual C# ノードの下にある Windows ノードを選択し、[Windows フォームアプリケーション] をクリックします。
[ 名前 ] ボックスに「 テスト」と入力します。
ソリューションエクスプローラーで、テストプロジェクトの [参照] ノードを右クリックし、ショートカットメニューから [参照の追加] を選択して [参照の追加] ダイアログボックスを表示します。
[ プロジェクト] というラベルの付いたタブをクリックします。 ValueButtonLib プロジェクトがプロジェクト名の下に表示されます。プロジェクトをダブルクリックして、テストプロジェクトへの参照を追加します。
ソリューションエクスプローラーで、[テスト] を右クリックし、[ビルド] を選択します。

フォームにコントロールを追加するには

ソリューションエクスプローラーでForm1.cs右クリックし、ショートカットメニューから [デザイナーの表示] を選択します。
ツールボックスで、ValueButtonLib コンポーネントを選択します。 ValueButton をダブルクリックします。

フォームに ValueButton が表示されます。
ValueButton を右クリックし、ショートカットメニューから [プロパティ] を選択します。
[ プロパティ ] ウィンドウで、このコントロールのプロパティを確認します。追加のプロパティ ButtonValue がある点を除き、これらは標準ボタンによって公開されるプロパティと同じであることに注意してください。
ButtonValue プロパティを 5 に設定します。
ツールボックスの [すべての Windows フォーム] タブで、[ラベル] をダブルクリックして、フォームにLabel コントロールを追加します。
フォームの中央にラベルを再配置します。
valueButton1をダブルクリックします。

コードエディターが開き、valueButton1_Click イベントが表示されます。

次のコード行を挿入します。

label1.Text = valueButton1.ButtonValue.ToString();

ソリューションエクスプローラーで、[テスト] を右クリックし、ショートカットメニューから [スタートアッププロジェクトとして設定] を選択します。
[ デバッグ ] メニューの [ デバッグの開始] を選択します。

Form1 が表示されます。
valueButton1をクリックします。

label1に数字 '5' が表示され、継承されたコントロールのButtonValue プロパティが、label1 メソッドを介してvalueButton1_Clickに渡されたことを示しています。したがって、 ValueButton コントロールは標準の Windows フォームボタンのすべての機能を継承しますが、追加のカスタムプロパティを公開します。

こちらも参照ください

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-05-07