Click here to Skip to main content
Click here to Skip to main content

WPF AutoComplete TextBox

, 28 Jul 2014 CPOL
Rate this:
Please Sign up or sign in to vote.
An advanced and fully featured WPF AutoComplete TextBox control

WPF Auto Complete TextBox Control


In this article I will show you how to use an auto-complete/auto-suggest TextBox control in WPF. I have tried to keep the control simple and easy to use, yet fully featured and supporting MVVM.


I was once required to use a control in my project which can show suggestions to user while he/she is typing in the test box. I found my controls over the internet after googling for few hours, however none of them met my requirements. Finally I decided to create my own from the scratch.

I decided to keep it open-source and publised the source code at CodePlex. You may download the latest source code from

Using the code

The control uses ISuggestionProvider interface for displaying suggestions. ISuggestionProvider contains just one method GetSuggestions.
Let's create a simple suggestion provider for file-system.

Public Class FilesystemSuggestionProvider
    Implements ISuggestionProvider

    Public Function GetSuggestions(ByVal filter As String) As System.Collections.IEnumerable Implements ISuggestionProvider.GetSuggestions
        If String.IsNullOrEmpty(filter) Then
            Return Nothing
        End If
        If filter.Length < 3 Then
            Return Nothing
        End If

        If filter(1) <> ":"c Then
            Return Nothing
        End If

        Dim lst As New List(Of IO.FileSystemInfo)
        Dim dirFilter As String = "*"
        Dim dirPath As String = filter
        If Not filter.EndsWith("\") Then
            Dim index As Integer = filter.LastIndexOf("\")
            dirPath = filter.Substring(0, index + 1)
            dirFilter = filter.Substring(index + 1) + "*"
        End If
        Dim dirInfo As IO.DirectoryInfo = New IO.DirectoryInfo(dirPath)
        Return lst
    End Function

End Class

 Now we have created our suggestion provider. Let's add the control to our view. Adding the control to your view is very simple.

First of all you need to import the namespace of library in your view to add the control in your view.


Adding control to view:

<wpf:AutoCompleteTextBox VerticalAlignment="Top"
		SelectedItem="{Binding Path=SelectedPath, Mode=TwoWay}"
		ItemTemplate="{StaticResource ResourceKey=fsTemplate}"
		Watermark="Search here"
		Provider="{StaticResource ResourceKey=fsp}">
		<TextBlock Text="Loading..."
			   FontSize="14" />
		<Border Width="20"
			<TextBlock Text="??"
				   FontFamily="Segoe UI Symbol"
			           VerticalAlignment="Center" />

Adding ItemTemplate and FileSystemSuggestionProvider in Resources.

<local:FilesystemSuggestionProvider x:Key="fsp" />
<DataTemplate x:Key="fsTemplate">
    <Border Padding="5">
        <StackPanel Orientation="Vertical">
            <TextBlock Text="{Binding Path=Name}"
                       FontWeight="Bold" />
            <TextBlock Text="{Binding Path=LastWriteTime, StringFormat='Last Modified: {0}'}" />


Please visit CodePlex for version history and downloading latest version of the AutoCompleteTextBox.


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


About the Author

Bhardwaj Deepak
Technical Lead Interglobe Technologies
India India
Hello, I am Deepak Bhardwaj. I am working as Module Lead at Interglobe Technologies (IGT) in Microsoft .NET Technologies. I have worked on Winforms and WPF.
Follow on   Twitter   Google+   LinkedIn

Comments and Discussions

SuggestionMinor issues and their solving PinmemberSir_Draven21-Aug-14 4:01 
AnswerRe: Minor issues and their solving PinmemberBhardwaj Deepak21-Aug-14 18:55 
GeneralRe: Minor issues and their solving PinmemberSir_Draven21-Aug-14 20:48 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web02 | 2.8.141015.1 | Last Updated 28 Jul 2014
Article Copyright 2014 by Bhardwaj Deepak
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid