SplashFormBase.ProcessCommand(Enum, Object) Method

When overridden, the method allows you to process commands received from a SplashScreenManager via the SplashScreenManager.SendCommand method.

Namespace: DevExpress.XtraSplashForm

Assembly: DevExpress.XtraEditors.v18.2.dll

Declaration

C#

public virtual void ProcessCommand(
    Enum cmd,
    object arg
)

VB.NET

Public Overridable Sub ProcessCommand(
    cmd As  Enum,
    arg As Object
)

Parameters

Name	Type	Description
cmd	Enum	An enumeration value that identifies the received command.
arg	Object	The received command’s parameter.

Remarks

See SplashScreenManager.SendCommand to learn more.

Example

In this example a custom Progress Bar Control is added to a Splash Screen. The example shows how to update this Progress Bar Control dynamically by sending commands from a Splash Screen Manager.Splash Screens are displayed by a Splash Screen Manager in a separate thread. Interaction with Splash Screens can be performed via the command mechanism. You send a command via the SplashScreenManager.SendCommand method and process this command by overriding the SplashScreen.ProcessCommand method. In the example, custom commands are sent to the Splash Screen to advance the progress of the Splash Screen's Progress Bar Control.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-interact-with-a-splash-screen-by-sending-commands-e3576

SplashScreen1.cs

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Text;
using System.Windows.Forms;
using DevExpress.XtraSplashScreen;

namespace SplashScreen_ProcessCommand {
    public partial class SplashScreen1 : SplashScreen {
        public SplashScreen1() {
            InitializeComponent();
        }

        #region Overrides

        public override void ProcessCommand(Enum cmd, object arg) {
            base.ProcessCommand(cmd, arg);
            SplashScreenCommand command = (SplashScreenCommand)cmd;
            if (command == SplashScreenCommand.SetProgress) {
                int pos = (int)arg;
                progressBarControl1.Position = pos;
            }
        }

        #endregion

        public enum SplashScreenCommand {
            SetProgress,
            Command2,
            Command3
        }
    }
}

Form1.cs

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Windows.Forms;
using DevExpress.XtraSplashScreen;
using System.Threading;


namespace SplashScreen_ProcessCommand {
    public partial class Form1 : Form {
        public Form1() {
            InitializeComponent();
        }

        private void btnShowSplashScreen_Click(object sender, EventArgs e) {
            // Open a Splash Screen
            SplashScreenManager.ShowForm(this, typeof(SplashScreen1), true, true, false);

            // The splash screen will be opened in a separate thread. To interact with it, use the SendCommand method.
            for (int i = 1; i <= 100; i++) {
                SplashScreenManager.Default.SendCommand(SplashScreen1.SplashScreenCommand.SetProgress, i);
                //To process commands, override the SplashScreen.ProcessCommand method.
                Thread.Sleep(25);
            }

            // Close the Splash Screen.
            SplashScreenManager.CloseForm(false);
        }
    }
}

Form1.vb

Imports Microsoft.VisualBasic
Imports System
Imports System.Collections.Generic
Imports System.ComponentModel
Imports System.Data
Imports System.Drawing
Imports System.Linq
Imports System.Text
Imports System.Windows.Forms
Imports DevExpress.XtraSplashScreen
Imports System.Threading


Namespace SplashScreen_ProcessCommand
    Partial Public Class Form1
        Inherits Form
        Public Sub New()
            InitializeComponent()
        End Sub

        Private Sub btnShowSplashScreen_Click(ByVal sender As Object, ByVal e As EventArgs) Handles btnShowSplashScreen.Click
            ' Open a Splash Screen
            SplashScreenManager.ShowForm(Me, GetType(SplashScreen1), True, True, False)

            ' The splash screen will be opened in a separate thread. To interact with it, use the SendCommand method.
            For i As Integer = 1 To 100
                SplashScreenManager.Default.SendCommand(SplashScreen1.SplashScreenCommand.SetProgress, i)
                'To process commands, override the SplashScreen.ProcessCommand method.
                Thread.Sleep(25)
            Next i

            ' Close the Splash Screen.
            SplashScreenManager.CloseForm(False)
        End Sub
    End Class
