skip navigation
  • Product Bundles

    DevCraft

    All Telerik .NET tools and Kendo UI JavaScript components in one package. Now enhanced with:

    • NEW: Design Kits for Figma
    • Online Training
    • Document Processing Library
    • Embedded Reporting for web and desktop
    Web
    Kendo UI UI for jQuery UI for Angular UI for React UI for Vue UI for Blazor UI for ASP.NET Core UI for ASP.NET MVC UI for ASP.NET AJAX UI for Silverlight UI for PHP UI for JSP
    Mobile
    UI for .NET MAUI UI for Xamarin
    Document Management
    Telerik Document Processing
    Desktop
    UI for .NET MAUI UI for WinUI UI for WinForms UI for WPF UI for UWP
    Reporting & Mocking
    Telerik Reporting Telerik Report Server Telerik JustMock
    Automated Testing
    Test Studio Test Studio Dev Edition
    CMS
    Sitefinity
    UI/UX Tools
    ThemeBuilder Design System Kit
    Debugging
    Fiddler Fiddler Everywhere Fiddler Classic Fiddler Jam FiddlerCap FiddlerCore
    Extended Reality
    UI for Unity XR
    Free Tools
    JustAssembly JustDecompile VB.NET to C# Converter Testing Framework
    View all products
  • Overview
  • Demos
    • What's New
    • Release History
  • Docs & Support
  • Pricing
  • Search
  • Shopping cart
    • Account Overview
    • Your Licenses
    • Support Center
    • Forum Profile
    • Payment Methods
    • Edit Profile
    • Log out
  • Login
  • Contact Us
  • Try now

Class Selector

Represents a control that allows a user to select items from among its child elements.

Inheritance
System.Object
ItemsControl
Selector
ListBox
RadComboBox
RadTileView
RadTabControlBase
Inherited Members
ItemsControl.ItemContainerStyleProperty
ItemsControl.IsTextSearchEnabledProperty
ItemsControl.ItemContainerStyleSelectorProperty
ItemsControl.ItemTemplateSelectorProperty
ItemsControl.IsFocusedProperty
ItemsControl.HasItemsProperty
ItemsControl.ItemsControlFromItemContainer(DependencyObject)
ItemsControl.OnApplyTemplate()
ItemsControl.ChangeVisualState()
ItemsControl.ChangeVisualState(Boolean)
ItemsControl.OnIsEnabledChanged(DependencyPropertyChangedEventArgs)
ItemsControl.OnGotFocus(RoutedEventArgs)
ItemsControl.OnLostFocus(RoutedEventArgs)
ItemsControl.OnItemTemplateSelectorChanged(DataTemplateSelector, DataTemplateSelector)
ItemsControl.PrepareContainerForItemOverride(DependencyObject, Object)
ItemsControl.OnIsFocusedChanged(DependencyPropertyChangedEventArgs)
ItemsControl.IsTextSearchEnabled
ItemsControl.HasItems
ItemsControl.IsFocused
ItemsControl.ItemContainerStyle
ItemsControl.ItemContainerStyleSelector
ItemsControl.ItemTemplateSelector
ItemsControl.OverrideStyles
ItemsControl.ItemContainerGenerator
Namespace: Telerik.Windows.Controls
Assembly: Telerik.Windows.Controls.dll

Syntax

public abstract class Selector : ItemsControl

Fields

IsSelectedProperty

Identifies the IsSelected attached property.

Declaration
public static readonly DependencyProperty IsSelectedProperty
Field Value
System.Windows.DependencyProperty

SelectedEvent

Identifies the Selected routed event.

Declaration
public static readonly RoutedEvent SelectedEvent
Field Value
RoutedEvent

SelectedIndexProperty

Identifies the SelectedIndex dependency property.

Declaration
public static readonly DependencyProperty SelectedIndexProperty
Field Value
System.Windows.DependencyProperty

SelectedItemProperty

Identifies the SelectedItem dependency property.

Declaration
public static readonly DependencyProperty SelectedItemProperty
Field Value
System.Windows.DependencyProperty

SelectedValuePathProperty

Identifies the SelectedValuePath dependency property.

Declaration
public static readonly DependencyProperty SelectedValuePathProperty
Field Value
System.Windows.DependencyProperty

SelectedValueProperty

Identifies the SelectedValue dependency property.

Declaration
public static readonly DependencyProperty SelectedValueProperty
Field Value
System.Windows.DependencyProperty

SelectionChangedEvent

Identifies the SelectionChanged routed event.

Declaration
public static readonly RoutedEvent SelectionChangedEvent
Field Value
RoutedEvent

UnselectedEvent

Identifies the Unselected routed event.

Declaration
public static readonly RoutedEvent UnselectedEvent
Field Value
RoutedEvent

Properties

SelectedIndex

Gets or sets the index of the first item in the current selection or returns negative one (-1) if the selection is empty. This is a dependency property.

Declaration
[SRCategory("Appearance")]
public int SelectedIndex { get; set; }
Property Value
System.Int32

SelectedItem

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

Declaration
[SRCategory("Appearance")]
public object SelectedItem { get; set; }
Property Value
System.Object

