Listbox in C#

Introduction to Listbox in C#

ListBox in C# is defined as adding a list of elements to the ListBox to operate on single or multiple elements. Difference between the drop-down box and list box is drop-down box can select only one element at a time but in case of the list box, we can select single or multiple elements at a time. The ListBox is used to provide different types of methods, properties, and events. This ListBox is specified under System. Windows.Forms package (namespace).

The ListBox class again contains 3 different types of collections in C#. They are

1. ListBox.ObjectCollection: This collection class holds all the elements of the ListBox control.
2. ListBox.SelectedObjectCollection: This collection class holds the collection of selected items in the ListBox control.
3. ListBox.SelectedIndexCollection: This collection class holds the collection of selected indexes, these elements are a subset of the indexes of the ListBox.ObjectCollection and this specifically selected indexes in the ListBox control.

Types of List Boxes in C#?

1. Single Selected ListBox: ListBox can able to select only a single element from the list.
2. Multi Selected ListBox: ListBox can able to select multiple elements from the list.

Prerequisites for ListBox in C#:

• .Net libraries must be installed in your PC
• Visual Studio set up

How to Create the ListBox in C#?

ListBox can be created in 2 ways:

• Design-Time
• Run-Time

1. Design-Time

It is very easy to create without any code initially. Steps to create a project

Step 1: Open Visual Studio

Click on File=>New=>Project

Select =>Windows Form Application then

See the below image for better understanding the project structure:

Name the project and click OK then you will get Form1.cs(Design) tab like below

Step 2: Left side of the visual studio or From View choose Toolbox, Next drag and drop then the required elements onto the Form1.cs(Design) as shown in the above image.

Step 3: After drag and drop select the properties from the right side of the Visual studio and give some name to the Text property. This is used to write a code in the 2^nd method Run-Time.

Output:

2. Run-Time

This is not directly doing it as per the above method. We have written some programs to create ListBox. This is very simple, first drag and drop all the required elements like ListBox, Label, TextField, Button, etc. If you double click on any of the dropped elements we got some C# code that element action methods, we have to write our logic to what we want to do with those elements. Steps to create Run-Time project code to create ListBox

Step1: Create ListBox control by using ListBox() constructor.

Syntax:

ListBox listBox = new ListBox();

Step 2: After creating ListBox property, if we want to set the properties of the ListBox like Font, Font.Size, Color to elements, etc.

Syntax:

listBox.Location = new Point(200, 100);
listBox.Size = new Size(100, 90);
listBox.ForeColor = Color.Red;

Step 3: Add the elements to the ListBox.

Syntax:

listBox.Items.Add("A");
listBox.Items.Add("B");
listBox.Items.Add("C");
listBox.Items.Add("D");

Step 4: Add this ListBox to the Form.

Syntax:

this.Controls.Add(listBox);

Examples of Listbox in C#

Here are the following examples mention below

Example #1 – Creating ListBox and adding elements

Code:

//importing C# required libraries
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Windows.Forms;
//namespace is project name
namespace WindowsFormsApplication26
{
//creating class extends from Form class
public partial class Form1 : Form
{
//constrcutor
public Form1()
{
//initializing components
InitializeComponent();
//Creating list box and add some properties and values to the List Box
listBox2.ForeColor = Color.Red;
listBox2.Items.Add("Java");
listBox2.Items.Add("Python");
listBox2.Items.Add("C++");
listBox2.Items.Add("C");
listBox2.Items.Add("C#");
listBox2.Items.Add("Spring");
listBox2.Items.Add("JavaFX");
listBox2.SelectionMode = SelectionMode.MultiSimple;
}
//method for selectedIndex change operation
private void listBox2_SelectedIndexChanged(object sender, EventArgs e)
{
}
}
}

Output:

Example #2 – User enter value added it to list box by click the button

Code:

//importing C# required libraries
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Windows.Forms;
//namespace is project name
namespace WindowsFormsApp25
{
//creating class extends from Form class
public partial class Form1 : Form
{
//constrcutor
public Form1()
{
//initializing components
InitializeComponent();
}
//saving the enter values into List box
private void buttonSave_Click(object sender, EventArgs e)
{
//If user enter any values then if block executes
if (this.textBoxName.Text != "")
{
NameList.Items.Add(this.textBoxName.Text);
this.textBoxName.Focus();
this.textBoxName.Clear();
}
//If user did not enter any values then else block executes
else
{
MessageBox.Show("Please enter a name to add..","Error",MessageBoxButtons.OK,MessageBoxIcon.Information);
this.textBoxName.Focus();
}
}
}
}

Output:

Before entering a value:

Without entering any value trying to click the save button:

After entering a value:

After entering a value and click the save button:

Example #3 – Delete, Change the font of List Box values

Code:

//importing C# required libraries
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Windows.Forms;
//namespace is project name
namespace WindowsFormsApp25
{
//creating class extends from Form class
public partial class Form1 : Form
{
//constrcutor
public Form1()
{
//initializing components
InitializeComponent();
}
//saving the enter values into List box
private void buttonSave_Click(object sender, EventArgs e)
{
//If user enter any values then if block executes
if (this.textBoxName.Text != "")
{
NameList.Items.Add(this.textBoxName.Text);
this.textBoxName.Focus();
this.textBoxName.Clear();
}
//If user did not enter any values then else block executes
else
{
MessageBox.Show("Please enter a name to add..","Error",MessageBoxButtons.OK,MessageBoxIcon.Information);
this.textBoxName.Focus();
}
}
//Removing the selected elements
private void button2_Click(object sender, EventArgs e)
{
if (this.NameList.SelectedIndex >= 0)
{
this.NameList.Items.RemoveAt(this.NameList.SelectedIndex);
}
}
//Setting List box selected values font
private void button3_Click(object sender, EventArgs e)
{
if (fontDialog1.ShowDialog() == DialogResult.OK)
{
NameList.Font = fontDialog1.Font;
}
}
}
}

Output:

After adding 3 names:

Deleting selected element:

Change the font of the values:

Conclusion

C# List box is used to add the multiples elements to perform any specific operation. List Boxes are used to select the single value or multiple values at a time. In C# List Box can be created using Design-Time and Run-Time methods.

Recommended Articles

This is a guide to Listbox in C#. Here we discuss how to create the ListBox in C# with types and examples for better understanding. You can also go through our other suggested articles to learn more –

1. Static Keyword in C#
2. C# Ternary Operators
3. C# Nullable
4. C# BinaryReader