Skip to content
8 changes: 4 additions & 4 deletions wpf/Multi-Column-DropDown/Columns.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,19 +9,19 @@ documentation: ug

# Columns in WPF MultiColumn Dropdown

SfMultiColumnDropDownControl enables you to define the columns as like in SfDataGrid. You can let the `SfMultiColumnDropDownControl` to create columns or you can manually defined columns to de displayed. Below sections explains both ways,
WPF MultiColumn Dropdown enables you to define the columns as like in Data Grid. You can let the control to create columns or you can manually defined columns to be displayed. Below sections explains both ways,

1. Automatically generating columns
2. Manually define columns

## Automatically generating columns

The automatic column generation based on properties of data object can be enabled or disabled by setting [SfMultiColumnDropDownControl.AutoGenerateColumns](https://help.syncfusion.com/cr/wpf/Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.html#Syncfusion_UI_Xaml_Grid_SfMultiColumnDropDownControl_AutoGenerateColumns).
You can [refer here](http://help.syncfusion.com/wpf/sfdatagrid/columns#defining-columns) to know more about the automatic column generation in SfMultiColumnDropDownControl.
You can [refer here](http://help.syncfusion.com/wpf/sfdatagrid/columns#defining-columns) to know more about the automatic column generation in MultiColumn Dropdown.

## Manually defining columns

SfMultiColumnDropDownControl control allows you to define the columns manually by adding desired column to the [SfMultiColumnDropDownControl.Columns](https://help.syncfusion.com/cr/wpf/Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.html#Syncfusion_UI_Xaml_Grid_SfMultiColumnDropDownControl_Columns) collection.
MultiColumn Dropdown allows you to define the columns manually by adding desired column to the [SfMultiColumnDropDownControl.Columns](https://help.syncfusion.com/cr/wpf/Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.html#Syncfusion_UI_Xaml_Grid_SfMultiColumnDropDownControl_Columns) collection.

{% tabs %}
{% highlight xaml %}
Expand Down Expand Up @@ -49,7 +49,7 @@ sfMultiColumn.Columns.Add(new GridTextColumn() { MappingName = "Country" });
{% endhighlight %}
{% endtabs %}

![Manually generated the columns in WPF SfMultiColumnDropDown](Columns_images/Columns_img1.png)
![Manually generated the columns](Columns_images/Columns_img1.png)

### Customize auto-generated columns

Expand Down
10 changes: 5 additions & 5 deletions wpf/Multi-Column-DropDown/Data-Binding.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ documentation: ug

# Data Binding in WPF MultiColumn Dropdown

You can populate the drop down list for SfMultiColumnDropDownControl by setting [ItemsSource](https://help.syncfusion.com/cr/wpf/Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.html#Syncfusion_UI_Xaml_Grid_SfMultiColumnDropDownControl_ItemsSource) property.
You can populate the drop down list for WPF MultiColumn Dropdown by setting [ItemsSource](https://help.syncfusion.com/cr/wpf/Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.html#Syncfusion_UI_Xaml_Grid_SfMultiColumnDropDownControl_ItemsSource) property.
[DisplayMember](https://help.syncfusion.com/cr/wpf/Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.html#Syncfusion_UI_Xaml_Grid_SfMultiColumnDropDownControl_DisplayMember) denotes the path to a value on the data object for visual presentation of the Textbox and [ValueMember](https://help.syncfusion.com/cr/wpf/Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.html#Syncfusion_UI_Xaml_Grid_SfMultiColumnDropDownControl_ValueMember) denotes the path to a value on the data object to get the [SelectedValue](https://help.syncfusion.com/cr/wpf/Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.html#Syncfusion_UI_Xaml_Grid_SfMultiColumnDropDownControl_SelectedValue).

{% tabs %}
Expand Down Expand Up @@ -48,11 +48,11 @@ You can populate the drop down list for SfMultiColumnDropDownControl by setting

Here, `DisplayMember` is `Title` hence the Title property in underlying data object is displayed in the textbox and the `ValueMember` is `OrderID` hence the OrderID property in underlying data object is considered as the `SelectedValue`.

![Binding the data with SfMultiColumnDropDownControl Wpf](Data-Binding_images/Data-Binding_img1.png)
![Binding the data](Data-Binding_images/Data-Binding_img1.png)

## Binding with complex and indexer properties

SfMultiColumnDropDownControl provides support to display complex and indexer properties in its columns and also you can set complex and indexer properties as path to `DisplayMember` and `ValueMember` properties.
MultiColumn Dropdown provides support to display complex and indexer properties in its columns and also you can set complex and indexer properties as path to `DisplayMember` and `ValueMember` properties.

Binding with complex properties

Expand All @@ -76,7 +76,7 @@ Binding with complex properties
{% endhighlight %}
{% endtabs %}

![Binding the complex properties with SfMultiColumnDropDownControl wpf](Data-Binding_images/Data-Binding_img2.png)
![Binding the complex properties](Data-Binding_images/Data-Binding_img2.png)

Binding with indexer properties

Expand All @@ -100,4 +100,4 @@ Binding with indexer properties
{% endhighlight %}
{% endtabs %}

![Binding the indexer properties with SfMultiColumnDropDownControl wpf](Data-Binding_images/Data-Binding_img3.png)
![Binding the indexer properties](Data-Binding_images/Data-Binding_img3.png)
8 changes: 4 additions & 4 deletions wpf/Multi-Column-DropDown/Editing-and-AutoComplete.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,11 +9,11 @@ documentation: ug

# Editing and AutoComplete in WPF MultiColumn Dropdown

SfMultiColumnDropDownControl allows you to edit via TextBox. You can make the editor as read-only by setting [SfMultiColumnDropDownControl.ReadOnly](https://help.syncfusion.com/cr/wpf/Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.html#Syncfusion_UI_Xaml_Grid_SfMultiColumnDropDownControl_ReadOnly) property as `true`.
WPF MultiColumn Dropdown allows you to edit via TextBox. You can make the editor as read-only by setting [SfMultiColumnDropDownControl.ReadOnly](https://help.syncfusion.com/cr/wpf/Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.html#Syncfusion_UI_Xaml_Grid_SfMultiColumnDropDownControl_ReadOnly) property as `true`.

## Auto Completion of Text

SfMultiColumnDropDownControl auto append the text based on `ItemsSource` when end-user edits in the TextBox when setting [AllowAutoComplete](https://help.syncfusion.com/cr/wpf/Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.html#Syncfusion_UI_Xaml_Grid_SfMultiColumnDropDownControl_AllowAutoComplete) to `true`.
MultiColumn Dropdown auto append the text based on `ItemsSource` when end-user edits in the TextBox when setting [AllowAutoComplete](https://help.syncfusion.com/cr/wpf/Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.html#Syncfusion_UI_Xaml_Grid_SfMultiColumnDropDownControl_AllowAutoComplete) to `true`.

![Editing-and-AutoComplete_img1](Editing-and-AutoComplete_images/Editing-and-AutoComplete_img1.png)

Expand All @@ -36,7 +36,7 @@ You can open the popup while typing the value in editor itself by setting [Allow

## Open popup while loading

You can specify whether the popup is need to open or close by setting [IsDropDownOpen](https://help.syncfusion.com/cr/wpf/Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.html#Syncfusion_UI_Xaml_Grid_SfMultiColumnDropDownControl_IsDropDownOpen) as `true`. You can open the popup while loading the SfMultiColumnDropDownControl itself by setting `IsDropDownOpen` as `true`.
You can specify whether the popup is need to open or close by setting [IsDropDownOpen](https://help.syncfusion.com/cr/wpf/Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.html#Syncfusion_UI_Xaml_Grid_SfMultiColumnDropDownControl_IsDropDownOpen) as `true`. You can open the popup while loading the MultiColumn Dropdown itself by setting `IsDropDownOpen` as `true`.

{% tabs %}
{% highlight xml %}
Expand Down Expand Up @@ -67,7 +67,7 @@ void sfMultiColumn_Loaded(object sender, RoutedEventArgs e)
{% endtabs %}

## Keyboard Interactions
SfMultiColumnDropDownControl provides keyboard support for interaction. You can open the `DropDownGrid` without clicking the toggle button in SfMultiColumnDropDownControl by using the keyboard shortcuts.
MultiColumn Dropdown provides keyboard support for interaction. You can open the DropDownGrid without clicking the toggle button in the control.

<table>
<tr>
Expand Down
16 changes: 8 additions & 8 deletions wpf/Multi-Column-DropDown/Filtering.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ documentation: ug

# Filtering in WPF MultiColumn Dropdown

SfMultiColumnDropDownControl provides support to filter the drop down display list based on typed text by setting [AllowIncrementalFiltering](https://help.syncfusion.com/cr/wpf/Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.html#Syncfusion_UI_Xaml_Grid_SfMultiColumnDropDownControl_AllowIncrementalFiltering) as `true`. The records are filter based on `DisplayMember`.
WPF MultiColumn Dropdown provides support to filter the drop down display list based on typed text by setting [AllowIncrementalFiltering](https://help.syncfusion.com/cr/wpf/Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.html#Syncfusion_UI_Xaml_Grid_SfMultiColumnDropDownControl_AllowIncrementalFiltering) as `true`. The records are filter based on `DisplayMember`.

By default, drop down list is filtered based on `SearchCondition.StartsWith` condition. You can change the filtering search condition by setting [SearchCondition](https://help.syncfusion.com/cr/wpf/Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.html#Syncfusion_UI_Xaml_Grid_SfMultiColumnDropDownControl_SearchCondition) (StartsWith, Contains, Equals options).

Expand All @@ -33,15 +33,15 @@ By default, drop down list is filtered based on `SearchCondition.StartsWith` con
{% endhighlight %}
{% endtabs %}

![The image describes the AllowIncrementalFiltering support in SfMultiColumnDropDownControl WPF](Filtering_images/Filtering_img1.png)
![The image describes the AllowIncrementalFiltering support](Filtering_images/Filtering_img1.png)

## Case-Sensitive Filtering

You can decides whether the automatic completion of text and the filtering are case-sensitive or not by setting [AllowCaseSensitiveFiltering](https://help.syncfusion.com/cr/wpf/Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.html#Syncfusion_UI_Xaml_Grid_SfMultiColumnDropDownControl_AllowCaseSensitiveFiltering) as true.

## Ignore Diacritic Sensitivity

By default, SfMultiColumnDropDownControl filter or auto-complete the data based on an input character only. For example, if we type normal character in editor, it will not filter or auto-complete the record containing a diacritic character. You can disable the [AllowDiacriticSensitiveFiltering](https://help.syncfusion.com/cr/wpf/Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.html#Syncfusion_UI_Xaml_Grid_SfMultiColumnDropDownControl_AllowDiacriticSensitiveFiltering) property if you want to filter or auto-complete data that also contains a diacritic character while typing normal character in the editor.
By default, MultiColumn Dropdown filter or auto-complete the data based on an input character only. For example, if we type normal character in editor, it will not filter or auto-complete the record containing a diacritic character. You can disable the [AllowDiacriticSensitiveFiltering](https://help.syncfusion.com/cr/wpf/Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.html#Syncfusion_UI_Xaml_Grid_SfMultiColumnDropDownControl_AllowDiacriticSensitiveFiltering) property if you want to filter or auto-complete data that also contains a diacritic character while typing normal character in the editor.

{% tabs %}
{% highlight xml %}
Expand All @@ -58,11 +58,11 @@ By default, SfMultiColumnDropDownControl filter or auto-complete the data based
{% endhighlight %}
{% endtabs %}

![The image describes the AllowDiacriticSensitiveFiltering support in SfMultiColumnDropDownControl WPF](Filtering_images/Filtering_img3.gif)
![The image describes the AllowDiacriticSensitiveFiltering support](Filtering_images/Filtering_img3.gif)

## How to filter SfMultiColumnDropDownControl based on various column values
## How to filter MultiColumn Dropdown based on various column values

By default, SfMultiColumnDropDownControl filter the text based on `DisplayMember` (considers single column text only). You can also filter the text based on multiple columns by overriding the [FilterRecord](https://help.syncfusion.com/cr/wpf/Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.html#Syncfusion_UI_Xaml_Grid_SfMultiColumnDropDownControl_FilterRecord_System_Object_) method in `SfMultiColumnDropDownControl` and use the [SearchText](https://help.syncfusion.com/cr/wpf/Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.html#Syncfusion_UI_Xaml_Grid_SfMultiColumnDropDownControl_SearchText) property to get the entered text in editor.
By default, MultiColumn Dropdown filter the text based on `DisplayMember` (considers single column text only). You can also filter the text based on multiple columns by overriding the [FilterRecord](https://help.syncfusion.com/cr/wpf/Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.html#Syncfusion_UI_Xaml_Grid_SfMultiColumnDropDownControl_FilterRecord_System_Object_) method and use the [SearchText](https://help.syncfusion.com/cr/wpf/Syncfusion.UI.Xaml.Grid.SfMultiColumnDropDownControl.html#Syncfusion_UI_Xaml_Grid_SfMultiColumnDropDownControl_SearchText) property to get the entered text in editor.

{% tabs %}
{% highlight c# %}
Expand Down Expand Up @@ -103,10 +103,10 @@ public class CustomMultiColumnControl : SfMultiColumnDropDownControl

Here, `Title` is defined as a `DisplayMember`. But it also searches the match case from the `Cast` column also while filtering.

![The image describes the custom filtering by FilterRecord method in SfMultiColumnDropDownControl WPF](Filtering_images/Filtering_img2.png)
![The image describes the custom filtering by FilterRecord method](Filtering_images/Filtering_img2.png)


N> Excel-like filtering is not supported in SfMultiColumnDropDownControl. You can customize the SfMultiColumnDropDownControl ControlTemplate to enable the Excel-like filtering by setting `AllowFiltering` as true in SfDataGrid.
N> Excel-like filtering is not supported in MultiColumn Dropdown. You can customize its ControlTemplate to enable the Excel-like filtering by setting `AllowFiltering` as true in Data Grid.

## Filtering Delay
By default, filtering and auto-completion operations performed while typing in the editor will be delayed for a specified amount of time (milliseconds). The period of delaying filtering and auto-completion operations can be specified by the `FilterDelay` property. The default value for the `FilterDelay` property is `500`.
Expand Down
Loading