docs-desktop/dotnet-desktop-guide/framework/winforms/how-to-display-dialog-boxes-for-windows-forms.md

title, ms.date, dev_langs, helpviewer_keywords, ms.assetid

title	ms.date	dev_langs	helpviewer_keywords	ms.assetid
How to: Display Dialog Boxes	03/30/2017	csharp vb cpp	Windows Forms, displaying Windows Forms dialog boxes [Windows Forms], displaying Windows Forms, calling one form from another dialog boxes [Windows Forms], displaying for Windows Forms	aaac1b38-c651-495a-8d3d-5a9bfb32fee3

How to: Display Dialog Boxes for Windows Forms

You display a dialog box in the same way you display any other form in an application. The startup form loads automatically when the application is run. To make a second form or dialog box appear in the application, write code to load and display it. Similarly, to make the form or dialog box disappear, write code to unload or hide it.

To display a dialog box

1. Navigate to the event handler with which you want to open the dialog box. This can happen when a menu command is selected, when a button is clicked, or when any other event occurs.

2. In the event handler, add code to open the dialog box. In this example, a button-click event is used to show the dialog box:

   Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click  
      Dim dlg1 as new Form()  
      dlg1.ShowDialog()  
   End Sub  
   

   private void button1_Click(object sender, System.EventArgs e)
   {  
      Form dlg1 = new Form();  
      dlg1.ShowDialog();  
   }  
   

   private:
     void button1_Click(System::Object ^ sender,  
       System::EventArgs ^ e)  
     {  
       Form ^ dlg1 = gcnew Form();  
       dlg1->ShowDialog();  
     }