ClassItemsControlSelector
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:
[SuppressMessage("Design", "CA1001:Types that own disposable fields should be disposable", Justification = "<Pending>")]
public class ItemsControlSelector : ItemsControl, IMultiSelector, ISelector, ISelectorInteraction, IAutocompleteInheritance: objectItemsControlSelector
Derived Classes:
Implements:
Constructors
ItemsControlSelector()
Initializes a new instance of the ItemsControlSelector class.
Declaration
[SuppressMessage("Microsoft.Usage", "CA2214:DoNotCallOverridableMethodsInConstructors")]
public ItemsControlSelector()Fields
EnableSelectionCachingProperty
Identifies the EnableSelectionCaching dependency property.
Declaration
public static readonly DependencyProperty EnableSelectionCachingPropertyField Value
DependencyProperty
IsSynchronizedWithCurrentItemProperty
Identifies the IsSynchronizedWithCurrentItem dependency property.
Declaration
public static readonly DependencyProperty IsSynchronizedWithCurrentItemPropertyField Value
DependencyProperty
SelectedIndexProperty
Identifies the SelectedIndex dependency property.
Declaration
public static readonly DependencyProperty SelectedIndexPropertyField Value
DependencyProperty
SelectedItemProperty
Identifies the SelectedItem dependency property.
Declaration
public static readonly DependencyProperty SelectedItemPropertyField Value
DependencyProperty
SelectedValuePathProperty
Identifies the SelectedValuePath dependency property.
Declaration
public static readonly DependencyProperty SelectedValuePathPropertyField Value
DependencyProperty
SelectedValueProperty
Identifies the SelectedValue dependency property.
Declaration
public static readonly DependencyProperty SelectedValuePropertyField Value
DependencyProperty
SelectionChangedEvent
Identifies the SelectionChanged routed event.
Declaration
public static readonly RoutedEvent SelectionChangedEventField Value
RoutedEvent
SelectionModeProperty
Identifies the SelectionMode dependency property.
Declaration
public static readonly DependencyProperty SelectionModePropertyField Value
DependencyProperty
TextPathProperty
Identifies the TextPath dependency property.
Declaration
public static readonly DependencyProperty TextPathPropertyField Value
DependencyProperty
TextProperty
Identifies the Text dependency property.
Declaration
public static readonly DependencyProperty TextPropertyField Value
DependencyProperty
Properties
EnableSelectionCaching
Gets or sets the EnableSelectionCaching. This is a dependency property.
IsSynchronizedWithCurrentItem
Gets or sets the IsSynchronizedWithCurrentItem. This is a dependency property.
Declaration
public bool IsSynchronizedWithCurrentItem { get; set; }Property Value
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.
SelectedItem
Gets the item which is currently selected.
Declaration
public object SelectedItem { get; set; }Property Value
Implements
SelectedItems
Gets a collection of selected items.
SelectedValue
Gets the value for the selected item.
Declaration
public object SelectedValue { get; set; }Property Value
Implements
SelectedValueBinding
Gets or sets the SelectedValueBinding.
Declaration
public Binding SelectedValueBinding { get; set; }Property Value
Binding
SelectedValuePath
Gets or sets the selected value path.
Declaration
public string SelectedValuePath { get; set; }Property Value
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
SelectionMode
Text
Gets or sets the Text. This is a dependency property.
TextBinding
Gets or sets the TextBinding.
Declaration
public Binding TextBinding { get; set; }Property Value
Binding
TextPath
Gets or sets the TextPath. This is a dependency property.
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
Returns true if the panel is not null or Grid, otherwise returns false.
ChangeVisualState(bool)
Updates the visual state of the control.
Declaration
protected virtual void ChangeVisualState(bool useTransitions)Parameters
useTransitions
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
container
UIElement
The container.
Returns
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(int)
Determines whether the index is selectable.
IsItemSelectable(object)
Determines whether an item is selectable or not.
OnApplyTemplate()
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()OnIsEnabledChanged(DependencyPropertyChangedEventArgs)
Invoked when the IsEnabled property of the control changes.
Declaration
protected virtual void OnIsEnabledChanged(DependencyPropertyChangedEventArgs e)Parameters
e
DependencyPropertyChangedEventArgs
The information about the new and old value of the property.
OnItemsChanged(NotifyCollectionChangedEventArgs)
Raises the event.
Declaration
protected override void OnItemsChanged(NotifyCollectionChangedEventArgs e)Parameters
e
NotifyCollectionChangedEventArgs
The NotifyCollectionChangedEventArgs instance containing the event data.
OnItemsSourceChanged(IEnumerable, IEnumerable)
Called when the SelectorControl.ItemsSource" property changes.
Declaration
protected override void OnItemsSourceChanged(IEnumerable oldValue, IEnumerable newValue)Parameters
oldValue
Old value of the SelectorControl.ItemsSource" property.
newValue
New value of the SelectorControl.ItemsSource" property.
OnSelectionChanged(SelectionChangedEventArgs)
Called when the selection changes.
Declaration
protected virtual void OnSelectionChanged(SelectionChangedEventArgs e)Parameters
e
SelectionChangedEventArgs
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
action
The action.
newItems
The new items.
oldItems
The old items.
Events
SelectionChanged
Occurs when the selection of a Selector changes.
Declaration
public event SelectionChangedEventHandler SelectionChangedEvent Value
SelectionChangedEventHandler
Implements