New to Telerik UI for WinFormsStart a free 30-day trial

Properties

Updated over 6 months ago
PropertyDescriptionResult
Image, ImageKey and ImageIndexAllows you manipulate the image displayed in the waiting indicators.WinForms RadWaitingBar Image
IsWaitingIndicates whether the RadWaitingBar is currently waiting.
ShowTextIndicates whether the text in RadWaitingBar is displayed. By default, the text of RadWaitingBar is not displayed. To show it, set the property to true.WinForms RadWaitingBar ShowText
StretchIndicatorsHorizontallyIndicates whether the waiting indicators are stretched horizontally, so that their width equals the available width of the parent element.WinForms RadWaitingBar StretchIndicatorsHorizontally True WinForms RadWaitingBar StretchIndicatorsHorizontally False
StretchIndicatorsVerticallyIndicates whether the waiting indicators are stretched vertically, so that their height equals the available height of the parent element.WinForms RadWaitingBar StretchIndicatorsVertically True WinForms RadWaitingBar StretchIndicatorsVertically False
OrientationThe property is set to Horizontal when the waiting indicator moves horizontally, i.e. the WaitingDirection property is set to Left or Right. The property is set to Vertical when the waiting indicator moves vertically, i.e. the WaitingDirection property is set to Top or Bottom.WinForms RadWaitingBar Orientation Horizontal WinForms RadWaitingBar Orientation Vertical
WaitingDirectionThe property indicates the direction of indicators’ movement.
Right: the indicators move from left to right;
Left: the indicators move from right to left;
Top: the indicators move from bottom to top;
Bottom: the indicators move from top to bottom;
Note that setting WaitingDirection does not change the size of the control. This implies that when you set the property to Bottom or Top, you will need to resize the RadWaitingBar appropriately, i.e. the control height should be larger than its width. Changing the WaitingDirection property affects also the values of the StretchIndicatorsVertically and the StretchIndicatorsHorizontally, unless a local value is assigned to either of the two properties. For example, when the WaitingDirection is Top or Bottom, the StretchIndicatorsVertically is set to false and the StretchIndicatorsHorizontally is set to true automatically. When the WaitingDirection is Right or Left, the StretchIndicatorsVertically is set to true and the StretchIndicatorsHorizontally is set to false.
WinForms RadWaitingBar WaitingDirection Right WinForms RadWaitingBar WaitingDirection Left WinForms RadWaitingBar WaitingDirection TopWinForms RadWaitingBar WaitingDirection Bottom
WaitingIndicatorSizeThe property allows you to set the size of the of the waiting indicatorsWinForms RadWaitingBar WaitingIndicatorSize
WaitingIndicatorWidthThe property is obsolete. Currently, it sets the WaitingIndicatorSize.Width
WaitingSpeedThe property sets the speed of the animation. The higher the WaitingSpeed is, the faster the waiting indicators move. WaitingSpeed possible values range from 0 to 100, where 1 sets the slowest indicator and 100 results in the fastest indicator. If the WaitingSpeed is set to 0, the WaitingStopped event is raised and the waiting process terminates. Then, if the WaitingSpeed is set to a value greater than 0, the WaitingStarted event is raised and the waiting animation continues automatically.WinForms RadWaitingBar WaitingSpeed
WaitingStepSets the number of pixels the waiting indicators move during each step of the waiting animation process. If the WaitingStep is set to 0, the WaitingStopped event is raised and the waiting process terminates. Then, if the WaitingStep is set to a value greater than 0, the WaitingStarted event raises and the waiting animation continues automatically.WinForms RadWaitingBar WaitingStep
WaitingStyleSets the style of RadWaitingBar. Read more here: Waiting Styles
AssociatedControlSpecifies the associated control.

Methods

MethodDescription
StartWaiting()Starts the animation.
StopWaiting()Stops the animation.
ResetWaiting()Moves the waiting indicators to their initial position. Resetting the animation after the waiting process has been started will not stop the animation. Respectively, resetting the animation after the waiting process has been stopped will not start the animation.

Events

EventDescription
WaitingStartedFires when the control starts waiting.
WaitingStoppedFires when the control stops waiting.

See Also

In this article
See Also
Not finding the help you need?
Contact Support