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
Adding xamMultiColumnComboEditor to Your Page	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
Related Content
- Topics

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.	CustomValueEnteredAction	`Add`
Allow the user to type text but this text will not be included in the items collection.	CustomValueEnteredAction	`Allow`
Prevent the user from typing invalid data. The user typed text is considered as a filter value.	CustomValueEnteredAction	`Ignore`

Example

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

Property	Value
CustomValueEnteredAction	Add
DisplayMemberPath	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
Configuring Data Binding and Visualization	This topic explains how to bind the xamMultiColumnComboEditor control to data and configure the items layout in the control’s drop-down list.
Configuring the Drop-Down	This topic explains how to configure the layout and behavior of the xamMultiColumnComboEditor Drop-Down.
Configuring Item Filtering	This topic describes how to configure items filtering in the xamMultiColumnComboEditor control.
Selection	The topics in this group explain selection feature in the xamMultiColumnComboEditor control and its use.

WPF | Help Topics