例を使用した C# Windows フォーム アプリケーションのチュートリアル

これまで、C# を使用してコンソール ベースのアプリケーションを作成する方法を見てきました。しかし実際のシナリオでは、チームは通常、Visual Studio と C# を使用して、Windows フォームまたは Web ベースのアプリケーションを作成します。

Windows フォーム アプリケーションは、コンピューター上で実行するように設計されたアプリケーションです。 Web アプリケーションになるため、Web ブラウザーでは実行されません。

このチュートリアルでは、Windows ベースのアプリケーションを作成する方法に焦点を当てます。また、C# Windows アプリケーションのさまざまな要素を操作する方法の基本についても学習します。

この Windows チュートリアルでは、次のことを学びます-

• Windows フォームの基本
• Windows フォームでの Hello World
• フォームにコントロールを追加する
• コントロールのイベント処理
• ツリーと PictureBox コントロール

Windows フォームの基本

Windows フォーム アプリケーションは、デスクトップ コンピューターで実行されるアプリケーションです。通常、Windows フォーム アプリケーションには、ラベル、テキスト ボックス、リスト ボックスなどのコントロールのコレクションがあります。

以下は、単純な Windows フォーム アプリケーション C# の例です。これは、ユーザーがアクセスできる単純なログイン画面を示しています。ユーザーは必要な資格情報を入力し、[ログイン] ボタンをクリックして続行します。

上記のアプリケーションで使用可能なコントロールの例

<オール>

これは、隣接するコントロールを記述するために通常使用されるラベル コントロールのコレクションです。この場合、2 つのテキストボックスがあり、ラベルを使用して、1 つのテキストボックスはユーザー名を入力し、もう 1 つのテキストボックスはパスワードを入力することをユーザーに伝えます。

2 つのテキストボックスは、ユーザーが入力するユーザー名とパスワードを保持するために使用されます。

最後に、ボタン コントロールがあります。通常、ボタン コントロールには、特定の一連のアクションを実行するためのコードがアタッチされています。たとえば上記の場合、ユーザーが入力したユーザー名とパスワードを検証するアクションをボタンに実行させることができます。

C# Hello World

それでは、Visual Studio で単純な「hello world」アプリケーションを実装する方法の例を見てみましょう。このためには、以下の手順を実装する必要があります

ステップ 1) 最初の手順では、Visual Studio で新しいプロジェクトを作成します。 Visual Studio を起動したら、メニュー オプションの [新規] → [プロジェクト] を選択する必要があります。

ステップ 2) 次の手順では、プロジェクトの種類を Windows フォーム アプリケーションとして選択します。ここでは、プロジェクトの名前と場所についても言及する必要があります。

<オール>

プロジェクト ダイアログ ボックスには、Visual Studio でさまざまな種類のプロジェクトを作成するためのさまざまなオプションが表示されます。左側の Windows オプションをクリックします。

前の手順で Windows オプションをクリックすると、Windows フォーム アプリケーションのオプションが表示されます。このオプションをクリックします。

アプリケーションに名前を付けます。私たちの場合、それは DemoApplication です。また、アプリケーションを保存する場所も提供します。

最後に、[OK] ボタンをクリックして、Visual Studio にプロジェクトを作成させます。

上記の手順に従うと、Visual Studio で以下の出力が得られます。

出力:-

Visual Studio にフォーム デザイナーが表示されます。 Windows フォーム アプリケーションの構築を開始するのは、このフォーム デザイナーです。

ソリューション エクスプローラーには、DemoApplication ソリューションも表示されます。このソリューションには、以下の 2 つのプロジェクト ファイルが含まれます

<オール>

Forms1.cs というフォーム アプリケーション。このファイルには、Windows フォーム アプリケーションのすべてのコードが含まれます。

Program.cs というメイン プログラムは、Visual Studio で新しいアプリケーションを作成するときに作成される既定のコード ファイルです。このコードには、アプリケーション全体のスタートアップ コードが含まれます。

Visual Studio の左側には、ツールボックスも表示されます。ツールボックスには、Windows フォームに追加できるすべてのコントロールが含まれています。テキスト ボックスやラベルなどのコントロールは、Windows フォームに追加できるコントロールのほんの一部です。

