Represents a auto-complete tokenized text box element
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class RadAutoCompleteBoxElement : RadTextBoxControlElement, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IPrimitiveElement, IShapedElement, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IDrawFillElement, IImageElement, ITextPrimitive, ITextProvider
Inheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemUIItemBaseLightVisualElementScrollViewElement<TextBoxViewElement>RadTextBoxControlElementRadAutoCompleteBoxElement...
Derived Classes:
Implements:
Inherited Members
Constructors
Initializes a new instance of the RadAutoCompleteBoxElement class.
public RadAutoCompleteBoxElement()
Properties
Gets or sets whether already selected items can be suggested.
public virtual bool AllowDuplicates { get; set; }
Gets or sets the auto complete drop down location.
protected Point AutoCompleteDropDownLocation { get; set; }
The auto complete popup location.
Gets or sets a property name which will be used to extract a value from the data items
public string AutoCompleteValueMember { get; set; }
Gets the auto complete view element.
protected AutoCompleteBoxViewElement AutoCompleteViewElement { get; }
Gets a value indicating whether this text box can perform auto complete operation.
protected override bool CanPerformAutoComplete { get; }
true if auto-completion is enabled and the text box is single-line; otherwise, false.
Overrides:
Gets or sets the delimiter used to tokenize the text
public char Delimiter { get; set; }
The delimiter.
Gets the tokenized items.
public RadTokenizedTextItemCollection Items { get; }
Gets or sets a value indicating whether the remove button of TokenizedTextBlockElement should appear. Notice that the text box should not be in read only mode
public bool ShowRemoveButton { get; set; }
true if [show remove button]; otherwise, false.
Methods
Closes the drop down.
public override void CloseDropDown(RadPopupCloseReason reason)
The reason for closing the dropdown.
Overrides:
Creates the child elements that comprise the text box control, including the view element, scrollbars, caret, and supporting components.
protected override void CreateChildElements()
Overrides:
Creates the auto-complete list element.
protected override RadTextBoxListElement CreateListElement()
A new instance of RadTextBoxListElement for displaying auto-completion suggestions.
Overrides:
Creates the tokenized item collection.
protected virtual RadTokenizedTextItemCollection CreateTokenizedItemCollection()
Creates the view element.
Gets the auto-complete drop down location.
protected override Point GetAutoCompleteDropDownLocation()
The screen coordinates where the auto-complete dropdown should be positioned.
Overrides:
Gets the first position for auto-completion text within the view element.
protected override TextPosition GetFirstAutoCompletePosition()
The text position representing the start of auto-completion.
Overrides:
Gets the last position for auto-completion text within the view element.
protected override TextPosition GetLastAutoCompletePosition()
The text position representing the end of auto-completion.
Overrides:
protected virtual void HideDuplicates()
Initializes the default field values for the text box control element.
protected override void InitializeFields()
Overrides:
Determines whether the current position is valid for the auto-complete operation
protected override bool IsValidAutoCompletePosition()
true if [is valid auto complete position]; otherwise, false.
Overrides:
Called when the auto-complete dropdown is closed.
protected override void OnAutoCompleteDropDownClosed(RadAutoCompleteDropDownClosedEventArgs e)
The auto-complete dropdown closed event arguments.
Overrides:
Performs the auto complete override.
protected override void PerformAutoCompleteOverride(EditOperation context)
The context.
Overrides:
Events
Occurs when text is validating as token
public event TokenValidatingEventHandler TokenValidating