Skip to main content

DXTabControl.SelectedTabItem Property

OBSOLETE

Use the SelectedContainer property.

Gets or sets the selected tab item. This is a dependency property.

Namespace: DevExpress.Xpf.Core

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

NuGet Package: DevExpress.Wpf.Core

Declaration

[Obsolete("Use the SelectedContainer property.")]
public DXTabItem SelectedTabItem { get; set; }

Property Value

Type Description
DXTabItem

A DXTabItem object that specifies the selected tab item.

Remarks

Use the SelectedTabItem property to select a tab item. You can also use the DXTabControl.SelectedIndex property to select the required tab item by its index within the Items collection. To obtain whether a tab item is selected, use its DXTabItem.IsSelected property.

The tab control allows you to hide individual tab items. Using the DXTabControl.SelectedIndex or SelectedTabItem properties to select a hidden tab item does nothing. In this instance, use the DXTabControl.ShowTabItem method.

Setting the SelectedTabItem property to a new value fires the DXTabControl.SelectionChanging event. This event is raised before a tab item is selected, allowing you to cancel the action. After the item has been selected, the DXTabControl.SelectionChanged event is fired.

Refer to the following help topic for more information: Selecting Tab Items.

See Also