The requested page is not available for the requested platform. You are viewing the content for Default platform.

DashboardViewer.SetSelectedTabPage(String, Int32) Method

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

Namespace: DevExpress.DashboardWin

Assembly: DevExpress.Dashboard.v19.1.Win.dll


public void SetSelectedTabPage(
    string tabContainerName,
    int index
Public Sub SetSelectedTabPage(
    tabContainerName As String,
    index As Integer


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.

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);

The complete sample project How to navigate tabs using custom tab header buttons or set up a slide show is available in the DevExpress Examples repository.

See Also