以下は、ツールボックスがどのように見えるかのスクリーンショットです。

ステップ 3) このステップでは、「Hello World」を表示するラベルをフォームに追加します。ツールボックスからラベル コントロールを選択し、フォームにドラッグするだけです。

ラベルをフォームにドラッグすると、以下のようにフォームに埋め込まれたラベルが表示されます。

ステップ 4) 次のステップは、コントロールのプロパティに移動し、テキストを「Hello World」に変更することです。

コントロールのプロパティに移動するには、コントロールを右クリックして [プロパティ] メニュー オプションを選択する必要があります

• プロパティ パネルは Visual Studio にも表示されます。ラベル コントロールのプロパティ コントロールで、[テキスト] セクションに移動し、「Hello World」と入力します。
• 各コントロールには、コントロールを説明する一連のプロパティがあります。

上記のすべての手順に従って Visual Studio でプログラムを実行すると、次の出力が得られます

出力:-

出力では、Windows フォームが表示されていることがわかります。フォームに「Hello World」が表示されていることも確認できます。

フォームへのコントロールの追加

前のセクションで「Hello World」を表示するラベル コントロールを追加したときに、コントロールをフォームに追加する方法は既に説明しました。

Windows フォームで使用できるその他のコントロールを見て、共通のプロパティをいくつか見てみましょう。

C# の例の Windows フォーム アプリケーションでは、次の機能を持つ 1 つのフォームを作成します。

<オール>

ユーザーが名前と住所を入力できること

ユーザーが住んでいる都市を選択するオプション

ユーザーが性別のオプションを入力できる機能

ユーザーが学びたいコースを選択するオプション。 C# と ASP.Net の両方を選択できます

それでは、各コントロールを詳しく見て、それらを追加して、上記の機能を備えたフォームを作成しましょう。

グループ ボックス

グループ ボックスは、コントロールをセクションに論理的にグループ化するために使用されます。人の名前や住所などの詳細を入力するためのコントロールのコレクションがある場合の例を見てみましょう。理想的には、これらは個人の詳細であるため、これらの詳細をフォームの別のセクションに含めることをお勧めします。この目的のために、グループ ボックスを使用できます。以下に示す例で、これを実装する方法を見てみましょう

ステップ 1) 最初のステップは、以下に示すように、Groupbox コントロールをツールボックスから Windows フォームにドラッグすることです

ステップ 2) グループボックスが追加されたら、グループボックス コントロールをクリックしてプロパティ ウィンドウに移動します。プロパティ ウィンドウで、Text プロパティに移動し、「ユーザーの詳細」に変更します。

上記の変更を行うと、次の出力が表示されます

出力:-

出力では、Groupbox がフォームに追加されたことを明確に確認できます。グループボックスのテキストが「ユーザーの詳細」に変更されたことも確認できます。

ラベル コントロール

次は、ラベル コントロールです。ラベル コントロールは、フォーム上でユーザーにテキストまたはメッセージを表示するために使用されます。ラベル コントロールは通常、他のコントロールと一緒に使用されます。一般的な例は、ラベルがテキスト ボックス コントロールと共に追加される場合です。

ラベルは、テキスト ボックスに何が入力されると予想されるかをユーザーに示します。以下に示す例で、これを実装する方法を見てみましょう。 2 つのラベルを追加します。1 つは「name」と呼ばれ、もう 1 つは「address」と呼ばれます。これらは、後のセクションで追加されるテキスト ボックス コントロールと組み合わせて使用​​されます。

ステップ 1) 最初の手順は、以下に示すように、ラベル コントロールをツールボックスから Windows フォームにドラッグすることです。ラベル コントロールを 2 回ドラッグして、1 つを「名前」用に、もう 1 つを「住所」用に配置できるようにしてください。

ステップ 2) ラベルが追加されたら、ラベル コントロールをクリックしてプロパティ ウィンドウに移動します。プロパティ ウィンドウで、各ラベル コントロールの Text プロパティに移動します。

上記の変更を行うと、次の出力が表示されます

出力:-

フォームに追加されたラベル コントロールを確認できます。

テキストボックス

