DashboardViewer.SetSelectedTabPage(String, Int32) Method

Selects the tab page specified by its index in the specified tab container.

Namespace: DevExpress.DashboardWin

Assembly: DevExpress.Dashboard.v20.2.Win.dll


public void SetSelectedTabPage(
    string tabContainerName,
    int index


Name Type Description
tabContainerName String

A String that is the TabContainerDashboardItem.ComponentName property value and identifies the tab container.

index Int32

An integer that is the index in the TabContainerDashboardItem.TabPages collection.


The following code implements tab navigation in the TabContainerDashboardItem control.

View Example: How to navigate tabs using custom tab header buttons or set up a slide show

using DevExpress.DashboardCommon;
using System.Linq;
// ...

enum NextPrevValue {

void ShowNextPrevTab(NextPrevValue value) {
    Dashboard dashboard = dashboardViewer.Dashboard;
    TabContainerDashboardItem tabContainer = dashboard.Items.SingleOrDefault(i => i is TabContainerDashboardItem) as TabContainerDashboardItem;
        if(tabContainer != null) {
            int increment = value == NextPrevValue.Next ? 1 : -1;
            string tabContainerName = tabContainer.ComponentName;
            int selectedIndex = dashboardViewer.GetSelectedTabPageIndex(tabContainerName);
            int pageCount = tabContainer.TabPages.Count;
            dashboardViewer.SetSelectedTabPage(tabContainerName, (selectedIndex + pageCount + increment) % pageCount);
See Also