How to: Add Controls to Windows Forms

How to: Add Controls to Windows Forms

 

Most forms are designed by adding controls to the surface of the form to define a user interface (UI). A control is a component on a form used to display information or accept user input. For more information about controls, see Windows Forms Controls.

System_CAPS_noteNote

The dialog boxes and menu commands you see might differ from those described in Help depending on your active settings or edition. To change your settings, choose Import and Export Settings on the Tools menu. For more information, see Customizing Development Settings in Visual Studio.

To draw a control on a form

  1. Open the form. For more information, see BF3F1E5B-EA07-4529-85C6-6AF3DED0CEC5.

  2. In the Toolbox, click the control you want to add to your form.

  3. On the form, click where you want the upper-left corner of the control to be located, and drag to where you want the lower-right corner of the control to be located.

    The control is added to the form with the specified location and size.

    System_CAPS_noteNote

    Each control has a default size defined. You can add a control to your form in the control's default size by dragging it from the Toolbox to the form.

To drag a control to a form

  1. Open the form. For more information, see BF3F1E5B-EA07-4529-85C6-6AF3DED0CEC5.

  2. In the Toolbox, click the control you want and drag it to your form.

    The control is added to the form at the specified location in its default size.

    System_CAPS_noteNote

    You can double-click a control in the Toolbox to add it to the upper-left corner of the form in its default size.

    You can also add controls dynamically to a form at run time. In the following code example, a TextBox control will be added to the form when a Button control is clicked.

    System_CAPS_noteNote

    The following procedure requires the existence of a form with a Button control, Button1, already placed on it.

To add a control to a form programmatically

  1. In the method that handles the button's Click event within your form's class, insert code similar to the following to add a reference to your control variable, set the control's Location, and add the control.

    private void button1_Click(object sender, System.EventArgs e) 
    {
       TextBox myText = new TextBox();
       myText.Location = new Point(25,25);
       this.Controls.Add (myText);
    }
    
    
    System_CAPS_noteNote

    You can also add code to initialize other properties of the control.

    System_CAPS_security Security Note

    You might expose your local computer to a security risk through the network by referencing a malicious UserControl. This would only be a concern in the case of a malicious person creating a damaging custom control, followed by you mistakenly adding it to your project.

Show:
© 2016 Microsoft