Version

Displaying Text on Activity Indicator

Topic Overview

Purpose

This topic provides an overview of displaying text on the activity indicator with animation enabled or started.

Required background

The following topic is a prerequisite to understanding this topic:

Topic Purpose

The topics in this section will give you a better idea of why you would want to use WinActivityIndicator in your applications.

Displaying Text on WinActivityIndicator

Introduction and preview

Prior to the product release of 13.1, the WinActivityIndicator™ did not display text while the activity indicator was in progress only displaying the animation indicating the ongoing activity. The following screenshot captures the started and stopped animation with the displayed text “ Please wait while processing… ” and “stopped”.

Animation started.

WinActivityIndicator Displaying Text on Activity Indicator 1.png

Animation stopped.

WinActivityIndicator Displaying Text on Activity Indicator 2.png
Note
Note:

The control’s UseOsThemes property is turned Off by default. If you turn it On, it will overlay the animation text.

Property settings

The WinActivityIndicator control exposes two properties, Text and AnimationEnabledText. The Text property displays the text when animation is not in progress while the AnimationEnabledText property displays the text when animation is in progress.

The following scenarios cover the text resolution process:

  1. When AnimationEnabled = True

    • The control displays the AnimationEnabledText property’s value, if it is not null or empty.

    • The control displays the Text property’s value if the AnimationEnabledText property is null or empty.

  2. When AnimationEnabled = False

    • The control displays the Text property’s value.

You can set the properties in code or via the Visual Studio design view.

In C#:

ultraActivityIndicator1.Text = "Stopped";
ultraActivityIndicator1.AnimationEnabledText = "Please wait while processing...";

In Visual Basic:

ultraActivityIndicator1.Text = "Stopped"
ultraActivityIndicator1.AnimationEnabledText = "Please wait while processing..."

Related Content

Topics

The following topic provides additional information related to this topic.

Topic Purpose

In this section, you will find short, task-based topics that explain how to perform a specific task related to the WinActivityIndicator control.