[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
 [Expand]What's Installed
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
  [Expand]Data Grid
  [Expand]Ribbon, Bars and Menu
  [Expand]Charts Suite
  [Expand]Pivot Grid
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Expand]Gauge Controls
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Data Editors
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Diagram Control
  [Collapse]Windows and Utility Controls
    Loading Decorator
    Wait Indicator
   Dialogs, Notifications and Panels
  [Expand]Scheduler (legacy)
 [Expand]Scaffolding Wizard
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Loading Decorator

The LoadingDecorator is a container control for displaying long-loading content. The LoadingDecorator displays a loading indicator while its content is loading. When the content is fully loaded, the loading indicator collapses and the content becomes visible.

Expanded Getting Started with LoadingDecorator

To use the LoadingDecorator, wrap the long-loading content with the dx:LoadingDecorator tag as follows.

In this case, the LoadingDecorator will be automatically displayed until its content is loaded and then hidden when content is fully loaded. To manually control loading indicator visibility, use the IsSplashScreenShown property.

Expanded Customizing Loading Indicator

LoadingDecorator provides a set of properties that allow you to customize its loading indicator appearance.

  • To define your own loading indicator layout, use the LoadingDecorator.SplashScreenTemplate property. The newly defined layout might be provided with custom data passed via the LoadingDecorator.SplashScreenDataContext property. To change the position of the loading indicator, use the LoadingDecorator.SplashScreenLocation property. It allows you to show the loading indicator either in the center of the window (SplashScreenLocation.CenterWindow) or in the center of the container (SplashScreenLocation.CenterContainer).
  • By using the LoadingDecorator.BorderEffect and LoadingDecorator.BorderEffectColor properties, you can specify the loading indicator border highlighting effect. BorderEffect allows you to specify the border highlighting mode and the BorderEffectColor - border highlighting color.

  • To prevent the loading indicator from using fade animation, set the LoadingDecorator.UseFadeEffect property to false.

Expanded Owner lock modes

The LoadingDecorator.OwnerLock property allows you to choose the owner lock mode.

  • SplashScreenLock.Full - in this mode, the content and window-container can't be clicked and moved until the loading indicator is shown.
  • SplashScreenLock.InputOnly - while the loading indicator is visible, an end-user can move the window owner, but cannot access the content.
  • SplashScreenLock.None - the content and window-container are not locked.
  • SplashScreenLock.LoadingContent - only the LoadingDecorator's content is blocked.

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