Version

Configuring Multiple Selection (xamComboEditor)

Topic Overview

Purpose

This topic describes how to configure the multiple selection option in the xamComboEditor™ control.

Required background

The following topic is a prerequisite to understanding this topic:

Topic Purpose

This topic describes how to get started with the xamComboEditor control and how to add it to your page using procedural code.

Multiple Selection Configuration Summary

Multiple selection configuration summary chart

The following table briefly explains the configurable aspects of multiple selection in the xamComboEditor control and maps them to the properties that configure them. Further details are available after the table.

Configurable aspect Details Properties

Enable Multiple selection to allow selecting many xamComboEditor items at the same time.

Facilitate Multiple selection by enabling the xamComboEditor items check boxes visibility.

Enabling Multiple Items selection

Overview

Enable multiple items selection in the xamComboEditor through the AllowMultipleSelection property.

Select the various xamComboEditor items by holding the CTRL keyboard key while using the mouse’s left button clicks or by checking the items check boxes.

Property settings

The following table maps the desired configuration to the property settings that manage it.

In order to: Use this property: And set it to:

Enable multiple items selection

true

Example

The screenshot below demonstrates how the xamComboEditor behaves as a result of the following settings:

Property Value

true

Configuring Multiple Selection 1.png

Following is the code that implements this example.

In XAML:

<ig:XamComboEditor x:Name="ComboEditor"
                   ItemsSource="{Binding Path=Categories}"
                   AllowMultipleSelection="True"
                   DisplayMemberPath="CategoryName"
                   Height="30" Width="200"/>

Enabling Items Check Boxes Visibility

Overview

Perform multiple selection in the xamComboEditor by checking the items check boxes. In order for the user to perform this, the items check boxes must be visible.

The xamComboEditor CheckBoxVisibility property configures the visibility of the items check boxes.

Property settings

The following table maps the desired configuration to the property settings that manage it.

In order to: Use this property: And set it to:

Enable selection through items check boxes

Visible

Example

The screenshot below demonstrates how the xamComboEditor looks as a result of the following settings:

Property Value

True

Visible

Configuring Multiple Selection 2.png

Following is the code that implements this example.

In XAML:

<ig:XamComboEditor x:Name="ComboEditor"
                   ItemsSource="{Binding Path=Categories}"
                   AllowMultipleSelection="True"
                   CheckBoxVisibility="Visible"
                   DisplayMemberPath="CategoryName"
                   Height="30" Width="200"/>

Related Content

Topics

The following topics provide additional information related to this topic.

Topic Purpose

This topic describes user selection interactions in the xamComboEditor control.

This topic describes how to programmatically perform selection in the xamComboEditor control.