Class

RadAutoCompleteBox

Initializes a new instance of the RadAutoCompleteBox class.

Declaration

public RadAutoCompleteBox()

Identifies the AutoCompleteMode dependency property.

Declaration

public static readonly DependencyProperty AutoCompleteModeProperty

Field Value

Identifies the BoxesItemStyle dependency property.

Declaration

public static readonly DependencyProperty BoxesItemStyleProperty

Field Value

Identifies the BoxesItemStyleSelector dependency property.

Declaration

public static readonly DependencyProperty BoxesItemStyleSelectorProperty

Field Value

Identifies the BoxesItemTemplate dependency property.

Declaration

public static readonly DependencyProperty BoxesItemTemplateProperty

Field Value

Identifies the BoxesItemTemplateSelector dependency property.

Declaration

public static readonly DependencyProperty BoxesItemTemplateSelectorProperty

Field Value

Identifies the DisplayMemberPath dependency property.

Declaration

public static readonly DependencyProperty DisplayMemberPathProperty

Field Value

Identifies the DropDownItemTemplate dependency property.

Declaration

public static readonly DependencyProperty DropDownItemTemplateProperty

Field Value

Identifies the DropDownItemTemplateSelector dependency property.

Declaration

public static readonly DependencyProperty DropDownItemTemplateSelectorProperty

Field Value

Identifies the DropDownPlacement dependency property.

Declaration

public static readonly DependencyProperty DropDownPlacementProperty

Field Value

Identifies the DropDownWidth dependency property.

Declaration

public static readonly DependencyProperty DropDownWidthProperty

Field Value

Identifies the MaxDropDownWidthProperty dependency property.

Declaration

public static readonly DependencyProperty FilteredItemsProperty

Field Value

Identifies the FilteringBehavior dependency property.

Declaration

public static readonly DependencyProperty FilteringBehaviorProperty

Field Value

Identifies the HighlightBehavior dependency property.

Declaration

public static readonly DependencyProperty HighlightBehaviorProperty

Field Value

Identifies the IsDropDownOpen dependency property.

Declaration

public static readonly DependencyProperty IsDropDownOpenProperty

Field Value

Identifies the IsHighlighted dependency property.

Declaration

public static readonly DependencyProperty IsHighlightedProperty

Field Value

Identifies the ItemsSource dependency property.

Declaration

public static readonly DependencyProperty ItemsSourceProperty

Field Value

Identifies the MaxDropDownHeight dependency property.

Declaration

public static readonly DependencyProperty MaxDropDownHeightProperty

Field Value

Identifies the MaxDropDownWidthProperty dependency property.

Declaration

public static readonly DependencyProperty MaxDropDownWidthProperty

Field Value

Identifies the MinDropDownWidthProperty dependency property.

Declaration

public static readonly DependencyProperty MinDropDownWidthProperty

Field Value

Identifies the NoResultsContent dependency property.

Declaration

public static readonly DependencyProperty NoResultsContentProperty

Field Value

Identifies the NoResultsContentTemplate dependency property.

Declaration

public static readonly DependencyProperty NoResultsContentTemplateProperty

Field Value

Identifies the MaxDropDownWidthProperty dependency property.

Declaration

public static readonly DependencyProperty SearchTextProperty

Field Value

Identifies the SelectedItem dependency property.

Declaration

public static readonly DependencyProperty SelectedItemProperty

Field Value

Identifies the SelectedItems dependency property.

Declaration

public static readonly DependencyProperty SelectedItemsProperty

Field Value

Occurs when the selection of a RadAutoCompleteBox changes.

Declaration

public static readonly RoutedEvent SelectionChangedEvent

Field Value

Identifies the SelectionMode dependency property.

Declaration

public static readonly DependencyProperty SelectionModeProperty

Field Value

Identifies the TextBoxStyle dependency property.

Declaration

public static readonly DependencyProperty TextBoxStyleProperty

Field Value

Identifies the TextSearchMode dependency property.

Declaration

public static readonly DependencyProperty TextSearchModeProperty

Field Value

Identifies the TextSearchPath dependency property.

Declaration

public static readonly DependencyProperty TextSearchPathProperty

Field Value

Identifies the WatermarkContent dependency property.

Declaration

public static readonly DependencyProperty WatermarkContentProperty

Field Value

Specifies the autocomplete mode for the RadAutoCompleteBox. This is a dependency property.

Declaration

public AutoCompleteMode AutoCompleteMode { get; set; }

Property Value

Gets or sets the System.Windows.Style used to display each item into the boxes part of the control. This is a dependency property.

Declaration

public Style BoxesItemStyle { get; set; }

Property Value

Gets or sets the System.Windows.Controls.StyleSelector used to choose System.Windows.Style to display each item into the boxes part of the control. This is a dependency property.

Declaration

