Version

Configuring the Behavior on User Input (xamMultiColumnComboEditor)

Topic Overview

Purpose

This topic describes how to configure the executed action when the user types and after that hits 'Enter' key in the input text field in the xamMultiColumnComboEditor™ control.

Required background

The following topic is a prerequisite to understanding this topic:

Topic Purpose

This topic describes how to add a xamMultiColumnComboEditor control to your application and use some of its properties.

In this topic

This topic contains the following sections:

Configuring the Behavior on User Input

Overview

Configure the behavior of the xamMultiColumnComboEditor when a user types in the input text field using the CustomValueEnteredAction property.

By default, this property is set to Ignore and typing text in the input text field results in filtering the xamMultiColumnComboEditor items.

Property settings

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

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

Add the user typed text to the underlying ItemsSource and the new entry to become valid data for selection.

Add

Allow the user to type text but this text will not be included in the items collection.

Allow

Prevent the user from typing invalid data. The user typed text is considered as a filter value.

Ignore

Example

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

Property Value

Add

ProductName
Configuring the Behavior on User Input 1.png

Following is the code that implements this example.

In XAML:

<ig:XamMultiColumnComboEditor x:Name="MultiColumnComboEditor"
                              ItemsSource="{Binding Path=Products}"
                              Height="30" Width="300"
                              AutoGenerateColumns="False"
                              DisplayMemberPath="ProductName"
                              CustomValueEnteredAction="Add">
    <ig:XamMultiColumnComboEditor.Columns>
        <ig:TextComboColumn Key="ProductName"/>
        <ig:TextComboColumn Key="UnitsInStock"/>
    </ig:XamMultiColumnComboEditor.Columns>
</ig:XamMultiColumnComboEditor>

Related Content

Topics

The following topics provide additional information related to this topic.

Topic Purpose

This topic explains how to bind the xamMultiColumnComboEditor control to data and configure the items layout in the control’s drop-down list.

This topic explains how to configure the layout and behavior of the xamMultiColumnComboEditor Drop-Down.

This topic describes how to configure items filtering in the xamMultiColumnComboEditor control.

The topics in this group explain selection feature in the xamMultiColumnComboEditor control and its use.