Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 8 additions & 8 deletions wpf/Autocomplete/Autocomplete-and-filtering.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,19 @@
---
layout: post
title: Autocomplete and Filtering in WPF AutoComplete | Syncfusion®
description: Autocomplete and Filtering in SfTextBoxExt provide relevant suggestions, dynamic filtering, and search assistance as users enter text.
description: Autocomplete and Filtering in WPF AutoComplete provide relevant suggestions, dynamic filtering, and search assistance as users enter text.
platform: wpf
control: SfTextBoxExt
documentation: ug
---

# Autocomplete and filtering in WPF Autocomplete (SfTextBoxExt)
# Autocomplete and filtering in WPF AutoComplete (SfTextBoxExt)

The AutoComplete functionality provides several modes of suggestions while typing. The suggested text can be appended to the original text, or can be displayed in a drop-down list so that searched item can be chosen based on the filtering option set.
The [WPF AutoComplete](https://www.syncfusion.com/wpf-controls/autocomplete) control provides several modes of suggestions while typing. The suggested text can be appended to the original text or displayed in a drop-down list so that a searched item can be chosen based on the filtering option set. The WPF AutoComplete control is implemented through the [SfTextBoxExt](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html) class.

## AutoComplete source
## WPF AutoComplete source

The [SfTextBoxExt](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html) control can be populated with a predefined list of items bind to the [AutoCompleteSource](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html#Syncfusion_Windows_Controls_Input_SfTextBoxExt_AutoCompleteSource) property. The data can be either a list of strings or a custom data.
The [SfTextBoxExt](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html) control can be populated with a predefined list of items bound to the [AutoCompleteSource](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html#Syncfusion_Windows_Controls_Input_SfTextBoxExt_AutoCompleteSource) property. The data can be either a list of strings or custom data.


{% tabs %}
Expand All @@ -30,7 +30,7 @@ The [SfTextBoxExt](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Control
{% endhighlight %}
{% endtabs %}

For further details, refer to [Populating Autocomplete with Data](https://help.syncfusion.com/wpf/autocomplete/getting-started#populating-autocomplete-with-data).
For further details, refer to [Populating WPF AutoComplete with Data](https://help.syncfusion.com/wpf/autocomplete/getting-started#populating-autocomplete-with-data).

![AutoCompleteSource](AutoComplete_and_filtering_images/AutoCompleteSource.png)

Expand Down Expand Up @@ -204,7 +204,7 @@ The control returns all possible matches that equals the typed text based on the
Custom
</td>
<td>
The control returns all possible matches based on the Filter property. Filter property is of type SuggestionPredicate. In the MyFilter method, filtration is done by checking whether the collection contains the typed text.
The control returns all possible matches based on the `Filter` property. The `Filter` property is of type `SuggestionPredicate`. In the `MyFilter` method, filtering is performed by checking whether the collection contains the typed text.
</td>
</tr>
<tr>
Expand Down Expand Up @@ -465,7 +465,7 @@ N> View [sample](https://github.com/SyncfusionExamples/wpf-textboxext-examples/t

## Display a message when suggestions are empty

When the entered item is not in the suggestion list, AutoComplete displays a text indicating that there is no search results found. Th text to be displayed for this can be customized using the [NoResultsFoundTemplate](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html#Syncfusion_Windows_Controls_Input_SfTextBoxExt_NoResultsFoundTemplate) property.
When the entered item is not in the suggestion list, the WPF AutoComplete displays a text indicating that there is no search results found. Th text to be displayed for this can be customized using the [NoResultsFoundTemplate](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html#Syncfusion_Windows_Controls_Input_SfTextBoxExt_NoResultsFoundTemplate) property.

{% tabs %}
{% highlight xaml %}
Expand Down
4 changes: 2 additions & 2 deletions wpf/Autocomplete/Diacritic-Sensitivity.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,9 @@ control: SfTextBoxExt
documentation: ug
---

# Diacritic Sensitivity in WPF Autocomplete (SfTextBoxExt)
# Diacritic Sensitivity in WPF AutoComplete (SfTextBoxExt)

The control does not stick with one type of keyboard, so it can be populated with the items from a language with letters containing diacritics, and search for them with English characters from an en-US keyboard. Enable or disable the diacritic sensitivity using the [IgnoreDiacritic](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html#Syncfusion_Windows_Controls_Input_SfTextBoxExt_IgnoreDiacritic) property. The following code example demonstrates how to enable the diacritic sensitivity.
The [WPF AutoComplete](https://www.syncfusion.com/wpf-controls/autocomplete) control supports searching items containing diacritics with English characters from an en-US keyboard. The WPF AutoComplete control is implemented through the [SfTextBoxExt](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html) class. Enable or disable diacritic sensitivity by using the [IgnoreDiacritic](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html#Syncfusion_Windows_Controls_Input_SfTextBoxExt_IgnoreDiacritic) property. The following code example demonstrates how to enable diacritic sensitivity.

{% tabs %}

Expand Down
10 changes: 5 additions & 5 deletions wpf/Autocomplete/Dropdown-customization.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
---
layout: post
title: Dropdown Customization in WPF AutoComplete | Syncfusion®
description: Dropdown Customization in SfTextBoxExt enables tailoring the appearance and behavior of suggestion lists.
description: Dropdown Customization in WPF AutoComplete enables tailoring the appearance and behavior of suggestion lists.
platform: wpf
control: SfTextBoxExt
documentation: ug
---

# Dropdown customization in WPF Autocomplete (SfTextBoxExt)
# Dropdown customization in WPF AutoComplete (SfTextBoxExt)

Suggestion box is the drop-down list box, which displays the filtered suggestions inside a pop-up. This section explains the properties and customizations that deals with drop-down list in the `AutoComplete` control.
The suggestion box is a drop-down list that displays filtered suggestions in a pop-up. This section explains the properties and customizations for the drop-down list in the `AutoComplete` control. The [WPF AutoComplete](https://www.syncfusion.com/wpf-controls/autocomplete) control is implemented through the [SfTextBoxExt](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html) class.

## Customize the background

Expand Down Expand Up @@ -136,7 +136,7 @@ textBoxExt.SuggestionBoxPlacement = SuggestionBoxPlacement.None;

## Setting the maximum height

The maximum height of the suggestion box in the AutoComplete control can be changed using the [MaximumDropDownHeight](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html#Syncfusion_Windows_Controls_Input_SfTextBoxExt_MaxDropDownHeight) property.
The maximum height of the suggestion box in the WPF AutoComplete control can be changed using the [MaximumDropDownHeight](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html#Syncfusion_Windows_Controls_Input_SfTextBoxExt_MaxDropDownHeight) property.

{% tabs %}

Expand Down Expand Up @@ -240,7 +240,7 @@ textBoxExt.SelectionBackgroundColor = new SolidColorBrush(Colors.Red);

## Highlighting matched text in DropDown

`SfTextBoxExt` supports highlighting the first matched item when a dropdown is opened by setting the `AutoHighlightMatchedItem` API to true. The default value is false.
The WPF AutoComplete supports highlighting the first matched item when a dropdown is opened by setting the `AutoHighlightMatchedItem` API to true. The default value is false.

{% tabs %}

Expand Down
28 changes: 15 additions & 13 deletions wpf/Autocomplete/Getting-Started.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,15 @@
---
layout: post
title: Getting Started with WPF Autocomplete | Syncfusion®
description: Learn how to get started with the Syncfusion® WPF Autocomplete (SfTextBoxExt) control. Explore setup, features, examples, and customization options.
title: Getting Started with WPF Autocomplete SfTextBoxExt | Syncfusion®
description: Learn how to get started with the Syncfusion® WPF Autocomplete SfTextBoxExt control, including setup, features, examples, and customization options.
platform: wpf
control: SfTextBoxExt
documentation: ug
---

# Getting Started with WPF Autocomplete (SfTextBoxExt)
# Getting Started with WPF AutoComplete (SfTextBoxExt)

This section explains how to create the [WPF AutoComplete](https://www.syncfusion.com/wpf-controls/autocomplete) control in a WPF application. The WPF AutoComplete control is implemented through the [SfTextBoxExt](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html) class.

## Assembly deployment

Expand All @@ -17,7 +19,7 @@ Refer to this [How to install nuget packages](https://help.syncfusion.com/wpf/we

## Creating a simple application

Create a WPF application with [SfTextBoxExt](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html) control using the following steps:
Create a WPF application with the [SfTextBoxExt](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html) control using the following steps:

### Create a project

Expand Down Expand Up @@ -111,9 +113,9 @@ namespace TextBoxExt

![GettingStarted](GettingStarted_images/GettingStarted.png)

## Populating AutoComplete with Data
## Populating WPF AutoComplete with Data

AutoComplete is a data-bound control. So before create binding to the control, you must create data model for Application.
The WPF AutoComplete is a data-bound control. So before create binding to the control, you must create data model for Application.

For illustration, let us create a textbox, which will populate a list of employees.

Expand Down Expand Up @@ -178,7 +180,7 @@ public class Employee
{% endcapture %}
{{ codesnippet4 | OrderList_Indent_Level_1 }}

3. To populate the AutoComplete with data, set the [AutoCompleteSource](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html#Syncfusion_Windows_Controls_Input_SfTextBoxExt_AutoCompleteSource) property to `IEnumerable` implementation.
3. To populate the WPF AutoComplete with data, set the [AutoCompleteSource](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html#Syncfusion_Windows_Controls_Input_SfTextBoxExt_AutoCompleteSource) property to `IEnumerable` implementation.


Bind the collection created in previous step to [AutoCompleteSource](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html#Syncfusion_Windows_Controls_Input_SfTextBoxExt_AutoCompleteSource) property in XAML by setting EmployeeViewModel as `DataContext`.
Expand Down Expand Up @@ -231,11 +233,11 @@ this.Content = textBoxExt;
{% endcapture %}
{{ codesnippet5 | OrderList_Indent_Level_1 }}

For further details, refer to [AutoComplete source](https://help.syncfusion.com/wpf/autocomplete/autocomplete-and-filtering#autocomplete-source).
For further details, refer to [WPF AutoComplete source](https://help.syncfusion.com/wpf/autocomplete/autocomplete-and-filtering#autocomplete-source).

![GettingStarted](GettingStarted_images/AutoCompleteSource.png)

## AutoComplete modes
## WPF AutoComplete modes

Suggestions can be shown in number of ways. [SfTextBoxExt](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html) supports the following.

Expand Down Expand Up @@ -298,23 +300,23 @@ textBoxExt.AutoCompleteMode = AutoCompleteMode.Suggest;

## Selection

By default single selection is enable in AutoComplete control. It can set the [MultiSelectMode](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html#Syncfusion_Windows_Controls_Input_SfTextBoxExt_MultiSelectMode) property to specify whether a single or multiple selection.
By default single selection is enable in WPF AutoComplete control. It can set the [MultiSelectMode](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html#Syncfusion_Windows_Controls_Input_SfTextBoxExt_MultiSelectMode) property to specify whether a single or multiple selection.

Index of the selected items can be retrieved using the [SuggestionIndex](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html#Syncfusion_Windows_Controls_Input_SfTextBoxExt_SuggestionIndex) property.

The selected items of the AutoComplete can be retrieved using the [SelectedItem](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html#Syncfusion_Windows_Controls_Input_SfTextBoxExt_SelectedItem) property for single selection.
The selected items of the WPF AutoComplete can be retrieved using the [SelectedItem](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html#Syncfusion_Windows_Controls_Input_SfTextBoxExt_SelectedItem) property for single selection.

In Multi-selection, [SelectedItems](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html#Syncfusion_Windows_Controls_Input_SfTextBoxExt_SelectedItems) property contains the items that are selected in the control.

The selected values of the AutoComplete can be retrieved using the [SelectedValue](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html#Syncfusion_Windows_Controls_Input_SfTextBoxExt_SelectedValue) property.
The selected values of the WPF AutoComplete can be retrieved using the [SelectedValue](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html#Syncfusion_Windows_Controls_Input_SfTextBoxExt_SelectedValue) property.

For further details, refer to the [Retrieving SelectedValue](https://help.syncfusion.com/wpf/autocomplete/single-and-multiple-selection#retrieving-selectedvalue) and [Setting and retrieving SelectedItem](https://help.syncfusion.com/wpf/autocomplete/single-and-multiple-selection#setting-and-retrieving-selecteditem).

N> View [sample](https://github.com/SyncfusionExamples/wpf-textboxext-examples/tree/master/Samples/Getting-Started) in GitHub

## Theme

SfTextBoxExt supports various built-in themes. Refer to the below links to apply themes for the SfTextBoxExt,
The WPF AutoComplete control supports various built-in themes. Refer to the following links to apply themes to the control:

* [Apply theme using SfSkinManager](https://help.syncfusion.com/wpf/themes/skin-manager)

Expand Down
8 changes: 4 additions & 4 deletions wpf/Autocomplete/Highlighting-matched-text.md
Original file line number Diff line number Diff line change
@@ -1,21 +1,21 @@
---
layout: post
title: Highlighting Matched Text in WPF AutoComplete | Syncfusion®
description: Highlighting Matched Text in SfTextBoxExt visually emphasizes matching characters within filtered suggestion results.
description: Highlighting Matched Text in WPF AutoComplete visually emphasizes matching characters within filtered suggestion results.
platform: wpf
control: SfTextBoxExt
documentation: ug
---

# Highlighting Matched Text in WPF Autocomplete (SfTextBoxExt)
# Highlighting Matched Text in WPF AutoComplete (SfTextBoxExt)

By using the [TextHighlightMode](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html#Syncfusion_Windows_Controls_Input_SfTextBoxExt_TextHighlightMode) property, highlight matching and unmatched characters in a suggestion list to pick an item with more clarity. The default value is None. The matching text can be highlighted in the following two ways:
The [WPF AutoComplete](https://www.syncfusion.com/wpf-controls/autocomplete) control can highlight matching and unmatched characters in a suggestion list by using the [TextHighlightMode](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html#Syncfusion_Windows_Controls_Input_SfTextBoxExt_TextHighlightMode) property. The WPF AutoComplete control is implemented through the [SfTextBoxExt](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html) class. The default value is `None`. The matching text can be highlighted in the following ways:

* First occurrence
* Multiple occurrence
* Unmatched

The text highlight can be indicated by customizing the color of the characters using [HighlightedTextColor](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html#Syncfusion_Windows_Controls_Input_SfTextBoxExt_HighlightedTextColor) property and style of the characters using [HighlightedTextStyle](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html#Syncfusion_Windows_Controls_Input_SfTextBoxExt_HighlightedTextStyle) property.
You can customize the highlighted character color by using the [HighlightedTextColor](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html#Syncfusion_Windows_Controls_Input_SfTextBoxExt_HighlightedTextColor) property and the character style by using the [HighlightedTextStyle](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html#Syncfusion_Windows_Controls_Input_SfTextBoxExt_HighlightedTextStyle) property.

N> The [HighlightedTextStyle](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html#Syncfusion_Windows_Controls_Input_SfTextBoxExt_HighlightedTextStyle) property style target type is [Run](https://docs.microsoft.com/en-us/dotnet/api/system.windows.documents.run?view=net-5.0).

Expand Down
2 changes: 1 addition & 1 deletion wpf/Autocomplete/Multipath-search.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ documentation: ug

# How to Perform Multi-Path Searching in WPF AutoComplete

Multi-path search can be achieved using the custom search feature by setting the [SuggestionMode](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html#Syncfusion_Windows_Controls_Input_SfTextBoxExt_SuggestionMode) property as `Custom`. Users can define a custom filter and can be assigned to the [Filter](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html#Syncfusion_Windows_Controls_Input_SfTextBoxExt_Filter) property.
The [WPF AutoComplete](https://www.syncfusion.com/wpf-controls/autocomplete) control supports multi-path searching by using the custom search feature. The WPF AutoComplete control is implemented through the [SfTextBoxExt](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html) class. Set the [SuggestionMode](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html#Syncfusion_Windows_Controls_Input_SfTextBoxExt_SuggestionMode) property to `Custom`. Users can define a custom filter and assign it to the [Filter](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Controls.Input.SfTextBoxExt.html#Syncfusion_Windows_Controls_Input_SfTextBoxExt_Filter) property.

**Model**

Expand Down
Loading