public StyleSelector BoxesItemStyleSelector { get; set; }

Property Value

Gets or sets the System.Windows.DataTemplate used to display each item into the boxes part of the control. This is a dependency property.

Declaration

public DataTemplate BoxesItemTemplate { get; set; }

Property Value

Gets or sets the System.Windows.Controls.DataTemplateSelector used to choose System.Windows.DataTemplate to display each item into the boxes part of the control. This is a dependency property.

Declaration

public DataTemplateSelector BoxesItemTemplateSelector { get; set; }

Property Value

The name or path of the property that is displayed for each the data item in the control. The default is an empty string (""). This is a dependency property.

Declaration

public string DisplayMemberPath { get; set; }

Property Value

Gets or sets the System.Windows.DataTemplate used to display each item into the DropDown part of the control. This is a dependency property.

Declaration

public DataTemplate DropDownItemTemplate { get; set; }

Property Value

Gets or sets the System.Windows.Controls.DataTemplateSelector used to choose System.Windows.DataTemplate to display each DropDown item into the dropdown part of the control. This is a dependency property.

Declaration

public DataTemplateSelector DropDownItemTemplateSelector { get; set; }

Property Value

Gets or sets value indicating where the DropDown part of the control will be placed. This is a dependency property.

Declaration

public AutoCompleteDropDownPlacement DropDownPlacement { get; set; }

Property Value

Gets or sets a GridLength that indicates what the RadAutoCompleteBox' DropDown width will be.

Declaration

public GridLength DropDownWidth { get; set; }

Property Value

Gets the currently filtered items into the RadAutoCompleteBox. This is a dependency property.

Declaration

public IEnumerable FilteredItems { get; }

Property Value

Gets or sets the FilteringBehavior of the RadAutoCompleteBox. This is a dependency property.

Declaration

public IFilteringBehavior FilteringBehavior { get; set; }

Property Value

Gets or sets the HighlightBehavior of the RadAutoCompleteBox. This is a dependency property.

Declaration

public IHighlightBehavior HighlightBehavior { get; set; }

Property Value

Gets or sets the currently highlighted index in the dropdown portion of the control.

Declaration

protected int HighlightedIndex { get; set; }

Property Value

Gets or sets the value that indicates whether the RadAutoCompleteBox dropdown is currently open. This is a dependency property.

Declaration

public bool IsDropDownOpen { get; set; }

Property Value

Gets or sets a value indicating whether this instance is highlighted. This is a dependency property.

Declaration

public bool IsHighlighted { get; set; }

Property Value

Gets or sets a collection that is filtered when the user enters text. This is a dependency property.

Declaration

public IEnumerable ItemsSource { get; set; }

Property Value

Gets or sets the maximum height for a RadAutoCompleteBox drop-down. This is a dependency property.

Declaration

public double MaxDropDownHeight { get; set; }

Property Value

Gets or sets the maximum width of a RadAutoCompleteBox drop-down. This is a dependency property.

Declaration

public double MaxDropDownWidth { get; set; }

Property Value

Gets or sets the minimum width of a RadAutoCompleteBox drop-down. This is a dependency property.

Declaration

public double MinDropDownWidth { get; set; }

Property Value

Gets or sets the content displayed in the dropdown if the filter result is empty.

Declaration

public object NoResultsContent { get; set; }

Property Value

Gets or sets the System.Windows.DataTemplate used to display the content in the dropdown if the filter result is empty.

Declaration

public DataTemplate NoResultsContentTemplate { get; set; }

Property Value

Gets or sets the string that is into the TextBox part of the RadAutoCompleteBox. The SearchText value is used to filter the RadAutoCompleteBox' ItemsSource. This is a dependency property.

Declaration

public string SearchText { get; set; }

Property Value

Gets or sets the first item in the current selection or returns null if the selection is empty. This is a dependency property.

Declaration

public object SelectedItem { get; set; }

Property Value

Gets or sets the list of currently selected items for the RadAutoCompleteBox. This is a dependency property.

Declaration

public IEnumerable SelectedItems { get; set; }

Property Value

Specifies the selection mode for the RadAutoCompleteBox. This is a dependency property.

Declaration

public AutoCompleteSelectionMode SelectionMode { get; set; }

Property Value

Gets or sets the style of the RadWatermarkTextBox into the RadAutoCompleteBox. This is a dependency property.

Declaration

public Style TextBoxStyle { get; set; }

Property Value

Specifies the text search mode for the RadAutoCompleteBox. This is a dependency property.

Declaration

public TextSearchMode TextSearchMode { get; set; }

Property Value

The name or path of the property that is used when filtering for each the data item in the control. The default is an empty string (""). This is a dependency property.

Declaration

public string TextSearchPath { get; set; }

Property Value

Gets or sets the content to be shown when the TextBox is not focused. When in Single SelectionMode, no item should be selected for the content to be visible. This is a dependency property.

