[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
  Prerequisites
 [Expand]What's Installed
 [Expand].NET Core 3 Support
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Expand]Controls and Libraries
 [Expand]Scaffolding Wizard
 [Expand]Localization
  Redistribution and Deployment
  Get More Help
 [Collapse]API Reference
  [Expand]DevExpress.Charts.Designer
  [Expand]DevExpress.Data
  [Expand]DevExpress.Mvvm.UI
  [Expand]DevExpress.Mvvm.UI.Interactivity
  [Expand]DevExpress.Mvvm.UI.ModuleInjection
  [Expand]DevExpress.Xpf.Accordion
  [Expand]DevExpress.Xpf.Bars
  [Expand]DevExpress.Xpf.Carousel
  [Expand]DevExpress.Xpf.Charts
  [Expand]DevExpress.Xpf.Charts.Localization
  [Expand]DevExpress.Xpf.Charts.RangeControlClient
  [Expand]DevExpress.Xpf.ChunkList
  [Expand]DevExpress.Xpf.Controls
  [Collapse]DevExpress.Xpf.Core
   [Expand]Badge Class
    BadgeKind Enumeration
    BadgeShape Enumeration
   [Expand]BaseSvgImageSourceExtension Class
    BestFitMode Enumeration
    BorderEffect Enumeration
    ButtonShowMode Enumeration
   [Expand]CancelRoutedEventArgs Class
    CancelRoutedEventHandler Delegate
   [Expand]ColumnChooserControlBase Class
   [Expand]CompleteRecordDragDropEventArgs Class
   [Expand]ContentHost Class
   [Expand]ContinueRecordDragEventArgs Class
    ControlBoxButtons Enumeration
   [Expand]DataObjectBase Class
   [Expand]DialogService Class
   [Expand]DragDropHintData Class
   [Expand]DragEventArgsBase Class
   [Expand]DragRecordOverEventArgs Class
   [Expand]DropDownButton Class
   [Expand]DropDownButtonBase Class
   [Expand]DropMarkerData Class
    DropPlace Enumeration
    DropPosition Enumeration
   [Expand]DropRecordEventArgs Class
   [Expand]DXDialog Class
   [Expand]DXDialogWindow Class
   [Expand]DXExpander Class
   [Expand]DXFrameworkContentElement Class
   [Expand]DXImageHelper Class
   [Expand]DXLocalizer<T> Class
   [Expand]DXMessageBox Class
   [Expand]DXMessageBoxService Class
   [Expand]DXSplashScreenService Class
   [Expand]DXTabbedWindow Class
   [Expand]DXTabControl Class
   [Expand]DXTabItem Class
   [Expand]DXWindow Class
    EditorShowMode Enumeration
   [Expand]ExpandCollapseInfoEventArgs Class
    ExpandCollapseInfoEventHandler Delegate
   [Expand]FloatingContainer Class
    FloatingMode Enumeration
   [Expand]GiveRecordDragFeedbackEventArgs Class
    HeaderLocation Enumeration
    HeaderOrientation Enumeration
    HideButtonShowMode Enumeration
    HorizontalExpandMode Enumeration
   [Expand]IColumnChooser Interface
   [Expand]IColumnChooserFactory Interface
   [Expand]INotifyIconService Interface
   [Expand]IWorkspace Interface
   [Expand]IWorkspaceManager Interface
   [Expand]ListBoxDragDropBehavior Class
   [Collapse]LoadingDecorator Class
     LoadingDecorator Members
     LoadingDecorator Constructor
    [Expand]LoadingDecorator Properties
    NewButtonShowMode Enumeration
   [Expand]NotifyIconService Class
   [Expand]NotifyIconState Class
   [Expand]PixelSnapper Class
   [Expand]PredefinedThemePalette Class
   [Expand]PredefinedThemePalettes Class
   [Expand]RecordDragDropData Class
    ScrollBarMode Enumeration
    ScrollBars Enumeration
    ScrollButtonShowMode Enumeration
   [Expand]ScrollControl Class
   [Expand]SimpleButton Class
    SingleTabItemHideMode Enumeration
    SplashScreenLocation Enumeration
    SplashScreenLock Enumeration
    SplashScreenOwnerSearchMode Enumeration
   [Expand]SplitButton Class
   [Expand]StartRecordDragEventArgs Class
   [Expand]SuperTip Class
   [Expand]SuperTipHeaderItem Class
   [Expand]SuperTipItem Class
   [Expand]SuperTipItemBase Class
   [Expand]SuperTipItemSeparator Class
   [Expand]SvgImageHelper Class
   [Expand]SvgImageSourceExtension Class
   [Expand]TabbedWindowDocumentUIService Class
    TabbedWindowMode Enumeration
    TabContentCacheMode Enumeration
   [Expand]TabControlCommonCancelEventArgsBase Class
    TabControlDragDropMode Enumeration
   [Expand]TabControlMultiLineView Class
   [Expand]TabControlNewTabbedWindowEventArgs Class
    TabControlNewTabbedWindowEventHandler Delegate
   [Expand]TabControlScrollView Class
   [Expand]TabControlSelectionChangedEventArgs Class
    TabControlSelectionChangedEventHandler Delegate
   [Expand]TabControlSelectionChangingEventArgs Class
    TabControlSelectionChangingEventHandler Delegate
   [Expand]TabControlStretchView Class
   [Expand]TabControlTabAddedEventArgs Class
    TabControlTabAddedEventHandler Delegate
   [Expand]TabControlTabAddingEventArgs Class
    TabControlTabAddingEventHandler Delegate
   [Expand]TabControlTabHiddenEventArgs Class
    TabControlTabHiddenEventHandler Delegate
   [Expand]TabControlTabHidingEventArgs Class
    TabControlTabHidingEventHandler Delegate
   [Expand]TabControlTabRemovedEventArgs Class
    TabControlTabRemovedEventHandler Delegate
   [Expand]TabControlTabRemovingEventArgs Class
    TabControlTabRemovingEventHandler Delegate
   [Expand]TabControlTabShowingEventArgs Class
    TabControlTabShowingEventHandler Delegate
   [Expand]TabControlTabShownEventArgs Class
    TabControlTabShownEventHandler Delegate
   [Expand]TabControlTabStartDraggingEventArgs Class
   [Expand]TabControlViewBase Class
   [Expand]Theme Class
   [Expand]ThemedMessageBox Class
   [Expand]ThemedWindow Class
   [Expand]ThemedWindowDialogButton Class
   [Expand]ThemedWindowHeaderItemsControl Class
   [Expand]ThemedWindowHeaderItemsControlBase Class
   [Expand]ThemedWindowToolbarItemsControl Class
   [Expand]ThemeManager Class
   [Expand]ThemePalette Class
   [Expand]ThemePaletteBase Class
    TransitionEffect Enumeration
   [Expand]UniformStackPanel Class
    VerticalExpandMode Enumeration
   [Expand]WindowedDocumentUIService Class
    WindowKind Enumeration
    WindowTitleAlignment Enumeration
   [Expand]WorkspaceManager Class
   [Expand]WpfSvgPalette Class
  [Expand]DevExpress.Xpf.Core.ConditionalFormatting
  [Expand]DevExpress.Xpf.Core.DataSources
  [Expand]DevExpress.Xpf.Core.FilteringUI
  [Expand]DevExpress.Xpf.Core.Native
  [Expand]DevExpress.Xpf.Core.ServerMode
  [Expand]DevExpress.Xpf.Data
  [Expand]DevExpress.Xpf.DataAccess
  [Expand]DevExpress.Xpf.DataAccess.DataSourceWizard
  [Expand]DevExpress.Xpf.Diagram
  [Expand]DevExpress.Xpf.Dialogs
  [Expand]DevExpress.Xpf.Docking
  [Expand]DevExpress.Xpf.Docking.Base
  [Expand]DevExpress.Xpf.DocumentViewer
  [Expand]DevExpress.Xpf.DXBinding
  [Expand]DevExpress.Xpf.Editors
  [Expand]DevExpress.Xpf.Editors.DataPager
  [Expand]DevExpress.Xpf.Editors.DateNavigator
  [Expand]DevExpress.Xpf.Editors.ExpressionEditor
  [Expand]DevExpress.Xpf.Editors.ExpressionEditor.Native
  [Expand]DevExpress.Xpf.Editors.Filtering
  [Expand]DevExpress.Xpf.Editors.Flyout
  [Expand]DevExpress.Xpf.Editors.Flyout.Native
  [Expand]DevExpress.Xpf.Editors.Helpers
  [Expand]DevExpress.Xpf.Editors.Native
  [Expand]DevExpress.Xpf.Editors.Popups
  [Expand]DevExpress.Xpf.Editors.RangeControl
  [Expand]DevExpress.Xpf.Editors.Settings
  [Expand]DevExpress.Xpf.Editors.Validation
  [Expand]DevExpress.Xpf.ExpressionEditor
  [Expand]DevExpress.Xpf.Gantt
  [Expand]DevExpress.Xpf.Gauges
  [Expand]DevExpress.Xpf.Gauges.Localization
  [Expand]DevExpress.Xpf.Grid
  [Expand]DevExpress.Xpf.Grid.ConditionalFormatting
  [Expand]DevExpress.Xpf.Grid.LookUp
  [Expand]DevExpress.Xpf.Grid.TreeList
  [Expand]DevExpress.Xpf.Layout.Core
  [Expand]DevExpress.Xpf.LayoutControl
  [Expand]DevExpress.Xpf.Map
  [Expand]DevExpress.Xpf.NavBar
  [Expand]DevExpress.Xpf.Navigation
  [Expand]DevExpress.Xpf.PdfViewer
  [Expand]DevExpress.Xpf.PivotGrid
  [Expand]DevExpress.Xpf.PivotGrid.Printing
  [Expand]DevExpress.Xpf.Printing
  [Expand]DevExpress.Xpf.Printing.Parameters
  [Expand]DevExpress.Xpf.Printing.Parameters.Models
  [Expand]DevExpress.Xpf.Printing.PreviewControl
  [Expand]DevExpress.Xpf.Printing.PreviewControl.Bars
  [Expand]DevExpress.Xpf.Prism
  [Expand]DevExpress.Xpf.PropertyGrid
  [Expand]DevExpress.Xpf.Reports.UserDesigner
  [Expand]DevExpress.Xpf.Reports.UserDesigner.Extensions
  [Expand]DevExpress.Xpf.Reports.UserDesigner.Localization
  [Expand]DevExpress.Xpf.Reports.UserDesigner.ReportWizard
  [Expand]DevExpress.Xpf.Reports.UserDesigner.ReportWizard.Pages
  [Expand]DevExpress.Xpf.Ribbon
  [Expand]DevExpress.Xpf.RichEdit
  [Expand]DevExpress.Xpf.RichEdit.Menu
  [Expand]DevExpress.Xpf.Scheduler
  [Expand]DevExpress.Xpf.Scheduler.Drawing
  [Expand]DevExpress.Xpf.Scheduler.Menu
  [Expand]DevExpress.Xpf.Scheduler.Reporting
  [Expand]DevExpress.Xpf.Scheduler.UI
  [Expand]DevExpress.Xpf.Scheduling
  [Expand]DevExpress.Xpf.Scheduling.Common
  [Expand]DevExpress.Xpf.Scheduling.Editors
  [Expand]DevExpress.Xpf.Scheduling.iCalendar
  [Expand]DevExpress.Xpf.Scheduling.Reporting
  [Expand]DevExpress.Xpf.Scheduling.Visual
  [Expand]DevExpress.Xpf.Scheduling.VisualData
  [Expand]DevExpress.Xpf.SpellChecker
  [Expand]DevExpress.Xpf.Spreadsheet
  [Expand]DevExpress.Xpf.Spreadsheet.Menu
  [Expand]DevExpress.Xpf.TreeMap
  [Expand]DevExpress.Xpf.Utils.Themes
  [Expand]DevExpress.Xpf.WindowsUI
  [Expand]DevExpress.Xpf.WindowsUI.Internal
  [Expand]DevExpress.Xpf.WindowsUI.Navigation
  [Expand]DevExpress.XtraRichEdit
  [Expand]DevExpress.XtraRichEdit.Printing
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

