DXTabControl.SelectionChanged Event

Occurs after a tab item has been selected.

Namespace: DevExpress.Xpf.Core

Assembly: DevExpress.Xpf.Core.v24.2.dll

NuGet Package: DevExpress.Wpf.Core

Declaration

C#

public event TabControlSelectionChangedEventHandler SelectionChanged

VB.NET

Public Event SelectionChanged As TabControlSelectionChangedEventHandler

Event Data

The SelectionChanged event's data class is TabControlSelectionChangedEventArgs. The following properties provide information specific to this event:

Property	Description
NewSelectedIndex	Gets the index of the currently selected tab item.
NewSelectedItem	Gets a data item that corresponds to the currently selected tab item.
OldSelectedIndex	Gets the index of the previously selected tab item.
OldSelectedItem	Gets a data item that corresponds to the previously selected tab item.

Remarks

The SelectionChanged event occurs after a tab item has been selected. The selected tab item is returned by the DXTabControl.SelectedItem property. The index of the previously selected item is returned by the event parameter’s TabControlSelectionChangedEventArgs.OldSelectedIndex property.

To prevent individual tab items from being selected, handle the DXTabControl.SelectionChanging event.

To learn more, see Header Menu.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the SelectionChanged event.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

XAML

wpf-spreadsheet-chart-api/CS/SpreadsheetWPFChartAPISamples/MainWindow.xaml#L29

<dx:DXTabControl x:Name="tabControl" Grid.Row="1" Grid.Column="0" SelectionChanged="tabControl_SelectionChanged">
    <dx:DXTabItem Header="CS" Width="250">

wpf-spreadsheet-pivot-table-api-examples/CS/SpreadsheetWPFPivotTableExamples/MainWindow.xaml#L29

<dx:DXTabControl x:Name="tabControl" Grid.Row="1" Grid.Column="0" SelectionChanged="tabControl_SelectionChanged">
    <dx:DXTabItem Header="CS" Width="250">

wpf-richedit-use-docvariable-fields/CS/MainWindow.xaml#L21

<dx:DXTabControl Name="tabControl" Grid.Row="1" SelectionChanged="tabControl_SelectionChanged">
    <dx:DXTabItem Header="Template">

wpf-richedit-document-api/CS/DXRichEditControlAPISample/MainWindow.xaml#L28

<dx:DXTabControl x:Name="tabControl" Grid.Row="1" Grid.Column="0" SelectionChanged="tabControl_SelectionChanged">
    <dx:DXTabItem Header="CS" Width="250">

dxrichedit-for-wpf-how-to-implement-progress-indicator/CS/MainWindow.xaml#L17

<Button Name="btnMailMerge" Content="Mail Merge" Width="200" HorizontalAlignment="Left" Margin="5" Click="btnMailMerge_Click" />
<dx:DXTabControl Name="tabControl" Grid.Row="1" SelectionChanged="tabControl_SelectionChanged">
    <dx:DXTabItem Header="Template">