Class ItemsControlSelector
Represents a control that allows a user to select items from among its child elements.
Inheritance
Namespace: Telerik.Windows.Controls.Primitives
Assembly: Telerik.Windows.Controls.dll
Syntax
public class ItemsControlSelector : ItemsControl, IMultiSelector, ISelector, ISelectorInteraction, IAutocompleteConstructors
ItemsControlSelector()
Initializes a new instance of the Items
Declaration
public ItemsControlSelector()Fields
EnableSelectionCachingProperty
Identifies the EnableSelectionCaching dependency property.
Declaration
public static readonly DependencyProperty EnableSelectionCachingPropertyField Value
|
System.
|
IsSynchronizedWithCurrentItemProperty
Identifies the IsSynchronizedWithCurrentItem dependency property.
Declaration
public static readonly DependencyProperty IsSynchronizedWithCurrentItemPropertyField Value
|
System.
|
SelectedIndexProperty
Identifies the SelectedIndex dependency property.
Declaration
public static readonly DependencyProperty SelectedIndexPropertyField Value
|
System.
|
SelectedItemProperty
Identifies the SelectedItem dependency property.
Declaration
public static readonly DependencyProperty SelectedItemPropertyField Value
|
System.
|
SelectedValuePathProperty
Identifies the SelectedValuePath dependency property.
Declaration
public static readonly DependencyProperty SelectedValuePathPropertyField Value
|
System.
|
SelectedValueProperty
Identifies the SelectedValue dependency property.
Declaration
public static readonly DependencyProperty SelectedValuePropertyField Value
|
System.
|
SelectionChangedEvent
Identifies the SelectionChanged routed event.
Declaration
public static readonly RoutedEvent SelectionChangedEventField Value
|
System.
|
SelectionModeProperty
Identifies the SelectionMode dependency property.
Declaration
public static readonly DependencyProperty SelectionModePropertyField Value
|
System.
|
TextPathProperty
Identifies the TextPath dependency property.
Declaration
public static readonly DependencyProperty TextPathPropertyField Value
|
System.
|
TextProperty
Identifies the Text dependency property.
Declaration
public static readonly DependencyProperty TextPropertyField Value
|
System.
|
Properties
EnableSelectionCaching
Gets or sets the EnableSelectionCaching. This is a dependency property.
Declaration
public bool EnableSelectionCaching { get; set; }Property Value
|
System.
|
IsSynchronizedWithCurrentItem
Gets or sets the IsSynchronizedWithCurrentItem. This is a dependency property.
Declaration
public bool IsSynchronizedWithCurrentItem { get; set; }Property Value
|
System.
|
ItemSearch
Gets the ItemSearch which defines the logic how the items are found via the retrievers.
Declaration
public IItemSearchControl ItemSearch { get; }Property Value
Implements
SelectedIndex
Gets or sets the SelectedIndex. This is a dependency property.
Declaration
public int SelectedIndex { get; set; }Property Value
|
System.
|
Implements
SelectedItem
Gets the item which is currently selected.
Declaration
public object SelectedItem { get; set; }Property Value
|
System.
|
Implements
SelectedItems
Gets a collection of selected items.
Declaration
public IList SelectedItems { get; }Property Value
|
System.
|
Implements
SelectedValue
Gets the value for the selected item.
Declaration
public object SelectedValue { get; set; }Property Value
|
System.
|
Implements
SelectedValueBinding
Gets or sets the SelectedValueBinding.
Declaration
public Binding SelectedValueBinding { get; set; }Property Value
|
System.
|
SelectedValuePath
Gets or sets the selected value path.
Declaration
public string SelectedValuePath { get; set; }Property Value
|
System. The selected value path. |
SelectionHelper
The selection helper used in all ItemsControlSelectors. It coordinates the selection using the selection behaviors.
Declaration
public SelectionHelper SelectionHelper { get; }Property Value
SelectionMode
Gets or sets the SelectionMode. This is a dependency property.
Declaration
public SelectionMode SelectionMode { get; set; }Property Value
|
System.
|
Text
Gets or sets the Text. This is a dependency property.
Declaration
public string Text { get; set; }Property Value
|
System.
|
Implements
TextBinding
Gets or sets the TextBinding.
Declaration
public Binding TextBinding { get; set; }Property Value
|
System.
|
TextPath
Gets or sets the TextPath. This is a dependency property.
Declaration
public string TextPath { get; set; }Property Value
|
System.
|
TextRetriever
Gets the text Retriever that is used for item search.
Declaration
public IValueRetriever TextRetriever { get; }Property Value
Implements
ValueRetriever
Gets the value Retriever that is used for item search.
Declaration
public IValueRetriever ValueRetriever { get; }Property Value
Implements
Methods
CanPerformSelection()
Indicates whether the selection helper can perform operation or not.
Declaration
protected virtual bool CanPerformSelection()Returns
|
System. Returns true if the panel is not null or Grid, otherwise returns false. |
ChangeVisualState(Boolean)
Updates the visual state of the control.
Declaration
protected virtual void ChangeVisualState(bool useTransitions)Parameters
|
System. Indicates whether transitions should be used. |
EndInit()
Called when the control is Initialized.
Declaration
public override void EndInit()GetDataItem(UIElement)
Gets the data item according to its container.
Declaration
public virtual object GetDataItem(UIElement container)Parameters
|
System. The container. |
Returns
|
System.
|
Implements
GetSelectionBehavior()
Gets the selection behavior.
Declaration
protected virtual ISelectionBehavior GetSelectionBehavior()Returns
InitializeSelectionBehavior()
Initializes the selection behavior.
Declaration
protected void InitializeSelectionBehavior()InitializeTextRetriever()
Initializes the text Retriever.
Declaration
protected virtual void InitializeTextRetriever()InitializeValueRetriever()
Initializes the value Retriever.
Declaration
protected virtual void InitializeValueRetriever()IsIndexSelectable(Int32)
Determines whether the index is selectable.
Declaration
protected virtual bool IsIndexSelectable(int index)Parameters
|
System. The index. |
Returns
|
System.
|
IsItemSelectable(Object)
Determines whether an item is selectable or not.
Declaration
protected virtual bool IsItemSelectable(object item)Parameters
|
System. The item. |
Returns
|
System.
|
OnApplyTemplate()
When overridden in a derived class, is invoked whenever application
code or internal processes (such as a rebuilding layout pass) call
System.
Declaration
public override void OnApplyTemplate()OnIsEnabledChanged(DependencyPropertyChangedEventArgs)
Invoked when the IsEnabled property of the control changes.
Declaration
protected virtual void OnIsEnabledChanged(DependencyPropertyChangedEventArgs e)Parameters
|
System. The information about the new and old value of the property. |
OnItemsChanged(NotifyCollectionChangedEventArgs)
Raises the Items
Declaration
protected override void OnItemsChanged(NotifyCollectionChangedEventArgs e)Parameters
|
System. The System. |
OnItemsSourceChanged(IEnumerable, IEnumerable)
Called when the SelectorControl.ItemsSource" property changes.
Declaration
protected override void OnItemsSourceChanged(IEnumerable oldValue, IEnumerable newValue)Parameters
|
System. Old value of the SelectorControl.ItemsSource" property. |
|
System. New value of the SelectorControl.ItemsSource" property. |
OnSelectionChanged(SelectionChangedEventArgs)
Called when the selection changes.
Declaration
protected virtual void OnSelectionChanged(SelectionChangedEventArgs e)Parameters
|
System. The event data. |
OnSelectionModeChanged()
Called when selection mode changed.
Declaration
protected virtual void OnSelectionModeChanged()UpdateItems(NotifyCollectionChangedAction, IList, IList)
Updates the items when ItemsChanged occurs.
Declaration
protected virtual void UpdateItems(NotifyCollectionChangedAction action, IList newItems, IList oldItems)Parameters
|
System. The action. |
|
System. The new items. |
|
System. The old items. |
Events
SelectionChanged
Occurs when the selection of a Selector changes.
Declaration
public event SelectionChangedEventHandler SelectionChangedEvent Type
|
System.
|
Implements
Explicit Interface Implementations
ISelectorInteraction.GetItems()
Declaration
IEnumerable ISelectorInteraction.GetItems()Returns
|
System.
|
Implements
ISelectorInteraction.IsDefaultCollectionView
Declaration
bool ISelectorInteraction.IsDefaultCollectionView { get; }Returns
|
System.
|
Implements
ISelectorInteraction.IsItemSelectable(Object)
Declaration
bool ISelectorInteraction.IsItemSelectable(object item)Parameters
|
System.
|
Returns
|
System.
|
Implements
ISelectorInteraction.MoveCurrentItemInCollectionView(Object)
Declaration
void ISelectorInteraction.MoveCurrentItemInCollectionView(object item)Parameters
|
System.
|