End Namespace

SplashScreen1.vb

Imports Microsoft.VisualBasic
Imports System
Imports System.Collections.Generic
Imports System.ComponentModel
Imports System.Data
Imports System.Drawing
Imports System.Text
Imports System.Windows.Forms
Imports DevExpress.XtraSplashScreen

Namespace SplashScreen_ProcessCommand
    Partial Public Class SplashScreen1
        Inherits SplashScreen
        Public Sub New()
            InitializeComponent()
        End Sub

        #Region "Overrides"

        Public Overrides Sub ProcessCommand(ByVal cmd As System.Enum, ByVal arg As Object)
            MyBase.ProcessCommand(cmd, arg)
            Dim command As SplashScreenCommand = CType(cmd, SplashScreenCommand)
            If command = SplashScreenCommand.SetProgress Then
                Dim pos As Integer = CInt(Fix(arg))
                progressBarControl1.Position = pos
            End If
        End Sub

        #End Region

        Public Enum SplashScreenCommand
            SetProgress
            Command2
            Command3
        End Enum
    End Class
End Namespace

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ProcessCommand(Enum, Object) 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#

how-to-find-a-node-in-a-treelist-in-a-background-thread-e4531/CS/AsynchronousFindInTreeList/SplashScreen1.cs#L19

public override void ProcessCommand(Enum cmd, object arg) {
    base.ProcessCommand(cmd, arg);
}

how-to-cancel-time-consuming-operation-from-the-waitform-e4524/CS/WaitFormCanceling/WaitForm1.cs#L47

{
    base.ProcessCommand(cmd, arg);
    WaitFormCommand command = (WaitFormCommand)cmd;

winforms-splash-screen-loading-panel/CS/WaitForm1.cs#L28

public override void ProcessCommand(Enum cmd, object arg) {
    base.ProcessCommand(cmd, arg);
}

how-to-dynamically-change-a-wait-forms-labels-e3575/CS/WaitForm1.cs#L28

public override void ProcessCommand(Enum cmd, object arg) {
    base.ProcessCommand(cmd, arg);
}

how-to-interact-with-a-splash-screen-by-sending-commands-e3576/CS/SplashScreen1.cs#L19

public override void ProcessCommand(Enum cmd, object arg) {
    base.ProcessCommand(cmd, arg);
    SplashScreenCommand command = (SplashScreenCommand)cmd;

VB.NET

how-to-find-a-node-in-a-treelist-in-a-background-thread-e4531/VB/AsynchronousFindInTreeList/SplashScreen1.vb#L21

Public Overrides Sub ProcessCommand(ByVal cmd As System.Enum, ByVal arg As Object)
    MyBase.ProcessCommand(cmd, arg)
End Sub

how-to-cancel-time-consuming-operation-from-the-waitform-e4524/VB/WaitFormCanceling/WaitForm1.vb#L43

Public Overrides Sub ProcessCommand(ByVal cmd As System.Enum, ByVal arg As Object)
    MyBase.ProcessCommand(cmd, arg)
    Dim command As WaitFormCommand = CType(cmd, WaitFormCommand)

winforms-splash-screen-loading-panel/VB/WaitForm1.vb#L30

Public Overrides Sub ProcessCommand(ByVal cmd As System.Enum, ByVal arg As Object)
    MyBase.ProcessCommand(cmd, arg)
End Sub

how-to-dynamically-change-a-wait-forms-labels-e3575/VB/WaitForm1.vb#L30

Public Overrides Sub ProcessCommand(ByVal cmd As System.Enum, ByVal arg As Object)
    MyBase.ProcessCommand(cmd, arg)
End Sub

how-to-interact-with-a-splash-screen-by-sending-commands-e3576/VB/SplashScreen1.vb#L17

Public Overrides Sub ProcessCommand(ByVal cmd As [Enum], ByVal arg As Object)
    MyBase.ProcessCommand(cmd, arg)
    Dim command As SplashScreenCommand = CType(cmd, SplashScreenCommand)