ItemsControlSelector
Represents a control that allows a user to select items from among its child elements.
Definition
Namespace:Telerik.Windows.Controls.Primitives
Assembly:Telerik.Windows.Controls.dll
Syntax:
public class ItemsControlSelector : ItemsControl, IMultiSelector, ISelector, ISelectorInteraction, IAutocompleteInheritance: objectItemsControlSelector
Derived Classes:
Implements:
Constructors
Initializes a new instance of the ItemsControlSelector class.
public ItemsControlSelector()Fields
EnableSelectionCachingProperty
DependencyProperty
Identifies the EnableSelectionCaching dependency property.
public static readonly DependencyProperty EnableSelectionCachingPropertyIsSynchronizedWithCurrentItemProperty
DependencyProperty
Identifies the IsSynchronizedWithCurrentItem dependency property.
public static readonly DependencyProperty IsSynchronizedWithCurrentItemPropertySelectedIndexProperty
DependencyProperty
Identifies the SelectedIndex dependency property.
public static readonly DependencyProperty SelectedIndexPropertySelectedItemProperty
DependencyProperty
Identifies the SelectedItem dependency property.
public static readonly DependencyProperty SelectedItemPropertySelectedValuePathProperty
DependencyProperty
Identifies the SelectedValuePath dependency property.
public static readonly DependencyProperty SelectedValuePathPropertySelectedValueProperty
DependencyProperty
Identifies the SelectedValue dependency property.
public static readonly DependencyProperty SelectedValuePropertySelectionChangedEvent
RoutedEvent
Identifies the SelectionChanged routed event.
public static readonly RoutedEvent SelectionChangedEventSelectionModeProperty
DependencyProperty
Identifies the SelectionMode dependency property.
public static readonly DependencyProperty SelectionModePropertyTextPathProperty
DependencyProperty
Identifies the TextPath dependency property.
public static readonly DependencyProperty TextPathPropertyTextProperty
DependencyProperty
Identifies the Text dependency property.
public static readonly DependencyProperty TextPropertyProperties
Gets or sets the EnableSelectionCaching. This is a dependency property.
public bool EnableSelectionCaching { get; set; }Gets or sets the IsSynchronizedWithCurrentItem. This is a dependency property.
public bool IsSynchronizedWithCurrentItem { get; set; }Gets the ItemSearch which defines the logic how the items are found via the retrievers.
public IItemSearchControl ItemSearch { get; }Implements:
Gets or sets the SelectedIndex. This is a dependency property.
public int SelectedIndex { get; set; }Implements:
Gets the item which is currently selected.
public object SelectedItem { get; set; }Implements:
Gets a collection of selected items.
public IList SelectedItems { get; }Implements:
Gets the value for the selected item.
public object SelectedValue { get; set; }Implements:
SelectedValueBinding
Binding
Gets or sets the SelectedValueBinding.
public Binding SelectedValueBinding { get; set; }Gets or sets the selected value path.
public string SelectedValuePath { get; set; }The selected value path.
The selection helper used in all ItemsControlSelectors. It coordinates the selection using the selection behaviors.
public SelectionHelper SelectionHelper { get; }SelectionMode
SelectionMode
Gets or sets the SelectionMode. This is a dependency property.
public SelectionMode SelectionMode { get; set; }Gets or sets the Text. This is a dependency property.
public string Text { get; set; }Implements:
TextBinding
Binding
Gets or sets the TextBinding.
public Binding TextBinding { get; set; }Gets or sets the TextPath. This is a dependency property.
public string TextPath { get; set; }Gets the text Retriever that is used for item search.
public IValueRetriever TextRetriever { get; }Implements:
Gets the value Retriever that is used for item search.
public IValueRetriever ValueRetriever { get; }Implements:
Methods
Indicates whether the selection helper can perform operation or not.
protected virtual bool CanPerformSelection()Returns true if the panel is not null or Grid, otherwise returns false.
Updates the visual state of the control.
protected virtual void ChangeVisualState(bool useTransitions)Indicates whether transitions should be used.
Called when the control is Initialized.
public override void EndInit()Gets the data item according to its container.
public virtual object GetDataItem(UIElement container)The container.
Returns:Implements:
Gets the selection behavior.
Initializes the selection behavior.
protected void InitializeSelectionBehavior()Initializes the text Retriever.
protected virtual void InitializeTextRetriever()Initializes the value Retriever.
protected virtual void InitializeValueRetriever()When overridden in a derived class, is invoked whenever application code or internal processes (such as a rebuilding layout pass) call .
public override void OnApplyTemplate()Invoked when the IsEnabled property of the control changes.
protected virtual void OnIsEnabledChanged(DependencyPropertyChangedEventArgs e)The information about the new and old value of the property.
Raises the event.
protected override void OnItemsChanged(NotifyCollectionChangedEventArgs e)The NotifyCollectionChangedEventArgs instance containing the event data.
Called when the SelectorControl.ItemsSource" property changes.
protected override void OnItemsSourceChanged(IEnumerable oldValue, IEnumerable newValue)Old value of the SelectorControl.ItemsSource" property.
newValueIEnumerableNew value of the SelectorControl.ItemsSource" property.
Called when the selection changes.
protected virtual void OnSelectionChanged(SelectionChangedEventArgs e)The event data.
Called when selection mode changed.
protected virtual void OnSelectionModeChanged()Updates the items when ItemsChanged occurs.
protected virtual void UpdateItems(NotifyCollectionChangedAction action, IList newItems, IList oldItems)The action.
newItemsIListThe new items.
oldItemsIListThe old items.
Events
SelectionChanged
SelectionChangedEventHandler
Occurs when the selection of a Selector changes.
public event SelectionChangedEventHandler SelectionChangedImplements: