Skip to content
halo`s Docs

Windows Forms Controls

Comprehensive Documentation for Windows Forms Controls

Table of Contents

  1. Introduction to Windows Forms Controls
  2. Basic Controls
    • Button
    • Label
    • TextBox
    • CheckBox
    • RadioButton
  3. Container Controls
    • Panel
    • GroupBox
    • TabControl
    • SplitContainer
    • FlowLayoutPanel
    • TableLayoutPanel
  4. Data-Related Controls
    • DataGridView
    • ComboBox
    • ListBox
    • CheckedListBox
  5. Advanced Controls
    • PictureBox
    • ProgressBar
    • TrackBar
    • DateTimePicker
    • NumericUpDown
  6. Other Useful Controls
    • ListView
    • TreeView
    • MonthCalendar
    • Timer
  7. Control Properties and Methods
  8. Event Handling in Controls
  9. Best Practices for Using Controls

1. Introduction to Windows Forms Controls

Windows Forms (WinForms) provides a rich set of UI controls for creating desktop applications. These controls are the building blocks of your UI, providing ways for users to interact with your application. This documentation covers a wide range of controls, their properties, methods, and events, along with example usage to help you understand how to leverage them effectively in your projects.

2. Basic Controls

Button

The Button control is used to trigger actions when clicked.

Example: Basic Button Click Event

Button btnSubmit = new Button();
btnSubmit.Text = "Submit";
btnSubmit.Click += (sender, e) =>
{
    MessageBox.Show("Button clicked!");
};

Key Properties:

  • Text: The text displayed on the button.
  • Enabled: Whether the button is clickable.
  • Size: Size of the button.

Label

The Label control is used to display static text on the form.

Example: Basic Label Usage

Label lblMessage = new Label();
lblMessage.Text = "Hello, World!";
lblMessage.Location = new Point(20, 30);
this.Controls.Add(lblMessage);

Key Properties:

  • Text: The text to display.
  • AutoSize: Automatically adjusts the size of the label to fit the text.
  • ForeColor: The color of the text.

TextBox

The TextBox control is used for receiving user input.

Example: TextBox for User Input

TextBox txtName = new TextBox();
txtName.Location = new Point(20, 60);
this.Controls.Add(txtName);

Key Properties:

  • Text: The text entered by the user.
  • MaxLength: Maximum number of characters allowed.
  • PasswordChar: Displays characters as asterisks for password input.

Key Events:

  • TextChanged: Triggered when the text is changed.

CheckBox

The CheckBox control is used for binary selection (checked or unchecked).

Example: CheckBox Selection

CheckBox chkAccept = new CheckBox();
chkAccept.Text = "Accept Terms";
chkAccept.Location = new Point(20, 90);
chkAccept.CheckedChanged += (sender, e) =>
{
    MessageBox.Show(chkAccept.Checked ? "Accepted" : "Not Accepted");
};
this.Controls.Add(chkAccept);

Key Properties:

  • Checked: Whether the box is checked.
  • Text: The label displayed beside the checkbox.

RadioButton

The RadioButton control allows for single-choice selections from a group.

Example: RadioButton Selection

RadioButton rbOption1 = new RadioButton();
rbOption1.Text = "Option 1";
rbOption1.Location = new Point(20, 120);
this.Controls.Add(rbOption1);


RadioButton rbOption2 = new RadioButton();
rbOption2.Text = "Option 2";
rbOption2.Location = new Point(20, 140);
this.Controls.Add(rbOption2);

Key Properties:

  • Checked: Whether the button is selected.
  • Text: The label next to the radio button.

3. Container Controls

Panel

The Panel control is used to group other controls.

Example: Using a Panel

Panel pnlDetails = new Panel();
pnlDetails.Size = new Size(200, 100);
pnlDetails.Location = new Point(20, 180);
this.Controls.Add(pnlDetails);


Button btnInsidePanel = new Button();
btnInsidePanel.Text = "Inside Panel";
pnlDetails.Controls.Add(btnInsidePanel);

Key Properties:

  • BackColor: The background color of the panel.
  • Dock: Controls how the panel resizes within its container.

GroupBox

A GroupBox is similar to a Panel but with a header and border.

Example: GroupBox Usage

GroupBox groupBox = new GroupBox();
groupBox.Text = "Personal Information";
groupBox.Location = new Point(20, 220);
groupBox.Size = new Size(200, 150);
this.Controls.Add(groupBox);


Label lblName = new Label();
lblName.Text = "Name:";
groupBox.Controls.Add(lblName);

TabControl

The TabControl allows you to organize content into tabs.

Example: TabControl Usage

TabControl tabControl = new TabControl();
tabControl.Location = new Point(20, 380);
tabControl.Size = new Size(300, 200);
this.Controls.Add(tabControl);


TabPage tabPage1 = new TabPage("Tab 1");
tabControl.TabPages.Add(tabPage1);


TabPage tabPage2 = new TabPage("Tab 2");
tabControl.TabPages.Add(tabPage2);

SplitContainer

The SplitContainer control divides the space into two resizable panels.

Example: SplitContainer Usage

SplitContainer splitContainer = new SplitContainer();
splitContainer.Dock = DockStyle.Fill;
this.Controls.Add(splitContainer);


Button btnLeft = new Button();
btnLeft.Text = "Left Panel";
splitContainer.Panel1.Controls.Add(btnLeft);


Button btnRight = new Button();
btnRight.Text = "Right Panel";
splitContainer.Panel2.Controls.Add(btnRight);

FlowLayoutPanel

The FlowLayoutPanel arranges controls horizontally or vertically.

Example: FlowLayoutPanel Usage

FlowLayoutPanel flowPanel = new FlowLayoutPanel();
flowPanel.Dock = DockStyle.Top;
this.Controls.Add(flowPanel);


Button btn1 = new Button();
btn1.Text = "Button 1";
flowPanel.Controls.Add(btn1);


Button btn2 = new Button();
btn2.Text = "Button 2";
flowPanel.Controls.Add(btn2);

TableLayoutPanel

The TableLayoutPanel arranges controls in a grid with rows and columns.

Example: TableLayoutPanel Usage

TableLayoutPanel tableLayoutPanel = new TableLayoutPanel();
tableLayoutPanel.RowCount = 2;
tableLayoutPanel.ColumnCount = 2;
tableLayoutPanel.Dock = DockStyle.Fill;
this.Controls.Add(tableLayoutPanel);


Label lblName = new Label();
lblName.Text = "Name:";
tableLayoutPanel.Controls.Add(lblName, 0, 0);


TextBox txtName = new TextBox();
tableLayoutPanel.Controls.Add(txtName, 1, 0);

DataGridView

The DataGridView control is used to display data in a tabular format.

Example: DataGridView Usage

DataGridView dgvUsers = new DataGridView();
dgvUsers.Dock = DockStyle.Fill;
this.Controls.Add(dgvUsers);


dgvUsers.DataSource = GetUserData();  // Assume GetUserData() returns a data source

ComboBox

The ComboBox control displays a list of options and allows the user to select one.

Example: ComboBox Usage

ComboBox cboColor = new ComboBox();
cboColor.Items.AddRange(new string[] { "Red", "Green", "Blue" });
cboColor.SelectedIndexChanged += (sender, e) =>
{
    MessageBox.Show("Selected: " + cboColor.SelectedItem);
};
this.Controls.Add(cboColor);

ListBox

The ListBox control displays a list of items from which a user can select one or more items.

Example: ListBox Usage

ListBox lstItems = new ListBox();
lstItems.Items.Add("Item 1");
lstItems.Items.Add("Item 2");
lstItems.SelectedIndexChanged += (sender, e) =>
{
    MessageBox.Show("Selected: " + lstItems.SelectedItem);
};
this.Controls.Add(lstItems);

CheckedListBox

The CheckedListBox control displays a list of items with checkboxes.

Example: CheckedListBox Usage

CheckedListBox clbItems = new CheckedListBox();
clbItems.Items.Add("Item 1");
clbItems.Items.Add("Item 2");
clbItems.ItemCheck += (sender, e) =>
{
    MessageBox.Show(clbItems.SelectedItem + " is checked.");
};
this.Controls.Add(clbItems);

5. Advanced Controls

PictureBox

The PictureBox control displays images.

Example: PictureBox Usage

PictureBox pictureBox = new PictureBox();
pictureBox.Image = Image.FromFile("image.jpg");
pictureBox.SizeMode = PictureBoxSizeMode.StretchImage;
this.Controls.Add(pictureBox);

ProgressBar

The ProgressBar control is used to indicate the progress of a task.

Example: ProgressBar Usage

ProgressBar progressBar = new ProgressBar();
progressBar.Maximum = 100;
progressBar.Minimum = 0;
progressBar.Value = 50;
this.Controls.Add(progressBar);

TrackBar

The TrackBar control is used to select a value from a range.

Example: TrackBar Usage

TrackBar trackBar = new TrackBar();
trackBar.Minimum = 0;
trackBar.Maximum = 100;
trackBar.ValueChanged += (sender, e) =>
{
    MessageBox.Show("Value: " + trackBar.Value);
};
this.Controls.Add(trackBar);

DateTimePicker

The DateTimePicker control allows the user to select a date.

Example: DateTimePicker Usage

DateTimePicker datePicker = new DateTimePicker();
datePicker.Format = DateTimePickerFormat.Short;
this.Controls.Add(datePicker);

NumericUpDown

The NumericUpDown control allows the user to select a number by either typing or using the up/down buttons.

Example: NumericUpDown Usage

NumericUpDown numericUpDown = new NumericUpDown();
numericUpDown.Minimum = 0;
numericUpDown.Maximum = 100;
this.Controls.Add(numericUpDown);

6. Other Useful Controls

ListView

The ListView control displays a list of items with icons and supports detailed view.

Example: ListView Usage

ListView listView = new ListView();
listView.View = View.Details;
listView.Columns.Add("Name", 100);
listView.Items.Add(new ListViewItem("Item 1"));
this.Controls.Add(listView);

TreeView

The TreeView control displays hierarchical data in a tree structure.

Example: TreeView Usage

TreeView treeView = new TreeView();
TreeNode node1 = new TreeNode("Root");
node1.Nodes.Add(new TreeNode("Child 1"));
node1.Nodes.Add(new TreeNode("Child 2"));
treeView.Nodes.Add(node1);
this.Controls.Add(treeView);

MonthCalendar

The MonthCalendar control displays a calendar.

Example: MonthCalendar Usage

MonthCalendar monthCalendar = new MonthCalendar();
this.Controls.Add(monthCalendar);

Timer

The Timer control is used to execute code at regular intervals.

Example: Timer Usage

Timer timer = new Timer();
timer.Interval = 1000;  // 1 second
timer.Tick += (sender, e) =>
{
    MessageBox.Show("Tick!");
};
timer.Start();

7. Control Properties and Methods

  • Name: Each control has a Name property for easy identification in code.
  • Text: For controls that display text, such as Button, Label, TextBox, ComboBox.
  • Visible: Controls can be shown or hidden with the Visible property.
  • Enabled: Enables or disables controls.

8. Event Handling in Controls

Handling events such as Click, TextChanged, and SelectedIndexChanged is essential for making your controls interactive. Event handlers are added by associating a method with the control’s event property.

9. Best Practices for Using Controls

  • Consistent Naming: Use clear and descriptive names for controls (e.g., btnSubmit, txtUsername).
  • Minimize Redundancy: Avoid creating unnecessary controls. Reuse controls where possible.
  • Separation of Concerns: Keep your UI logic separate from business logic by using patterns like MVC or MVVM.

This documentation provides a detailed overview of common Windows Forms controls and examples for using them in your applications. Use this guide to enhance your UI development and create feature-rich desktop applications!