Form.ShowDialog メソッド

フォームをモーダル ダイアログ ボックスとして表示します。

オーバーロードの一覧

フォームをオーナー ウィンドウのないモーダル ダイアログ ボックスとして表示します。

.NET Compact Framework でもサポート。

[Visual Basic] Overloads Public Function ShowDialog() As DialogResult

[C#] public DialogResult ShowDialog();

[C++] public: DialogResult ShowDialog();

[JScript] public function ShowDialog() : DialogResult;

指定した所有者を持つモーダル ダイアログとしてフォームを表示します。

[Visual Basic] Overloads Public Function ShowDialog(IWin32Window) As DialogResult

[C#] public DialogResult ShowDialog(IWin32Window);

[C++] public: DialogResult ShowDialog(IWin32Window*);

[JScript] public function ShowDialog(IWin32Window) : DialogResult;

使用例

[Visual Basic, C#, C++] フォームをモーダル ダイアログ ボックスとして表示し、ダイアログ ボックスの戻り値を評価してその TextBox コントロールの値を取得するかどうかを判断する例を次に示します。この例は、 Form2 という名前の Form が作成され、そのフォームに TextBox1 という名前の TextBox コントロールが配置されていることを前提にしています。この例では、ダイアログ ボックスのオーナーを指定するバージョンの ShowDialog を使用します。

[Visual Basic, C#, C++] メモ   ここでは、ShowDialog のオーバーロード形式のうちの 1 つだけについて、使用例を示します。その他の例については、各オーバーロード形式のトピックを参照してください。

 
Public Sub ShowMyDialogBox()
    Dim testDialog As New Form2()
    
    ' Show testDialog as a modal dialog and determine if DialogResult = OK.
    If testDialog.ShowDialog(Me) = System.Windows.Forms.DialogResult.OK Then
        ' Read the contents of testDialog's TextBox.
        txtResult.Text = testDialog.TextBox1.Text
    Else
        txtResult.Text = "Cancelled"
    End If
    testDialog.Dispose()
End Sub 'ShowMyDialogBox

[C#] 
public void ShowMyDialogBox()
{
   Form2 testDialog = new Form2();

   // Show testDialog as a modal dialog and determine if DialogResult = OK.
   if (testDialog.ShowDialog(this) == DialogResult.OK)
   {
      // Read the contents of testDialog's TextBox.
      this.txtResult.Text = testDialog.TextBox1.Text;
   }
   else
   {
      this.txtResult.Text = "Cancelled";
   }
   testDialog.Dispose();
}

[C++] 
public:
   void ShowMyDialogBox()
   {
      Form2* testDialog = new Form2();

      // Show testDialog as a modal dialog and determine if DialogResult = OK.
      if (testDialog->ShowDialog(this) == DialogResult::OK)
      {
         // Read the contents of testDialog's TextBox.
         this->txtResult->Text = testDialog->TextBox1->Text;
      }
      else
      {
         this->txtResult->Text = S"Cancelled";
      }
      testDialog->Dispose();
   }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

参照

Form クラス | Form メンバ | System.Windows.Forms 名前空間