Selector.SelectionChanged Event (System.Windows.Controls.Primitives)

Switch View

SelectionChanged Event

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

Selector..::.SelectionChanged Event

Occurs when the selection of a Selector changes.

Namespace: System.Windows.Controls.Primitives
Assembly: PresentationFramework (in PresentationFramework.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

Syntax

Visual Basic (Declaration)

Public Event SelectionChanged As SelectionChangedEventHandler

Visual Basic (Usage)

Dim instance As Selector
Dim handler As SelectionChangedEventHandler

AddHandler instance.SelectionChanged, handler

public event SelectionChangedEventHandler SelectionChanged

Visual C++

public:
 event SelectionChangedEventHandler^ SelectionChanged {
    void add (SelectionChangedEventHandler^ value);
    void remove (SelectionChangedEventHandler^ value);
}

JScript

JScript does not support events.

XAML Attribute Usage

<object SelectionChanged="SelectionChangedEventHandler" .../>

Routed Event Information

Identifier field	SelectionChangedEvent
Routing strategy	Bubbling
Delegate	SelectionChangedEventHandler

Remarks

This event occurs whenever there is a change to a selection. A selection can be changed not only by user interaction but also by binding as well as other set values.

Examples

The following example shows how to attach the SelectionChanged event to a list box control.

XAML

<TextBox Name="tb" Width="140" Height="30"></TextBox>
<ListBox Name="lb" Width="100" Height="55" SelectionChanged="PrintText" SelectionMode="Single">
  <ListBoxItem>Item 1</ListBoxItem>
  <ListBoxItem>Item 2</ListBoxItem>
  <ListBoxItem>Item 3</ListBoxItem>
  <ListBoxItem>Item 4</ListBoxItem>
  <ListBoxItem>Item 5</ListBoxItem>
  <ListBoxItem>Item 6</ListBoxItem>
  <ListBoxItem>Item 7</ListBoxItem>
  <ListBoxItem>Item 8</ListBoxItem>
  <ListBoxItem>Item 9</ListBoxItem>
  <ListBoxItem>Item 10</ListBoxItem>
</ListBox>

The following example shows how to handle the SelectionChanged event.

Visual Basic

Private Sub PrintText(ByVal sender As Object, ByVal e As SelectionChangedEventArgs)

    Dim lbsender As ListBox
    Dim li As ListBoxItem

    lbsender = CType(sender, ListBox)
    li = CType(lbsender.SelectedItem, ListBoxItem)
    tb.Text = "   You selected " & li.Content.ToString & "."
End Sub

void PrintText(object sender, SelectionChangedEventArgs args)
{
    ListBoxItem lbi = ((sender as ListBox).SelectedItem as ListBoxItem);
    tb.Text = "   You selected " + lbi.Content.ToString() + ".";
}

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0

Reference

Selector Class

Selector Members

System.Windows.Controls.Primitives Namespace

Other Resources

Controls Overview

Control Library