ComponentOne MultiSelect for WinForms
In This Topic
    Use MultiSelect Control
    In This Topic

    MultiSelect allows you to add, remove, and access specific items with minimal code. It also lets you display or hide the check boxes and dropdown button appearing in the control. Learn how they can be implemented.

    Add an item

    To add items to the MultiSelect control, use Add method of C1CheckListItemCollection as shown in the following code. For example, the following code adds “Edward” in dropdown list of the MultiSelect control:

    C1MultiSelect1.Items.Add("Edward")
    
    c1MultiSelect1.Items.Add("Edward");
    

    MultiSelect also allows you to add an item at a specific position using Insert method of C1CheckListItemCollection and specify an index value for the new item in it. For example, the following code inserts a name, Robert, to the fifth position, adjusting the position of the other items in the dropdown list:

    C1MultiSelect1.Items.Insert(4, "Robert")
    
    c1MultiSelect1.Items.Insert(4, "Robert");
    

    Back to Top

    Remove an item

    MultiSelect lets you delete an item from the list using RemoveAt method of C1CheckListItemCollection as shown in the following code. The method takes one argument, index, which specifies the item to remove. For example, the following code deletes sixth entry from the list.

    C1MultiSelect1.Items.RemoveAt(5)
    
    c1MultiSelect1.Items.RemoveAt(5);
    

    MultiSelect also allows you to delete a selected item from the MultiSelect control using Remove method as shown in the following code:

    C1MultiSelect1.Items.Remove(C1MultiSelect1.SelectedItem)
    
    c1MultiSelect1.Items.Remove(c1MultiSelect1.SelectedItem);
    

    To remove all the entries from the list, use Clear method of C1CheckListItemCollection as shown in the following code:

    C1MultiSelect1.Items.Clear()
    
    c1MultiSelect1.Items.Clear();
    

    Back to Top

    Access specific item

    To access a specific item from the MultiSelect control dropdown list, use Items property of C1MultiSelect class and specify the index of that item. Furthermore, you can change the value of an item in the list using Value property of the C1CheckListItem class. For example, to access and change the value of third item from the list, write the following line of code:

    C1MultiSelect1.Items[2].Value = "Jake"
    
    c1MultiSelect1.Items[2].Value = "Jake";
    

    Back to Top

    Show/Hide check boxes

    By default, list of items in the MultiSelect control are displayed with check boxes. However, you can disable the default style by setting ShowCheckBoxes property to false.

    Hide checkbox in ComponentOne MultiSelect

    To hide the check boxes from the list, use the following code:

    C1MultiSelect1.ShowCheckBoxes = False
    
    c1MultiSelect1.ShowCheckBoxes = false;
    

    Back to Top

    Show/Hide dropdown button

    MultiSelect displays the dropdown button to show the list of available items. However, you can hide the dropdown button in the control by setting ShowDropDownButton property to false.

    Hide dropdown button in ComponentOne MultiSelect

    To hide the drop down button, use the following code:

    C1MultiSelect1.ShowDropDownButton = False
    
    c1MultiSelect1.ShowDropDownButton = false;
    

    Back to Top

    See Also