テキストボックスは、ユーザーが C# で Windows アプリケーションにテキストを入力できるようにするために使用されます。以下に示す例で、これを実装する方法を見てみましょう。フォームに 2 つのテキストボックスを追加します。1 つは名前用、もう 1 つはユーザーが入力する住所用です

ステップ 1) 最初のステップは、以下に示すように、テキスト ボックス コントロールをツールボックスから Windows フォームにドラッグすることです

ステップ 2) テキスト ボックスが追加されたら、テキスト ボックス コントロールをクリックしてプロパティ ウィンドウに移動します。プロパティ ウィンドウで、Name プロパティに移動し、意味のある名前を各テキスト ボックスに追加します。たとえば、ユーザーのテキストボックスに txtName、アドレスのテキストボックスに txtAddress という名前を付けます。これらのコントロールに機能を追加することが容易になるため、コントロールの命名規則と標準を作成する必要があります。これについては後で説明します。

上記の変更を行うと、次の出力が表示されます

出力:-

出力では、テキストボックスがフォームに追加されたことを明確に確認できます。

リスト ボックス

Listbox は、Windows フォームに項目のリストを表示するために使用されます。以下に示す例で、これを実装する方法を見てみましょう。フォームにリスト ボックスを追加して、いくつかの都市の場所を保存します。

ステップ 1) 最初のステップは、以下に示すように、リスト ボックス コントロールをツールボックスから Windows フォームにドラッグすることです

ステップ 2) リスト ボックスが追加されたら、リスト ボックス コントロールをクリックしてプロパティ ウィンドウに移動します。

<オール>

まず、Listbox ボックス コントロールのプロパティを変更します。ここでは、これを lstCity に変更しました

Items プロパティをクリックします。これにより、リスト ボックスに表示されるさまざまな項目を追加できます。この場合、アイテム「コレクション」を選択しました。

ポップアップ表示される文字列コレクション エディタで、都市名を入力します。この場合、「ムンバイ」、「バンガロール」、「ハイデラバード」と入力しました。

最後に、[OK] ボタンをクリックします。

上記の変更を行うと、次の出力が表示されます

出力:-

出力では、Listbox がフォームに追加されたことがわかります。リスト ボックスに都市の値が入力されていることも確認できます。

ラジオボタン

Radiobutton は、ユーザーが選択できるアイテムのリストを表示するために使用されます。以下に示す例で、これを実装する方法を見てみましょう。男性/女性オプションのラジオ ボタンを追加します。

ステップ 1) 最初のステップは、以下に示すように、「ラジオボタン」コントロールをツールボックスから Windows フォームにドラッグすることです。

ステップ 2) Radiobutton が追加されたら、Radiobutton コントロールをクリックしてプロパティ ウィンドウに移動します。

<オール>

まず、両方のラジオ コントロールのテキスト プロパティを変更する必要があります。プロパティ ウィンドウに移動し、一方のラジオ ボタンのテキストを男性に、もう一方のテキストを女性に変更します。

同様に、両方のラジオ コントロールの name プロパティを変更します。プロパティ ウィンドウに移動し、名前を一方のラジオボタンの名前を「rdMale」に変更し、もう一方のラジオボタンの名前を「rdfemale」に変更します。

上記の変更を行うと、次の出力が表示されます

出力:-

Windows フォームに追加されたラジオ ボタンが表示されます。

チェックボックス

チェックボックスは、ユーザーが複数の選択肢を選択できるオプションのリストを提供するために使用されます。以下に示す例で、これを実装する方法を見てみましょう。 Windows フォームに 2 つのチェックボックスを追加します。これらのチェックボックスは、ユーザーが C# と ASP.Net のどちらを学習するかを選択するオプションを提供します。

ステップ 1) 最初のステップは、以下に示すように、チェックボックス コントロールをツールボックスから Windows フォームにドラッグすることです

ステップ 2) チェックボックスが追加されたら、チェックボックス コントロールをクリックしてプロパティ ウィンドウに移動します。

プロパティ ウィンドウで、

<オール>

まず、両方のチェックボックス コントロールのテキスト プロパティを変更する必要があります。プロパティ ウィンドウに移動し、テキストを C# および ASP.Net に変更します。

