Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

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.2.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