ApplicationThemeHelper.PreloadAsync(PreloadCategories[]) Method

Asynchronously preloads theme resources for the specified controls.

Namespace: DevExpress.Xpf.Core

Assembly: DevExpress.Data.Desktop.v24.1.dll

NuGet Packages: DevExpress.Data.Desktop, DevExpress.ExpressApp.Win.Design

Declaration

C#

public static Task PreloadAsync(
    params PreloadCategories[] preloadCategories
)

VB.NET

Public Shared Function PreloadAsync(
    ParamArray preloadCategories As PreloadCategories()
) As Task

Parameters

Name	Type	Description
preloadCategories	PreloadCategories[]	A collection of DevExpress WPF controls.

Returns

Type	Description
Task	A task that allows you to asynchronously preload theme resources.

Remarks

Note

The PreloadAsync method allows you to preload lightweight theme resources only. Use the PreloadThemeResourceAsync method instead to asynchronously preload regular theme resources.

The following code sample asynchronously preloads Data Grid and Layout Control theme resources:

App.xaml.cs

using DevExpress.Xpf.Core;
using System.Windows;

public partial class App : Application {
    static App() {
        CompatibilitySettings.UseLightweightThemes = true;
    }
    protected override async void OnStartup(StartupEventArgs e) {
        base.OnStartup(e);
        await ApplicationThemeHelper.PreloadAsync(PreloadCategories.Grid, PreloadCategories.LayoutControl);
    }
}

App.xaml.vb

Imports DevExpress.Xpf.Core
Imports System.Windows

Public Partial Class App
    Inherits Application

    Private Shared Sub New()
        CompatibilitySettings.UseLightweightThemes = True
    End Sub

    Protected Overrides Async Sub OnStartup(ByVal e As StartupEventArgs)
        MyBase.OnStartup(e)
        Await ApplicationThemeHelper.PreloadAsync(PreloadCategories.Grid, PreloadCategories.LayoutControl)
    End Sub
End Class

Refer to the following help topic for more information: Preload Theme Resources.