New to Telerik UI for WPF? Start a free 30-day trial

AutocompleteBehavior

Class

This class presents a behavior for the autocomplete used in the ItemsControls.

Definition

Namespace:Telerik.Windows.Controls.Primitives

Assembly:Telerik.Windows.Controls.dll

Syntax:

public class AutocompleteBehavior

Inheritance: objectAutocompleteBehavior

Constructors

AutocompleteBehavior()

Initializes a new instance of the AutocompleteBehavior class.

public AutocompleteBehavior()

Properties

AllowCustomText

bool

Gets or sets a value indicating whether a custom text is allowed.

public bool AllowCustomText { get; set; }

AutoCompleteTimeout

TimeSpan

Gets or sets the autocomplete timeout. When the timeout is over, the typed text for the autocomplete is reset.

public static TimeSpan AutoCompleteTimeout { get; set; }

CurrentText

string

Gets the current text that is used for the autocomplete.

public string CurrentText { get; }

IsIndexSelectable

Func<int, bool>

Gets or sets whether the item associated with the index is selectable.

public Func<int, bool> IsIndexSelectable { get; set; }

ItemSearch

IItemSearchControl

Gets or sets the ItemSearch for the autocomplete. The IItemSearchControl object defines the logic how the items are found with the retrievers.

public IItemSearchControl ItemSearch { get; set; }

LastSelectionLength

int

Gets the last length of the selection.

protected int LastSelectionLength { get; }

LastSelectionStart

int

Gets the last selection start.

protected int LastSelectionStart { get; }

LastText

string

Gets the last text that is set.

protected string LastText { get; }

MatchingItem

object

Gets the matching item.

public object MatchingItem { get; }

TextRetriever

IValueRetriever

Gets or sets the text Retriever that is used for autocomplete.

public IValueRetriever TextRetriever { get; set; }

TextSearchMode

Gets or sets the text search mode. Specifies how TextSearch will match items.

public TextSearchMode TextSearchMode { get; set; }

Property Value:

The text search mode.

TextSource

ITextSource

Gets or sets the text source.

public ITextSource TextSource { get; set; }

Methods

ExtractCurrentText()

string

Extracts the current text from the current selection to its length.

protected virtual string ExtractCurrentText()

Returns:

string

IsFullMatch(object)

bool

Determines whether the matched item is found with full match or not.

public bool IsFullMatch(object item)

Parameters:itemobject

The item.

Returns:

bool

SetCurrentText(string)

bool

Sets a current text for the autocomplete.

public bool SetCurrentText(string text)

Parameters:textstring

The text.

Returns:

bool

TextSourceSelectionChangeDetected()

bool

This property is used to detect whether the test source selection change is detected or not.

protected bool TextSourceSelectionChangeDetected()

Returns:

bool

TextSourceTextChangeDetected()

bool

This property is used to detect whether the test source text change is detected or not.

protected bool TextSourceTextChangeDetected()

Returns:

bool

UpdateCurrentText()

bool

Updates the current text.

protected bool UpdateCurrentText()

Returns:

bool

UpdateTextSource(string, string)

Updates the text source according the current and matching item text.

protected virtual void UpdateTextSource(string text, string matchingItemText)

Parameters:textstring

The current text.

matchingItemTextstring

The matching item text.

UpdateTextSourceStateCache()

Updates the text source state cache.

protected virtual void UpdateTextSourceStateCache()

Events

CurrentTextChanged

EventHandler

Occurs when current text is changed.

public event EventHandler CurrentTextChanged

MatchingItemChanged

EventHandler

Occurs when matching item is changed.

public event EventHandler MatchingItemChanged