Class
RadBusyIndicator

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:

cs-api-definition
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.

Declaration

cs-api-definition
public RadBusyIndicator()

Fields

AnimationContentColorProperty

Identifies the AnimationContentColor bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty AnimationContentColorProperty

Field Value

BindableProperty

AnimationContentHeightRequestProperty

Identifies the AnimationContentHeightRequest bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty AnimationContentHeightRequestProperty

Field Value

BindableProperty

AnimationContentWidthRequestProperty

Identifies the AnimationContentWidthRequest bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty AnimationContentWidthRequestProperty

Field Value

BindableProperty

AnimationTypeProperty

Identifies the AnimationType bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty AnimationTypeProperty

Field Value

BindableProperty

BusyContentProperty

Identifies the BusyContent bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty BusyContentProperty

Field Value

BindableProperty

BusyContentTemplateProperty

Identifies the BusyContentTemplate bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty BusyContentTemplateProperty

Field Value

BindableProperty

ContentProperty

Identifies the Content bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty ContentProperty

Field Value

BindableProperty

ContentUnderOpacityProperty

Identifies the ContentUnderOpacity bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty ContentUnderOpacityProperty

Field Value

BindableProperty

IsBusyProperty

Identifies the IsBusy bindable property.

Declaration

cs-api-definition
public static readonly BindableProperty IsBusyProperty

Field Value

BindableProperty

Properties

AnimationContentColor

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.

Declaration

cs-api-definition
public Color AnimationContentColor { get; set; }

Property Value

Color

AnimationContentHeightRequest

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.

Declaration

cs-api-definition
public double AnimationContentHeightRequest { get; set; }

Property Value

double

AnimationContentWidthRequest

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.

Declaration

cs-api-definition
public double AnimationContentWidthRequest { get; set; }

Property Value

double

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.

Declaration

cs-api-definition
public AnimationType AnimationType { get; set; }

Property Value

AnimationType

Animations

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.

Declaration

cs-api-definition
public Collection<RadAnimation> Animations { get; }

Property Value

Collection<RadAnimation>

BusyContent

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.

Declaration

cs-api-definition
public View BusyContent { get; set; }

Property Value

View

BusyContentTemplate

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.

Declaration

cs-api-definition
public ControlTemplate BusyContentTemplate { get; set; }

Property Value

ControlTemplate

Content

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.

Declaration

cs-api-definition
public View Content { get; set; }

Property Value

View

ContentUnderOpacity

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.

Declaration

cs-api-definition
public double ContentUnderOpacity { get; set; }

Property Value

double

IsBusy

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.

Declaration

cs-api-definition
public bool IsBusy { get; set; }

Property Value

bool

Methods

CreateLayoutManager()

Creates the layout manager for this layout.

Declaration

cs-api-definition
protected override ILayoutManager CreateLayoutManager()

Returns

ILayoutManager

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

Overrides RadLayout.CreateLayoutManager()

OnBindingContextChanged()

Declaration

cs-api-definition
protected override void OnBindingContextChanged()