New to Telerik UI for WinForms? Start a free 30-day trial

Provides shared form, threading, and action-queue behavior for splash, overlay, and flyout screens.

Definition

Namespace:Telerik.WinControls.UI.SplashScreen

Assembly:Telerik.WinControls.UI.dll

Type Parameters:

T

The form type created by the derived screen.

Syntax:

C#
public abstract class BaseSplash<T> : IDisposable where T : Form

Inheritance: objectBaseSplash<T>

Derived Classes: BaseOverlayScreenSplashScreen

Implements: IDisposable

Constructors

Initializes the base splash state; the form, animation manager, and action queue are created lazily.

C#
public BaseSplash()

Properties

Gets or sets the animation manager, which holds the animation settings and is responsible for the animation.

C#
public SplashAnimationManager AnimationManager { get; set; }

Gets or sets the splash form, creating it through CreateFrom() when the getter first needs it.

C#
protected virtual T Form { get; set; }

Gets whether the screen's form instance has been created; it may not yet be visible.

C#
public bool IsActive { get; }

Gets or sets the theme name of the splash form.

C#
public string ThemeName { get; set; }

Gets or sets the thread on which the form is shown.

C#
protected Thread Thread { get; set; }

Methods

Starts the specified action on a new background STA thread.

C#
protected virtual void CreateAndStartBackgroundThreadWithAction(ThreadStart action)
Parameters:actionThreadStart

The action to run on the new thread.

Exceptions: InvalidOperationException

A thread is already assigned to this splash instance.

Creates a form.

C#
public abstract T CreateFrom()
Returns:

T

The created form.

Clears queued actions and cached references to the form, thread, and animation manager.

C#
public virtual void Dispose()

Implements: IDisposable.Dispose()

This method does not close or dispose the form or stop its thread.

Invokes an action on the splash form when its handle is ready; otherwise queues it for processing by the derived screen.

C#
protected virtual void ExecuteAction(Action action)
Parameters:actionAction

The action to invoke or queue.