SelectedValue

Gets or sets ... This is a dependency property.

Declaration
public object SelectedValue { get; set; }
Property Value
System.Object

SelectedValuePath

Gets or sets ... This is a dependency property.

Declaration
public string SelectedValuePath { get; set; }
Property Value
System.String

Methods

add_SelectionChanged(SelectionChangedEventHandler)

Declaration
public void add_SelectionChanged(SelectionChangedEventHandler value)
Parameters
SelectionChangedEventHandler value

AddSelectedHandler(DependencyObject, RoutedEventHandler)

Adds a handler for the Selected attached event.

Declaration
public static void AddSelectedHandler(DependencyObject element, RoutedEventHandler handler)
Parameters
System.Windows.DependencyObject element

Element that listens to this event.

System.Windows.RoutedEventHandler handler

Event handler to add.

AddUnselectedHandler(DependencyObject, RoutedEventHandler)

Adds a handler for the Unselected attached event.

Declaration
public static void AddUnselectedHandler(DependencyObject element, RoutedEventHandler handler)
Parameters
System.Windows.DependencyObject element

Element that listens to this event.

System.Windows.RoutedEventHandler handler

Event handler to add.

GetIsSelected(DependencyObject)

Gets the value of the IsSelected attached property that indicates whether an item is selected.

Declaration
public static bool GetIsSelected(DependencyObject element)
Parameters
System.Windows.DependencyObject element

Object to query concerning the IsSelected property.

Returns
System.Boolean

Boolean value, true if the IsSelected property is true.

OnItemsChanged(NotifyCollectionChangedEventArgs)

Invoked when the System.Windows.Controls.ItemsControl.Items property changes.

Declaration
protected override void OnItemsChanged(NotifyCollectionChangedEventArgs e)
Parameters
System.Collections.Specialized.NotifyCollectionChangedEventArgs e

Information about the change.

Overrides
ItemsControl.OnItemsChanged(NotifyCollectionChangedEventArgs)

OnSelectedValueChanged(Object, Object)

Called when the SelectedValue property is changed.

Declaration
protected virtual void OnSelectedValueChanged(object oldValue, object newValue)
Parameters
System.Object oldValue

The old value of the SelectedValue property.

System.Object newValue

The new value of the SelectedValue property.

OnSelectedValuePathChanged(String, String)

Called when the SelectedValuePath property is changed.

Declaration
protected virtual void OnSelectedValuePathChanged(string oldValue, string newValue)
Parameters
System.String oldValue

The old value of the SelectedValuePath property.

System.String newValue

The new value of the SelectedValuePath property.

OnSelectionChanged(SelectionChangedEventArgs)

Called when the selection changes.

Declaration
protected virtual void OnSelectionChanged(SelectionChangedEventArgs e)
Parameters
System.Windows.Controls.SelectionChangedEventArgs e

The event data.

remove_SelectionChanged(SelectionChangedEventHandler)

Declaration
public void remove_SelectionChanged(SelectionChangedEventHandler value)
Parameters
SelectionChangedEventHandler value

RemoveSelectedHandler(DependencyObject, RoutedEventHandler)

Removes a handler for the Selected attached event.

Declaration
public static void RemoveSelectedHandler(DependencyObject element, RoutedEventHandler handler)
Parameters
System.Windows.DependencyObject element

Element that listens to this event.

System.Windows.RoutedEventHandler handler

Event handler to remove.

RemoveUnselectedHandler(DependencyObject, RoutedEventHandler)

Removes a handler for the Unselected attached event.

Declaration
public static void RemoveUnselectedHandler(DependencyObject element, RoutedEventHandler handler)
Parameters
System.Windows.DependencyObject element

Element that listens to this event.

System.Windows.RoutedEventHandler handler

Event handler to remove.

SetIsSelected(DependencyObject, Boolean)

Sets a property value that indicates whether an item in a Selector is selected.

Declaration
public static void SetIsSelected(DependencyObject element, bool isSelected)
Parameters
System.Windows.DependencyObject element

Object on which to set the property.

System.Boolean isSelected

Value to set.

Events

SelectionChanged

Occurs when the selection of a Selector changes.

Declaration
[SRCategory("Behavior")]
public event SelectionChangedEventHandler SelectionChanged
Event Type
SelectionChangedEventHandler

Extension Methods

CollectionExtensions.ToEnumerable<T>(T)
EnumerableExtensions.ToEnumerable<T>(T)

Was this article helpful?

Tell us how we can improve this article

Skip
Getting Started
  • Install Now
  • Demos
  • SDK Samples Browser
  • Sample Applications
Support Resources
  • Code Library
  • Knowledge Base
  • MVVM Support
  • Videos
  • GitHub SDK Repository
Community
  • Forums
  • Blogs
  • XAML Feedback Portal
  • Document Processing Feedback Portal

Copyright © 2018 Progress Software Corporation and/or its subsidiaries or affiliates.
All Rights Reserved.

Progress, Telerik, and certain product names used herein are trademarks or registered trademarks of Progress Software Corporation and/or one of its subsidiaries or affiliates in the U.S. and/or other countries. See Trademarks for appropriate markings.