Click here to Skip to main content
15,867,594 members
Articles / Web Development / ASP.NET

Multiple-Selection ComboBox for Silverlight

Rate me:
Please Sign up or sign in to vote.
4.39/5 (12 votes)
12 Mar 2013CPOL3 min read 159.6K   4.4K   27   43
A tutorial on how to create a Multiple-Selection ComboBox for Silverlight

Introduction

ComboBox is a widely used control. Sometimes, we want to go beyond its default capability, such as multiple-selection. In this article, I will walk through with you how to create a multiple-selection ComboBox for Silverlight. The same approach applies to WPF. I will use Expression Blend for design. It is efficient to use the Blend to create a resource skeleton; and you can use either Blend or Visual Studio to edit the code.

In this updated version, I answered the most asked question: How to display the selected items?

Step by Step

The goal is to create a multiple-selection ComboBox as shown in the left side of following figure. The items in the dropdown should display with CheckBoxes. The right side ListBox demonstrates the same XAML code can be used for a multiple selection ListBox. One stone kills two birds!

Image 1

Assume you have a ComboBox in place, and want to make it supporting multiple-selection. First, right-click the ComboBox to popup the context menu. In the menu, select Edit Template -> Edit a Copy. This will open the Create Style Resource dialog box. You can rename the default Name (Key) in the dialog. And then click OK to close the dialog.

Image 2

Now you get the default template of the ComboBox in your .xaml file. You can browse the details in the following window, and figure out how the ComboBox works: when you click the ComboBox, it pops up a Popup control. By default, the Popup control uses an ItemsPresenter to display the SourceItems of the ComboBox. We need to replace it with a ListBox which supports multiple-selection.

Tips

  • The Windows theme setting will effect on the Blend generated template. I suggest you avoid Basic Themes.
  • The Blend generated template could be slightly different with different versions of Silverlight. If you cannot make the ComboBox template generated with Silverlight 3 work with Silverlight 4, regenerate it Silverlight 4.

Image 3

We also need to the replace the ListBoxItem with CheckBox so that the user can easily identify the selection status. It would be efficient to do this in the XAML window. Let’s create the CheckBoxListBoxItemStyle style as follows:

XML
<Style x:Key="CheckBoxListBoxItemStyle" TargetType="ListBoxItem">
    <Setter Property="Foreground" Value="#FF000000" />
    <Setter Property="Template">
        <Setter.Value>
            <ControlTemplate TargetType="ListBoxItem">
                <Grid x:Name="RootElement">
                    <CheckBox ClickMode="Press" Content="{Binding Path=Name}"
                          IsChecked="{Binding Path=IsSelected, Mode=TwoWay}" />
                </Grid>
            </ControlTemplate>
        </Setter.Value>
    </Setter>
</Style> 

Make sure you set ClickMode="Press"; and Mode=TwoWay.

The data I am using here is very simple: a Name property, and an IsSelected property.

Image 4 

Set the ItemContainerStyle in the ListBox to the CheckBoxListBoxItemStyle as follows:

XML
<ListBox x:Name="lstBox" SelectionMode="Multiple"
                 ItemsSource="{TemplateBinding ItemsSource}"
                 ItemContainerStyle="{StaticResource CheckBoxListBoxItemStyle}"
                 HorizontalAlignment="Stretch" />

Now you can build and run the project. In the demo page, I included an additional ListBox, which is bound to the same data. The ListBox reuses the same style CheckBoxListBoxItemStyle. With the ListBox, you can validate that the selection is updated on both the ComboBox and the ListBox.

Now it’s time to create a Resource Dictionary file, and move the resource (templates and styles) to the Resource Dictionary.

It seems ambiguous to display the selected items in the collapsed ComboBox, which is designed to display a single item. Here we need the creativity of the User Interface design. For instance, we can reduce the width of the ComboBox, and use a separate ItemsControl to display the selected items. The ItemsControl binds to the same data as ComboBox, but displays selected items only. We can implement a converter class with IValueConverter to convert the IsSelected bool property to Visibility. In this way, the ItemsControl displays selected items only.

XML
<ItemsControl ItemsSource="{Binding Data}" >
<ItemsControl.ItemTemplate>
              <DataTemplate>
                    <TextBlock Text="{Binding Name}"
			Visibility="{Binding IsSelected,
			Converter={StaticResource BoolToVisibilityConverter}}" />
              </DataTemplate>
</ItemsControl.ItemTemplate>
</ItemsControl>

Further, we can use the Tooltip to display the selected items. The following figure shows the Tooltip with an ItemsControl embedded within.

Image 5

Following is the code snippet for how to embed an ItemsControl in the Tooltip:

