New to Telerik UI for .NET MAUI? Start a free 30-day trial

RadBusyIndicator

Class

Represents a sophisticated loading indicator control that provides visual feedback to users during long-running operations. The RadBusyIndicator offers a rich collection of built-in animations and extensive customization options to create engaging loading experiences that keep users informed and engaged while content is being processed.

Definition

Namespace:Telerik.Maui.Controls

Assembly:Telerik.Maui.Controls.dll

Syntax:

public class RadBusyIndicator : RadLayout

Inheritance: objectRadLayoutRadBusyIndicator

Derived Classes: TreeViewItemBusyIndicator

Constructors

RadBusyIndicator()

Initializes a new instance of the RadBusyIndicator class with default settings. Creates a ready-to-use busy indicator with platform-optimized default animation and styling.

public RadBusyIndicator()

Fields

AnimationContentColorProperty

BindableProperty

Identifies the AnimationContentColor bindable property.

public static readonly BindableProperty AnimationContentColorProperty

AnimationContentHeightRequestProperty

BindableProperty

Identifies the AnimationContentHeightRequest bindable property.

public static readonly BindableProperty AnimationContentHeightRequestProperty

AnimationContentWidthRequestProperty

BindableProperty

Identifies the AnimationContentWidthRequest bindable property.

public static readonly BindableProperty AnimationContentWidthRequestProperty

AnimationTypeProperty

BindableProperty

Identifies the AnimationType bindable property.

public static readonly BindableProperty AnimationTypeProperty

BusyContentProperty

BindableProperty

Identifies the BusyContent bindable property.

public static readonly BindableProperty BusyContentProperty

BusyContentTemplateProperty

BindableProperty

Identifies the BusyContentTemplate bindable property.

public static readonly BindableProperty BusyContentTemplateProperty

ContentProperty

BindableProperty

Identifies the Content bindable property.

public static readonly BindableProperty ContentProperty

ContentUnderOpacityProperty

BindableProperty

Identifies the ContentUnderOpacity bindable property.

public static readonly BindableProperty ContentUnderOpacityProperty

IsBusyProperty

BindableProperty

Identifies the IsBusy bindable property.

public static readonly BindableProperty IsBusyProperty

Properties

AnimationContentColor

Color

Gets or sets the color of the animation content elements. This property allows you to customize the visual appearance of the loading animation to match your application's theme and branding.

public Color AnimationContentColor { get; set; }

AnimationContentHeightRequest

double

Gets or sets the requested height of the animation content in device-independent units. This property controls the vertical size of the animated loading indicator. Use -1 for automatic sizing based on the animation type.

public double AnimationContentHeightRequest { get; set; }

AnimationContentWidthRequest

double

Gets or sets the requested width of the animation content in device-independent units. This property controls the horizontal size of the animated loading indicator. Use -1 for automatic sizing based on the animation type.

public double AnimationContentWidthRequest { get; set; }

Animations

Collection<RadAnimation>

Gets a collection of custom RadAnimation objects used when AnimationType is set to Custom. Add multiple RadAnimation objects to create complex, layered animations with combined effects like rotation, scaling, and translation.

public Collection<RadAnimation> Animations { get; }

AnimationType

Gets or sets the animation style used to display the loading indicator. Choose from 10 built-in animation types (Animation1-Animation10) or use Custom to define your own animations through the Animations collection.

public AnimationType AnimationType { get; set; }

BusyContent

View

Gets or sets the custom content displayed alongside the loading animation when the indicator is in a busy state. Use this property to show informative messages, progress details, or any custom UI elements during loading operations.

public View BusyContent { get; set; }

BusyContentTemplate

ControlTemplate

Gets or sets the control template used to define the layout and appearance of the busy content. This template provides complete control over how the busy state is presented, allowing for sophisticated loading screens and layouts.

public ControlTemplate BusyContentTemplate { get; set; }

Content

View

Gets or sets the main content that is displayed when the busy indicator is not in a busy state. This content is automatically managed by the control, being dimmed or hidden based on the IsBusy state and ContentUnderOpacity settings.

public View Content { get; set; }

ContentUnderOpacity

double

Gets or sets the opacity level applied to the Content when IsBusy is true. Use values from 0.0 (completely transparent) to 1.0 (fully opaque) to control how much the underlying content is dimmed during loading.

public double ContentUnderOpacity { get; set; }

IsBusy

bool

Gets or sets a value indicating whether the busy indicator is currently in a busy state. When true, the loading animation and busy content are displayed while the main content is dimmed or hidden according to ContentUnderOpacity.

public bool IsBusy { get; set; }

Methods

CreateLayoutManager()

ILayoutManager

Creates the layout manager for this layout.

protected override ILayoutManager CreateLayoutManager()

Returns:

ILayoutManager

An instance of RadLayoutManager that manages the layout of child elements.

Overrides: RadLayout.CreateLayoutManager()

OnBindingContextChanged()

protected override void OnBindingContextChanged()