Provides static methods and properties for managing splash screens that display application loading, progress, or startup information. A splash screen is typically shown during application initialization to provide visual feedback to users while the application loads.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class RadSplashScreenManager : BaseSplashManagerInheritance: objectBaseSplashManagerRadSplashScreenManager
Inherited Members
Constructors
public RadSplashScreenManager()Properties
Gets a value indicating whether a splash screen form is currently active and displayed.
public static bool IsActive { get; }true if a splash screen is currently open; otherwise, false.
Gets or sets the current splash screen instance used for displaying splash content. If no instance exists, a new SplashScreen will be created automatically.
public static SplashScreen SplashInstance { get; set; }The current SplashScreen instance.
Gets or sets the theme name applied to the splash screen form and its controls. This allows the splash screen to match the application's visual theme.
public static string ThemeName { get; set; }The name of the theme to apply to the splash screen.
Gets or sets a value indicating whether the splash screen form will be displayed as the topmost window above all other windows. When set to true, the splash screen will appear on top of all other applications.
public static bool TopMost { get; set; }true if the splash form should be topmost; otherwise, false.
Methods
Closes the currently active splash screen form and removes it from view. If no splash screen is currently displayed, this method has no effect.
public static void Close()Sets the main text content displayed in the splash screen when using RadSplashScreenControl. This method only affects splash screens that contain a RadSplashScreenControl.
public static void SetContent(string text)The text content to display in the splash screen.
Sets the footer text displayed at the bottom of the splash screen when using RadSplashScreenControl. This method only affects splash screens that contain a RadSplashScreenControl.
public static void SetFooter(string footerText)The text to display in the footer area of the splash screen.
Sets the footer icon displayed in the splash screen when using RadSplashScreenControl. This method only affects splash screens that contain a RadSplashScreenControl.
public static void SetIcon(Image footerIcon)The icon image to display in the footer area of the splash screen.
Sets the main image displayed in the splash screen when using RadSplashScreenControl. This method only affects splash screens that contain a RadSplashScreenControl.
public static void SetImage(Image image)The image to display as the main visual element of the splash screen.
Sets the progress percentage value when using RadSplashScreenControl with determinate progress state. This method only affects splash screens that contain a RadSplashScreenControl with determinate progress.
public static void SetProgress(int progress)The progress percentage value, typically between 0 and 100.
Sets the dimensions of the splash screen form to the specified width and height. This method allows dynamic resizing of the splash screen during runtime.
Sets the progress indicator state when using RadSplashScreenControl, controlling whether progress is shown as determinate, indeterminate, or hidden. This method only affects splash screens that contain a RadSplashScreenControl.
public static void SetState(SplashScreenProgressIndicatorState newState)The new progress indicator state determining how progress is visualized.
Displays a splash screen form using the default RadSplashScreenControl with the specified initial settings. This method provides a quick way to show a splash screen with predefined configuration.
public static void Show(RadSplashScreenSettings settings)The initial configuration settings for the splash screen including size, position, and appearance options.
Displays a splash screen form with custom content created from the specified type. The content type must inherit from Control or Form to be displayed properly.
public static void Show(Type contentType)The type of control or form to create and display as the splash screen content.
Events
Occurs when the splash screen content control has been created and initialized, but before it is displayed. This event allows customization of the content before it becomes visible to the user. Note that the control is created on a separate thread and it is required to use BeginInvoke/Invoke when accessing it to prevent cross-thread exceptions. Note that this is a static event and you need to explicitly unsubscribe from it to prevent memory leaks. Each object subscribed to this event cannot be garbage collected.
public static event ContentCreatedEventHandler ContentCreated