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
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:
XtraTabControl.Deselecting- XtraTabControl.Deselected
- XtraTabControl.Selecting
- XtraTabControl.Selected
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.