Skip to content

Commit fee8f94

Browse files
authored
Update README.md
1 parent 97aaa6a commit fee8f94

File tree

1 file changed

+95
-15
lines changed

1 file changed

+95
-15
lines changed

README.md

Lines changed: 95 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,95 @@
1-
# How to Programmatically Select All DropDownItems in SfComboBox
2-
This repository demonstrates how to programmatically select all items in the DropDown list of the Syncfusion SfComboBox control in a Windows Forms application. The SfComboBox is a powerful UI component that supports advanced features like multi-selection, auto-complete, and data binding. In scenarios where you need to select all items at once—such as applying bulk actions or initializing default selections—this sample provides a clear and practical approach.
3-
4-
## Key Features Demonstrated in This Sample
5-
• Enable multi-selection mode in SfComboBox.
6-
• Programmatically select all items in the DropDown list using the SelectedItems collection.
7-
• Handle scenarios where the data source is dynamically loaded.
8-
• Ensure the UI reflects the selection state immediately after applying changes.
9-
10-
## Steps to Select All Items Programmatically
11-
1. Set the ComboBoxMode property to MultiSelection to allow multiple selections.
12-
2. Access the SelectedItems property and add all items from the data source.
13-
3. Refresh the control to update the UI.
14-
15-
This approach ensures that all items in the DropDown are selected without requiring manual user interaction. It is particularly useful for applications that need to apply global settings or perform batch operations.
1+
# How to Programmatically Select All DropDown Items in WinForms SfComboBox
2+
This example demonstrates how to programmatically select all items in the Syncfusion WinForms SfComboBox control. The SfComboBox supports advanced features like multi-selection, auto-complete, and data binding. Selecting all items programmatically is useful for scenarios such as applying bulk actions or initializing default selections.
3+
4+
## Why This Is Useful
5+
- **Batch Operations**: Apply global settings to all items.
6+
- **Default Selections**: Pre-select all items when loading data.
7+
- **Improved UX**: Avoid manual selection for large lists.
8+
9+
## Key Steps
10+
- Set _ComboBoxMode_ to MultiSelection to allow multiple selections.
11+
- Bind the data source to the SfComboBox.
12+
- Iterate through all items and add them to _CheckedItems_ collection.
13+
- Refresh the UI to reflect the changes.
14+
15+
## Code example
16+
17+
**Designer**
18+
```C#
19+
#region Windows Form Designer generated code
20+
private void InitializeComponent()
21+
{
22+
this.sfComboBox1 = new Syncfusion.WinForms.ListView.SfComboBox();
23+
this.button1 = new System.Windows.Forms.Button();
24+
((System.ComponentModel.ISupportInitialize)(this.sfComboBox1)).BeginInit();
25+
this.SuspendLayout();
26+
27+
// sfComboBox1
28+
this.sfComboBox1.Location = new System.Drawing.Point(445, 143);
29+
this.sfComboBox1.Name = "sfComboBox1";
30+
this.sfComboBox1.Size = new System.Drawing.Size(257, 57);
31+
this.sfComboBox1.TabIndex = 0;
32+
33+
// button1
34+
this.button1.Location = new System.Drawing.Point(33, 162);
35+
this.button1.Name = "button1";
36+
this.button1.Size = new System.Drawing.Size(211, 38);
37+
this.button1.Text = "Select Programmatically";
38+
this.button1.Click += new System.EventHandler(this.button1_Click);
39+
40+
// Form1
41+
this.ClientSize = new System.Drawing.Size(800, 450);
42+
this.Controls.Add(this.button1);
43+
this.Controls.Add(this.sfComboBox1);
44+
this.Text = "SfComboBox_CheckedItems";
45+
46+
((System.ComponentModel.ISupportInitialize)(this.sfComboBox1)).EndInit();
47+
this.ResumeLayout(false);
48+
}
49+
#endregion
50+
```
51+
52+
**Logic**
53+
```C#
54+
55+
public Form1()
56+
{
57+
InitializeComponent();
58+
59+
// Bind data source
60+
sfComboBox1.DataSource = GetTable();
61+
sfComboBox1.DisplayMember = "Patient";
62+
sfComboBox1.ValueMember = "Drug";
63+
sfComboBox1.ComboBoxMode = ComboBoxMode.MultiSelection;
64+
this.StartPosition = FormStartPosition.CenterScreen;
65+
}
66+
67+
private static DataTable GetTable()
68+
{
69+
DataTable table = new DataTable();
70+
table.Columns.Add("Dosage", typeof(int));
71+
table.Columns.Add("Drug", typeof(string));
72+
table.Columns.Add("Patient", typeof(string));
73+
table.Columns.Add("Date", typeof(DateTime));
74+
75+
table.Rows.Add(25, "Indocin", "David", DateTime.Now);
76+
table.Rows.Add(50, "Enebrel", "Sam", DateTime.Now);
77+
table.Rows.Add(10, "Hydralazine", "Christoff", DateTime.Now);
78+
table.Rows.Add(21, "Combivent", "Janet", DateTime.Now);
79+
table.Rows.Add(100, "Dilantin", "Melanie", DateTime.Now);
80+
return table;
81+
}
82+
83+
private void button1_Click(object sender, EventArgs e)
84+
{
85+
foreach (var item in sfComboBox1.DropDownListView.View.Items.ToList())
86+
{
87+
sfComboBox1.DropDownListView.CheckedItems.Add(item);
88+
}
89+
}
90+
```
91+
92+
## Notes
93+
- Ensure ComboBoxMode is set to MultiSelection for multiple selections.
94+
- Use CheckedItems collection to programmatically select items.
95+
- This approach works for both static and dynamic data sources.

0 commit comments

Comments
 (0)