IXRSelector (Windows Embedded CE 6.0)

1/6/2010

This class represents a control that allows a user to select an item from a collection of items.

Syntax

class IXRSelector : public IXRItemsControl

Methods

Method Description

IXRSelector::AddSelectionChangedHandler

Attaches a delegate to the SelectionChanged event for this selector object. When the SelectionChanged event is raised by this selector object, this delegate will be invoked.

IXRSelector::GetSelectedIndex

Retrieves the index of the selected item in the list.

IXRSelector::GetSelectedItem

Retrieves the selected item in the list.

IXRSelector::RemoveSelectionChangedHandler

Removes a delegate from the SelectionChanged event for this selector object.

IXRSelector::SetSelectedIndex

Sets the index of the selected item in the list.

IXRSelector::SetSelectedItem

Sets the selected item in the list.

Remarks

IXRSelector is an intermediate base class for both the IXRComboBox control and the IXRListBox control. It enables the combo box or list box to handle information about item selections. An item can be selected because of user interaction, or because a related property value changed. You can attach a delegate to the selector object that can handle the event that is raised when the selected item changes. To do this, call IXRTextBox::AddSelectionChangedEventHandler.

IXRSelector is an items control and inherits from IXRItemsControl. You can retrieve its content as an item collection, by calling its inherited method IXRItemsControl::GetItems. The IXRItemCollection collection object that is retrieved from GetItems stores the selectable items that are displayed in the list.

Inheritance Hierarchy

IXRDependencyObject

    IXRUIElement

        IXRFrameworkElement

            IXRControl

                IXRItemsControl

                    IXRSelector

                        IXRComboBox

                        IXRListBox

.NET Framework Equivalent

System.Windows.Controls.Primitives.Selector

Requirements

Header XamlRuntime.h
sysgen SYSGEN_XAML_RUNTIME
Windows Embedded CE Windows Embedded CE 6.0 R3

See Also

Reference

Classes for UI Element Management