DashboardViewer.MaximizeDashboardItemAsync(String) Method

Expands the specified dashboard item to the entire dashboard size in an asynchronous task.

Namespace: DevExpress.DashboardWin

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

NuGet Packages: DevExpress.Win.Dashboard, DevExpress.WindowsDesktop.Win.Dashboard

Declaration

C#

public Task MaximizeDashboardItemAsync(
    string itemName
)

VB.NET

Public Function MaximizeDashboardItemAsync(
    itemName As String
) As Task

Parameters

Name	Type	Description
itemName	String	A String that is the dashboard item component name (the ComponentName property).

Returns

Type	Description
Task	The task object that is the asynchronous operation to complete.

Remarks

Use the DashboardViewer.RestoreDashboardItemAsync method to restore the maximized item to its previous size.

Example

This example demonstrates how to call the asynchronous maximize and restore methods to create a slide show with the dashboard items.

Note

Example on GitHub: How to Create a Slide Show with Asynchronous Maximize and Restore Methods

C#

using DevExpress.XtraEditors;
using System;
using System.Windows.Forms;

namespace MaximizeSlideShow
{
    public partial class ViewerForm1 : XtraForm {
        bool isSlideShown = false;
        int index = 0;
        Timer slideShowTimer = new Timer() {
            Interval = 5000
        };

        public ViewerForm1() {
            InitializeComponent();
            slideShowTimer.Tick += OnSlideShowTimerTick;
        }

        async void OnSlideShowTimerTick(object sender, EventArgs e) {
            var items = dashboardViewer1.Dashboard.Items;
            int maxIndex = items.Count - 1;

            if(!isSlideShown) {
                slideShowTimer.Stop();
                return;
            }
            await dashboardViewer1.MaximizeDashboardItemAsync(items[index].ComponentName);
            if(index == maxIndex)
                index = 0;
            else
                index++;
        }

        void OnStartClick(object sender, MouseEventArgs e) {
            if(!isSlideShown) {
                isSlideShown = true;
                slideShowTimer.Start();
            }
        }
        async void OnStopClick(object sender, EventArgs e) {
            isSlideShown = false;
            await dashboardViewer1.RestoreDashboardItemAsync();
        }
    }
}

VB.NET

Imports DevExpress.XtraEditors
Imports System
Imports System.Windows.Forms

Namespace MaximizeSlideShow
    Partial Public Class ViewerForm1
        Inherits XtraForm

        Private isSlideShown As Boolean = False
        Private index As Integer = 0
        Private slideShowTimer As New Timer() With {.Interval = 5000}

        Public Sub New()
            InitializeComponent()
            AddHandler slideShowTimer.Tick, AddressOf OnSlideShowTimerTick
        End Sub

        Private Async Sub OnSlideShowTimerTick(ByVal sender As Object, ByVal e As EventArgs)
            Dim items = dashboardViewer1.Dashboard.Items
            Dim maxIndex As Integer = items.Count - 1

            If Not isSlideShown Then
                slideShowTimer.Stop()
                Return
            End If
            Await dashboardViewer1.MaximizeDashboardItemAsync(items(index).ComponentName)
            If index = maxIndex Then
                index = 0
            Else
                index += 1
            End If
        End Sub

        Private Sub OnStartClick(ByVal sender As Object, ByVal e As MouseEventArgs) Handles simpleButton1.MouseClick
            If Not isSlideShown Then
                isSlideShown = True
                slideShowTimer.Start()
            End If
        End Sub
        Private Async Sub OnStopClick(ByVal sender As Object, ByVal e As EventArgs) Handles simpleButton2.Click
            isSlideShown = False
            Await dashboardViewer1.RestoreDashboardItemAsync()
        End Sub
    End Class
End Namespace

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the MaximizeDashboardItemAsync(String) method.

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.

C#

winforms-dashboard-async-mode-maximize-slide-show/CS/ViewerForm1.cs#L27

}
await dashboardViewer1.MaximizeDashboardItemAsync(items[index].ComponentName);
if(index == maxIndex)

VB.NET

winforms-dashboard-async-mode-maximize-slide-show/VB/ViewerForm1.vb#L26

End If
Await dashboardViewer1.MaximizeDashboardItemAsync(items(index).ComponentName)
If index = maxIndex Then

Implements

MaximizeDashboardItemAsync(String)