ダイアログボックスへのユーザー入力

[アーティクル]
08/16/2008

更新 : 2007 年 11 月

ダイアログボックスは、通常、アプリケーションで使用するデータをユーザーが入力するときに使用します。ユーザーが入力した情報は、ダイアログボックスが表示されるフォームで処理されます。ダイアログボックスを使用するときには、そのダイアログボックスがどのように閉じられるか、つまりユーザーがダイアログボックスを閉じた "結果" がどうなるかを知ることが重要です。たとえば、ユーザーが [キャンセル] をクリックした場合、入力したデータは保持されずに破棄されます。Form.DialogResult プロパティを使用すると、ダイアログボックスがどのように閉じられるかを確認できます。

ダイアログボックスを表示するフォーム (ダイアログボックスの親フォーム) で DialogResult プロパティの値を使用して、[OK] ボタンと [キャンセル] ボタンのどちらがクリックされたのかを確認できます。返された DialogResult の値に基づいて、ダイアログボックスの情報を取得する必要があるかどうかを判断します。ダイアログボックスで、Button コントロールを使用せずに DialogResult を返す場合は、ダイアログボックスの DialogResult プロパティの値を設定します。

フォームがモーダルダイアログボックスとして表示されているときに [閉じる] (フォームの右上隅の X 印が付いたボタン) をクリックすると、フォームは非表示になり、DialogResult プロパティが DialogResult.Cancel に設定されます。ユーザーがダイアログボックスの [閉じる] ボタンをクリックしたときや DialogResult プロパティの値を設定したとき、Close メソッドは自動的には呼び出されません。その代わり、フォームは非表示になり、ダイアログボックスの新しいインスタンスを作成しなくても再表示できます。このため、フォームがアプリケーションで不要となった場合は、そのフォームの Dispose メソッドを呼び出す必要があります。

メモ :
フォームの Closing イベントのイベントハンドラで DialogResult プロパティを設定することにより、ユーザーが [閉じる] ボタンをクリックしたときに、DialogResult プロパティに代入された値をオーバーライドできます。