Declaration

public object WatermarkContent { get; set; }

Property Value

Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

Declaration

[SuppressMessage("Microsoft.Usage", "CA1816:CallGCSuppressFinalizeCorrectly")]
[SuppressMessage("Microsoft.Usage", "CA2213:DisposableFieldsShouldBeDisposed", MessageId = "popupWrapper")]
[SuppressMessage("Microsoft.Design", "CA1063:ImplementIDisposableCorrectly")]
[Obsolete("The RadAutoCompleteBox control will no longer implement the IDisposable interface and this method will be removed in a future release.")]
public void Dispose()

Implements IDisposable.Dispose()

Updates the visual state of the control.

Declaration

protected void GoToState(bool useTransition)

Parameters

Contains the keyboard navigation logic of RadAutoCompleteBox.

Declaration

protected virtual bool HandleKeyDown(Key systemKey)

Parameters

Returns

When overridden in a derived class, is invoked whenever application code or internal processes (such as a rebuilding layout pass) call .

Declaration

public override void OnApplyTemplate()

Called when the AutoCompleteMode property is changed.

Declaration

protected virtual void OnAutoCompleteModeChanged(AutoCompleteMode newValue)

Parameters

Returns class-specific AutomationPeer implementations for the Windows Presentation Foundation (WPF) infrastructure.

Declaration

protected override AutomationPeer OnCreateAutomationPeer()

Returns

Called when the DisplayMemberPath property is changed.

Declaration

protected virtual void OnDisplayMemberPathChanged()

Called when the FilteringBehavior property is changed.

Declaration

protected virtual void OnFilteringBehaviorChanged()

Called before the System.Windows.UIElement.GotFocus event occurs.

Declaration

protected override void OnGotFocus(RoutedEventArgs e)

Parameters

Called before the System.Windows.UIElement.GotKeyboardFocus event occurs. Here the states of the AutoCompleteBox are updated. Added to work-around an issue with the Got and LostFocus events not getting fired.

Declaration

protected override void OnGotKeyboardFocus(KeyboardFocusChangedEventArgs e)

Parameters

Called when the HighlightBehavior property is changed.

Declaration

protected virtual void OnHighlightBehaviorChanged()

Raises the event. This method is invoked whenever is set to true internally.

Declaration

protected override void OnInitialized(EventArgs e)

Parameters

Called when the IsDropDownOpen property is changed.

Declaration

protected virtual void OnIsDropDownOpenChanged(bool isOpen)

Parameters

Called when the IsHighlighted property is changed.

Declaration

protected virtual void OnIsHighlightedChanged()

Called when the ItemsSource property is changed.

Declaration

protected virtual void OnItemsSourceChanged(object newValue, object oldValue)

Parameters

Called before the System.Windows.UIElement.LostFocus event occurs.

Declaration

protected override void OnLostFocus(RoutedEventArgs e)

Parameters

Called before the event occurs to provide handling for the event in a derived class without attaching a delegate.

Declaration

protected override void OnMouseWheel(MouseWheelEventArgs e)

Parameters

Called when the SelectedItem property is changed.

Declaration

protected virtual void OnSelectedItemChanged(object newValue)

Parameters

Called when the SelectedItems property is changed.

Declaration

protected virtual void OnSelectedItemsChanged(IEnumerable newValue)

Parameters

Called when the selection changes.

Declaration

protected virtual void OnSelectionChanged(SelectionChangedEventArgs e)

Parameters

Called when the SelectionMode property is changed.

Declaration

protected virtual void OnSelectionModeChanged(AutoCompleteSelectionMode newValue)

Parameters

Called when the TextBoxStyle property is changed.

Declaration

protected virtual void OnTextBoxStyleChanged()

Called when the TextSearchMode property is changed.

Declaration

protected virtual void OnTextSearchModeChanged(TextSearchMode textSearchMode)

Parameters

Called when the TextSearchPath property is changed.

Declaration

protected virtual void OnTextSearchPathChanged()

Called when the WatermarkContent property is changed.

Declaration

protected virtual void OnWatermarkContentChanged()

Searches through the AutoCompleteBox Items with the specified string input.

Declaration

public void Populate(string searchText)

Parameters

Occurs when the filtering of the RadAutoCompleteBox is finished and the FilteredItems are populated.

Declaration

public event EventHandler Populated

Event Value

Occurs before the RadAutoCompleteBox' items are filtered using the current SearchText.

Declaration

public event EventHandler<CancelRoutedEventArgs> Populating

Event Value

Occurs when SearchText property changes.

Declaration

public event EventHandler SearchTextChanged

Event Value

Occurs when the selection of the RadAutoCompleteBox changes.

Declaration

public event SelectionChangedEventHandler SelectionChanged

Event Value