Andy (Steve) De GeorgeandTom Dykstra
0fdf730bc2
* Port article on tab order * Redirects for new article * TOC * Update links * Some other minor changes * fix lint * Update dotnet-desktop-guide/net/winforms/controls/how-to-set-the-tab-order.md Co-authored-by: Tom Dykstra <[email protected]> * Update dotnet-desktop-guide/net/winforms/controls/how-to-set-the-tab-order.md Co-authored-by: Tom Dykstra <[email protected]> * Update dotnet-desktop-guide/net/winforms/controls/how-to-set-the-tab-order.md Co-authored-by: Tom Dykstra <[email protected]> * Apply suggestions from code review Co-authored-by: Tom Dykstra <[email protected]>
2.6 KiB
title, description, ms.date, dev_langs, helpviewer_keywords
| title | description | ms.date | dev_langs | helpviewer_keywords | ||||
|---|---|---|---|---|---|---|---|---|
| Add Controls to a Form | Learn how to add a control a form in Windows Forms for .NET | 10/26/2020 |
|
|
Add a control to a form (Windows Forms .NET)
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.
The primary way a control is added to a form is through the Visual Studio Designer, but you can also manage the controls on a form at run time through code.
[!INCLUDE desktop guide under construction]
Add with Designer
Visual Studio uses the Forms Designer to design forms. There is a Controls pane which lists all the controls available to your app. You can add controls from the pane in two ways:
Add the control by double-clicking
When a control is double-clicked, it is automatically added to the current open form with default settings.
:::image type="content" source="media/how-to-add-to-a-form/toolbox-double-click.gif" alt-text="Double-click a control in the toolbox on visual studio for .NET Windows Forms":::
Add the control by drawing
Select the control by clicking on it. In your form, drag-select a region. The control will be placed to fit the size of the region you selected.
:::image type="content" source="media/how-to-add-to-a-form/toolbox-drag-draw.gif" alt-text="Drag-select and draw a control from the toolbox on visual studio for .NET Windows Forms":::
Add with code
Controls can be created and then added to a form at run time with the form's xref:System.Windows.Forms.Control.Controls%2A collection. This collection can also be used to remove controls from a form.
The following code adds and positions two controls, a Label and a TextBox:
:::code language="csharp" source="snippets/how-to-add-to-a-form/cs/Form1.cs" id="CreateControl":::
:::code language="vb" source="snippets/how-to-add-to-a-form/vb/Form1.vb" id="CreateControl":::