[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Collapse]Forms and User Controls
    Ribbon Form
    Tabbed Form
    Fluent Design Form
    Form Assistant
    Taskbar Assistant
   [Collapse]Splash Screen Manager
     Splash Screen Manager Overview
     Splash Screen
     Splash Image
     Wait Form
     Splash Form Position
     Splash Screen Manager Serialization Specifics
     Overlay Form
   [Expand]Adorner UI Manager
  [Expand]Messages, Notifications, and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Overlay Form

An Overlay Form is a semi-transparent splash screen that:

  • overlaps a control or form;
  • prevents users from interacting with the overlapped control;
  • overlaps the control even if it changes its size or position on the screen;
  • runs in a separate thread and does not lock the main and operation threads;
  • can be custom drawn.


Show Me Run the Overlay Form module in the XtraEditors MainDemo to see the form in action.

Expanded Show Overlay Form

Call the SplashScreenManager.ShowOverlayForm method to display an Overlay Form over a control or form.

You can only show an Overlay Form over a control/form that has a handle (see System.Windows.Forms.Control.IsHandleCreated). Otherwise, an exception is thrown.

The method returns the Overlay Form’s handle. To close the Overlay Form, pass this handle to the SplashScreenManager.CloseOverlayForm method. The example below shows how to display an Overlay Form over the current form.


You cannot create an Overlay Form at design time, but you can custom draw it (see below).

The wait indicator, fade animation and colors depend on the control's skin. The SplashScreenManager.ShowOverlayForm method overload with additional parameters allows you to customize the wait indicator, fade animation, form opacity, background and foreground colors.


Run the XtraEditors demo for the complete example.

Expanded Custom Painter

You can implement a painter to custom draw an Overlay Form as follows:

  • inherit from the OverlayWindowPainterBase class;
  • override the Draw method;
  • pass the created object as a parameter to the ShowOverlayForm method.

The code snippet below shows how to display a custom message as in the following figure:


You cannot change properties of controls created in the Overlay Form’s main (UI) thread.

Expanded See Also

Is this topic helpful?​​​​​​​