Back to Devexpress

XtraTabControl.SelectedPageChanged Event

windowsforms-devexpress-dot-xtratab-dot-xtratabcontrol-abf852b4.md

latest7.6 KB
Original Source

XtraTabControl.SelectedPageChanged Event

Fires after a new XtraTabControl page has been selected.

Namespace : DevExpress.XtraTab

Assembly : DevExpress.XtraEditors.v25.2.dll

NuGet Package : DevExpress.Win.Navigation

Declaration

csharp
[DXCategory("Behavior")]
public event TabPageChangedEventHandler SelectedPageChanged
vb
<DXCategory("Behavior")>
Public Event SelectedPageChanged As TabPageChangedEventHandler

Event Data

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

PropertyDescription
PageGets the tab page currently being processed.
PrevPageGets the previously processed tab page.

Remarks

An XtraTabControl selects a page when a user clicks this page header or uses keyboard navigation, or when the code-behind modifies the XtraTabControl.SelectedTabPage or XtraTabControl.SelectedTabPageIndex properties.

The event parameter’s TabPageChangedEventArgs.Page and TabPageChangedEventArgs.PrevPage properties allow you to identify the currently selected page, and a page that was selected before.

If you enable animation effects that follow page transitions (see XtraTabControl.Transition), the XtraTabControl.SelectedPageChangeAnimationCompleted event fires when the animation completes.

The following code snippets (auto-collected from DevExpress Examples) contain references to the SelectedPageChanged 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.

winforms-spreadsheet-chart-api/CS/SpreadsheetChartAPISamples/Form1.cs#L65

csharp
ShowFirstExample();
    this.xtraTabControl1.SelectedPageChanged += new TabPageChangedEventHandler(this.xtraTabControl1_SelectedPageChanged);
}

winforms-spreadsheet-pivot-table-api/CS/SpreadsheetPivotTableExamples/Form1.cs#L64

csharp
ShowFirstExample();
    this.xtraTabControl1.SelectedPageChanged += new TabPageChangedEventHandler(this.xtraTabControl1_SelectedPageChanged);
}

winforms-spreadsheetcontrol-api-part-3/CS/SpreadsheetControl_API_Part03/Form1.cs#L283

csharp
this.evaluator.OnAfterCompile += evaluator_OnAfterCompile;
this.xtraTabControl1.SelectedPageChanged += xtraTabControl1_SelectedPageChanged;

winforms-richeditcontrol-common-api/CS/RichEditAPISample/Form1.cs#L367

csharp
ShowFirstExample();
    this.xtraTabControl1.SelectedPageChanged += new DevExpress.XtraTab.TabPageChangedEventHandler(this.xtraTabControl1_SelectedPageChanged);
}

winforms-richedit-document-api/CS/RichEditAPISample/Form1.cs#L376

csharp
this.evaluator.OnAfterCompile += evaluator_OnAfterCompile;
this.xtraTabControl1.SelectedPageChanged += xtraTabControl1_SelectedPageChanged;

winforms-spreadsheet-chart-api/VB/SpreadsheetChartAPISamples/Form1.vb#L64

vb
ShowFirstExample()
    AddHandler xtraTabControl1.SelectedPageChanged, AddressOf xtraTabControl1_SelectedPageChanged
End Sub

winforms-spreadsheet-pivot-table-api/VB/SpreadsheetPivotTableExamples/Form1.vb#L62

vb
ShowFirstExample()
    AddHandler xtraTabControl1.SelectedPageChanged, AddressOf xtraTabControl1_SelectedPageChanged
End Sub

winforms-spreadsheetcontrol-api-part-3/VB/SpreadsheetControl_API_Part03/Form1.vb#L288

vb
AddHandler evaluator.OnAfterCompile, AddressOf evaluator_OnAfterCompile
AddHandler xtraTabControl1.SelectedPageChanged, AddressOf xtraTabControl1_SelectedPageChanged
ShowFirstExample("Data Validation Actions")

winforms-richeditcontrol-common-api/VB/RichEditAPISample/Form1.vb#L353

vb
ShowFirstExample()
    AddHandler xtraTabControl1.SelectedPageChanged, AddressOf xtraTabControl1_SelectedPageChanged
End Sub

winforms-richedit-document-api/VB/RichEditAPISample/Form1.vb#L383

vb
AddHandler evaluator.OnAfterCompile, AddressOf evaluator_OnAfterCompile
AddHandler xtraTabControl1.SelectedPageChanged, AddressOf xtraTabControl1_SelectedPageChanged
ShowFirstExample("Range")

See Also

SelectedPageChangeAnimationCompleted

SelectedTabPage

SelectedTabPageIndex

Deselected

Deselecting

Selected

Selecting

XtraTabControl Class

XtraTabControl Members

DevExpress.XtraTab Namespace