同様に、両方のラジオ コントロールの name プロパティを変更します。プロパティ ウィンドウに移動し、1 つのチェックボックスの名前を chkC に変更し、もう 1 つのチェックボックスの名前を chkASP に変更します。

上記の変更を行うと、次の出力が表示されます

出力:-

ボタン

ボタンは、ユーザーがボタンをクリックしてフォームの処理を開始できるようにするために使用されます。以下に示す例で、これを実装する方法を見てみましょう。フォーム上のすべての情報を送信するために使用される「送信」という簡単なボタンを追加します。

ステップ 1) 最初のステップは、以下に示すように、ボタン コントロールをツールボックスから Windows フォームにドラッグすることです

ステップ 2) ボタンが追加されたら、ボタン コントロールをクリックしてプロパティ ウィンドウに移動します。

<オール>

まず、ボタン コントロールのテキスト プロパティを変更する必要があります。プロパティ ウィンドウに移動し、テキストを「送信」に変更してください。

同様に、コントロールの name プロパティを変更します。プロパティ ウィンドウに移動し、名前を「btnSubmit」に変更します。

上記の変更を行うと、次の出力が表示されます

出力:-

おめでとうございます。これで、最初の基本的な Windows フォームが作成されました。次のトピックに進み、コントロールのイベント処理を行う方法を見てみましょう。

コントロールの C# イベント処理

Windows フォームで作業する場合、コントロールにイベントを追加できます。イベントとは、アクションが実行されたときに発生するものです。おそらく最も一般的なアクションは、フォーム上のボタンをクリックすることです。 C# Windows フォームでは、フォームでボタンが押されたときに特定のアクションを実行するために使用できるコードを追加できます。

通常、フォームでボタンが押されると、なんらかの処理が行われることを意味します。

ボタン イベントのシナリオに進む前に、イベントの 1 つとその処理方法を見てみましょう。

以下の例は、Listbox コントロールのイベントを示しています。そのため、リスト ボックス コントロールで項目が選択されるたびに、選択された項目を示すメッセージ ボックスがポップアップ表示されます。これを実現するには、次の手順を実行しましょう。

ステップ 1) フォーム デザイナーのリストボックスをダブルクリックします。 これにより、Visual Studio はフォームのコード ファイルを自動的に開きます。また、コードにイベント メソッドが自動的に追加されます。このイベント メソッドは、リストボックス内のアイテムが選択されるたびにトリガーされます。

上記は、フォームのリスト ボックス コントロールをダブルクリックすると、Visual Studio によって自動的に追加されるコードのスニペットです。次に、以下のコード セクションをこのコード スニペットに追加して、リストボックス イベントに必要な機能を追加しましょう。

<オール>

これは、リスト ボックス コントロールをダブルクリックしたときに Visual Studio によって自動的に作成されるイベント ハンドラー メソッドです。メソッド名やメソッドに渡されるパラメータの複雑さについて心配する必要はありません。

ここでは、lstCity.SelectedItem プロパティを通じて SelectedItem を取得しています。 lstCity が Listbox コントロールの名前であることを思い出してください。次に、GetItemText メソッドを使用して、選択した項目の実際の値を取得します。次に、この値をテキスト変数に割り当てます。

最後に、MessageBox メソッドを使用して、テキスト変数の値をユーザーに表示します。

上記の変更を行い、Visual Studio でプログラムを実行すると、次の出力が表示されます

出力:-

出力から、リスト ボックスの項目が選択されると、メッセージ ボックスがポップアップすることがわかります。これにより、リストボックスから選択されたアイテムが表示されます。

次に、ボタン クリック メソッドである最終的なコントロールを見てみましょう。これも同じ哲学に従います。フォーム デザイナでボタンをダブルクリックするだけで、ボタン イベント ハンドラのメソッドが自動的に追加されます。次に、以下のコードを追加するだけです。

<オール>

これは、ボタン コントロールをダブルクリックしたときに Visual Studio によって自動的に作成されるイベント ハンドラー メソッドです。メソッド名やメソッドに渡されるパラメータの複雑さについて心配する必要はありません。

ここでは、名前と住所のテキストボックスに入力された値を取得しています。値は、テキスト ボックスの text プロパティから取得できます。次に、それに応じて値を 2 つの変数、名前、およびアドレスに割り当てます。

