Back to Devexpress

DashboardViewer.GetSelectedTabPage(String) Method

dashboard-devexpress-dot-dashboardwin-dot-dashboardviewer-dot-getselectedtabpage-x28-system-dot-string-x29.md

latest4.2 KB
Original Source

DashboardViewer.GetSelectedTabPage(String) Method

Gets the selected page in the specified tab container.

Namespace : DevExpress.DashboardWin

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

NuGet Package : DevExpress.Win.Dashboard

Declaration

csharp
public string GetSelectedTabPage(
    string tabContainerName
)
vb
Public Function GetSelectedTabPage(
    tabContainerName As String
) As String

Parameters

NameTypeDescription
tabContainerNameString

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

|

Returns

TypeDescription
String

A String that is the DashboardTabPage.ComponentName property value and identifies the tab page.

|

Example

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

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

enum NextPrevValue {
    Next,
    Prev
}

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);
        }
}
vb
Imports DevExpress.DashboardCommon
Imports System.Linq
' ...

Friend Enum NextPrevValue
    [Next]
    Prev
End Enum

Private Sub ShowNextPrevTab(ByVal value As NextPrevValue)
    Dim tabContainer As TabContainerDashboardItem = TryCast(dashboard.Items.SingleOrDefault(Function(i) TypeOf i Is TabContainerDashboardItem), TabContainerDashboardItem)
    If tabContainer IsNot Nothing Then
        Dim increment As Integer = If(value = NextPrevValue.Next, 1, -1)
        Dim tabContainerName As String = tabContainer.ComponentName
        Dim selectedIndex As Integer = dashboardViewer.GetSelectedTabPageIndex(tabContainerName)
        Dim pageCount As Integer = tabContainer.TabPages.Count
        dashboardViewer.SetSelectedTabPage(tabContainerName, (selectedIndex + pageCount + increment) Mod pageCount)
    End If
End Sub

Implements

GetSelectedTabPage(String)

See Also

TabContainerDashboardItem

GetSelectedTabPageIndex(String)

SetSelectedTabPage

DashboardViewer Class

DashboardViewer Members

DevExpress.DashboardWin Namespace