XML
<ComboBox ItemsSource="{Binding Data}" Width="26" VerticalAlignment="Center"
	Style="{StaticResource MultiSelComboBoxStyle}" >
    <ToolTipService.ToolTip>
        <ToolTip>
            <ItemsControl ItemsSource="{Binding Data}" Margin="4" >
                <ItemsControl.ItemTemplate>
                    <DataTemplate>
                        <TextBlock Text="{Binding Name}"
			Visibility="{Binding IsSelected,
			Converter={StaticResource BoolToVisibilityConverter}}" />
                    </DataTemplate>
                </ItemsControl.ItemTemplate>
            </ItemsControl>
        </ToolTip>
    </ToolTipService.ToolTip>
</ComboBox>

Conclusion

The ComboBox contains a Popup control for hosting the item selection control. You can replace the default one to customize the behavior, such as multiple selection. Technically, you can embed a UserControl (or almost any control) in the Popup control. This opens the door for creating more sophisticated User Interface. For detail. please read How to Popup Anything? 

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Technical Lead
United States United States
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
SuggestionRe: How to get the selected index changed event fired? Pin
Frank W. Wu10-Jul-12 8:35
Frank W. Wu10-Jul-12 8:35 
GeneralRe: How to get the selected index changed event fired? Pin
dbernhardt18-Jul-12 4:08
dbernhardt18-Jul-12 4:08 
GeneralRe: How to get the selected index changed event fired? Pin
Frank W. Wu18-Jul-12 8:12
Frank W. Wu18-Jul-12 8:12 
QuestionCodeplex project Pin
Adriaan Davel29-Mar-12 20:27
Adriaan Davel29-Mar-12 20:27 
GeneralMy vote of 5 Pin
LR___1-Dec-11 7:36
LR___1-Dec-11 7:36 
QuestionCustomize your great control Pin
Mr. J.4-Aug-11 21:10
Mr. J.4-Aug-11 21:10 
AnswerRe: Customize your great control Pin
Frank W. Wu7-Aug-11 3:43
Frank W. Wu7-Aug-11 3:43 
GeneralRe: Customize your great control Pin
Mr. J.6-Sep-11 20:44
Mr. J.6-Sep-11 20:44 
GeneralRe: Customize your great control Pin
Frank W. Wu7-Sep-11 2:41
Frank W. Wu7-Sep-11 2:41 
GeneralMy vote of 3 Pin
Johnny J.2-May-11 3:28
professionalJohnny J.2-May-11 3:28 
GeneralRe: My vote of 3 Pin
Shimmy Weitzhandler6-Mar-12 18:17
Shimmy Weitzhandler6-Mar-12 18:17 
GeneralHow to display text on this multiselect combobox?? Pin
Piyush Nandanwar28-Apr-11 20:33
Piyush Nandanwar28-Apr-11 20:33 
GeneralRe: How to display text on this multiselect combobox?? Pin
Frank W. Wu29-Apr-11 4:28
Frank W. Wu29-Apr-11 4:28 
GeneralRe: How to display text on this multiselect combobox?? Pin
Johnny J.2-May-11 3:27
professionalJohnny J.2-May-11 3:27 
GeneralRe: How to display text on this multiselect combobox?? Pin
Frank W. Wu2-May-11 6:47
Frank W. Wu2-May-11 6:47 
QuestionRe: How to display text on this multiselect combobox?? Pin
Shimmy Weitzhandler6-Mar-12 18:16
Shimmy Weitzhandler6-Mar-12 18:16 
GeneralHelpful instruction, thanks you! Pin
mg80s11-Jan-11 3:11
mg80s11-Jan-11 3:11 
QuestionHow to make this a control? Pin
rvk12-Feb-10 8:29
rvk12-Feb-10 8:29 
AnswerRe: How to make this a control? Pin
Frank W. Wu16-Feb-10 3:35
Frank W. Wu16-Feb-10 3:35 
GeneralRe: How to make this a control? Pin
rvk17-Feb-10 6:19
rvk17-Feb-10 6:19 
GeneralRe: How to make this a control? Pin
Frank W. Wu18-Feb-10 4:52
Frank W. Wu18-Feb-10 4:52 
GeneralRe: How to make this a control? Pin
rvk18-Feb-10 5:39
rvk18-Feb-10 5:39 
GeneralRe: How to make this a control? Pin
Frank W. Wu18-Feb-10 11:14
Frank W. Wu18-Feb-10 11:14 
QuestionRe: How to make this a control? Pin
Dave290930-May-11 16:46
Dave290930-May-11 16:46 
AnswerRe: How to make this a control? Pin
Frank W. Wu31-May-11 7:03
Frank W. Wu31-May-11 7:03 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.