LoadingDecorator Class

A container control for displaying long-loading content. Once the content is fully loaded, the loading indicator disappears and the content becomes visible.

Namespace:DevExpress.Xpf.Core
Assembly:DevExpress.Xpf.Core.v19.2.dll

Expanded Syntax

Expanded Remarks

The LoadingDecorator is a container control that displays a loading indicator during data/content loading. The Loading Decorator uses the Wait Indicator control to inform that loading is in progress. The Loading Decorator disappears when the content is loaded.

Note

The Wait Indicator works within the main application's UI thread. UI freezes may affect the Wait Indicator animation.

Wrap the content with the dx:LoadingDecorator tag to add the LoadingDecorator to an application:

Expanded Lock Modes

Use the OwnerLock property to specify which part of an applications is locked while the LoadingDecorator content loads:

Value Image Description
SplashScreenLock.Full

Blocks the entire window.

SplashScreenLock.InputOnly

Blocks the entire window's input. The window's title bar stays active, and you can move the window.

SplashScreenLock.LoadingContent

Blocks only the LoadingDecorator's content.

SplashScreenLock.None

Nothing is blocked.

Expanded Customization

Content

Use SplashScreenTemplate and SplashScreenDataContext properties to customize the LoadingDecorator's content, layout, and appearance.

The following code sample sets the Loading Decorator's text to Loading...Please wait:

Tip

Set the WaitIndicator's Content property to "" (empty string) to hide the Loading Decorator's text.

Position

Use the SplashScreenLocation property to specify the Loading Decorator position.

You can set the SplashScreenLocation property to the following values:

Value Description
SplashScreenLocation.CenterWindow Locates the splash screen in the window center.
SplashScreenLocation.CenterScreen Locates the splash screen in the screen center.
SplashScreenLocation.CenterContainer Locates the splash screen in the container center.

Border

Use the following properties to specify the border highlight effect:

Fade Animation

Use the following properties to customize fade effects:

The following code sample sets the Fade In and Fade Out animation time to 400 milliseconds:

Expanded Inheritance Hierarchy

System.Object
    System.Windows.Threading.DispatcherObject
       System.Windows.DependencyObject
          System.Windows.Media.Visual
             System.Windows.UIElement
                System.Windows.FrameworkElement
                   System.Windows.Controls.Decorator
                      LoadingDecorator

Expanded See Also

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