Skip to main content

XtraTabControl.Deselecting Event

Occurs when a page is about to be deselected, and allows cancellation of the operation.

Namespace: DevExpress.XtraTab

Assembly: DevExpress.XtraEditors.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

[DXCategory("Action")]
public event TabPageCancelEventHandler Deselecting

Event Data

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

Property Description
Action Gets the action being performed on a tab. Inherited from TabPageEventArgs.
Cancel Gets or sets whether the event must be canceled.
Page Gets the currently processed page. Inherited from TabPageEventArgs.
PageIndex Gets the index of the current page. Inherited from TabPageEventArgs.

Remarks

When selecting a specific page, the following events occur in the following order:

The XtraTabControl.Deselecting and XtraTabControl.Selecting events provide a Cancel parameter that allows you to prevent a specific page from being deselected and selected, respectively.

In addition to these events, the XtraTabControl provides the XtraTabControl.SelectedPageChanging and XtraTabControl.SelectedPageChanged events, that also allow you to respond to the active page change. The XtraTabControl.SelectedPageChanging event provides two parameters (Page and PrevPage) that refer to the pages between which focus is about to be moved. This event can be handled to prevent the active page from being changed.

If the animation is enabled (see XtraTabControl.Transition), the XtraTabControl.SelectedPageChangeAnimationCompleted event fires when the animation completes, allowing you to perform required actions (e.g., focus a particular control) on the activated page.

See Also