最後に、MessageBox メソッドを使用して、名前と住所の値をユーザーに表示します。

上記の変更を行い、Visual Studio でプログラムを実行すると、次の出力が表示されます

出力:-

<オール>

まず、名前と住所のフィールドに値を入力します。

次に、[送信] ボタンをクリックします

[送信] ボタンをクリックすると、メッセージ ボックスが表示され、ユーザーの詳細セクションに入力した内容が正しく表示されます。

ツリーと PictureBox コントロール

さらに 2 つのコントロールがあります。1 つは「ツリー コントロール」で、もう 1 つは「イメージ コントロール」です。これらのコントロールを実装する方法の例を見てみましょう

ツリー コントロール

– ツリー コントロールは、ツリーのような方法でアイテムを一覧表示するために使用されます。おそらく最も良い例は、Windows エクスプローラ自体を見たときです。 Windows エクスプローラーのフォルダー構造は、ツリー構造に似ています。

以下に示す例で、これを実装する方法を見てみましょう。

ステップ 1) 最初のステップは、以下に示すように、ツリー コントロールをツールボックスから Windows フォームにドラッグすることです

ステップ 2) 次のステップは、ツリー コレクションにノードを追加して、それに応じてツリーに表示されるようにすることです。まず、以下のサブステップに従って、ツリー コレクションにルート ノードを追加しましょう。

<オール>

ツリー ビュー コントロールのプロパティ ツールボックスに移動します。ノードのプロパティをクリックします。これにより、TreeNode エディタが表示されます

TreeNode エディタで [ルートを追加] ボタンをクリックして、ツリー コレクションにルート ノードを追加します。

次に、ルート ノードのテキストを変更し、テキストをルートとして指定し、[OK] ボタンをクリックします。これにより、ルート ノードが追加されます。

ステップ 3) 次のステップは、子ノードをツリー コレクションに追加することです。以下のサブステップに従って、ツリー コレクションに子ルート ノードを追加しましょう。

<オール>

まず、[子を追加] ボタンをクリックします。これにより、ツリー コレクションに子ノードを追加できます。

子ノードごとに、テキスト プロパティを変更します。前の手順とこの手順を繰り返し、さらに 2 つのノードを追加します。最終的に、上記のように 3 つのノードがあり、テキストはそれぞれラベル、ボタン、チェックボックスになります。

[OK] ボタンをクリックします

上記の変更を行うと、次の出力が表示されます。

出力:-

フォームに追加されたツリー ビューが表示されます。 Windows フォーム アプリケーションを実行すると、ルート ノードを展開して、リストに子ノードを表示できます。

PictureBox コントロール

このコントロールは、Winforms C# に画像を追加するために使用されます。以下に示す例で、これを実装する方法を見てみましょう。

ステップ 1) 最初のステップは、以下に示すように、PictureBox コントロールをツールボックスから C# Windows フォームにドラッグすることです

ステップ 2) 次のステップでは、画像ボックス コントロールに実際に画像を添付します。これは、以下の手順に従って実行できます。

<オール>

まず、PictureBox コントロールの Image プロパティをクリックします。新しいウィンドウが表示されます。

このウィンドウで、[インポート] ボタンをクリックします。これは、picturebox コントロールに画像を添付するために使用されます。

画像ボックスに添付する画像を選択できるダイアログ ボックスが表示されます

[OK] ボタンをクリックします

上記の変更を行うと、次の出力が表示されます

出力:-

出力から、フォームに画像が表示されていることがわかります。

まとめ

• C# アプリケーションの Windows フォームは、コンピューターのデスクトップで実行されるフォームです。 Visual Studio Form と C# を使用して、Windows フォーム アプリケーションを作成できます。
• コントロールは、Visual Studio のツールボックスを介して Windows フォーム C# に追加できます。ツールボックスを使用して、ラベル、チェックボックス、ラジオ ボタンなどのコントロールをフォームに追加できます。
• ツリー ビュー コントロールや PictureBox コントロールなどの高度なコントロールも使用できます。
• イベント ハンドラーは、コントロールから生成されたイベントに応答するために使用されます。最も一般的なものは、ボタン クリック イベント用に追加されたものです。