ProgressBarPrimitive
Represents a primitive element that renders progress bars with support for various styles, orientations, and customization options.
ProgressBarPrimitive extends FillPrimitive to provide comprehensive progress bar rendering capabilities, including linear and circular progress indicators, stepped progress display, and dual-value range support. It supports both determinate and indeterminate progress visualization modes.
The primitive supports various visual styles including gradient fills, custom separators, dash patterns, and different orientations. It can render progress with customizable minimum/maximum ranges and step values, making it suitable for complex progress tracking scenarios.
ProgressBarPrimitive is commonly used in progress controls, loading indicators, status displays, and any UI element requiring visual progress feedback to users.
Definition
Namespace:Telerik.WinControls.Primitives
Assembly:Telerik.WinControls.dll
Syntax:
public class ProgressBarPrimitive : FillPrimitive, IDisposable, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IStylableNode, IPrimitive, IFillElement, IPrimitiveElement, IShapedElement
Inheritance: objectDisposableObjectRadObjectRadElementVisualElementBasePrimitiveFillPrimitiveProgressBarPrimitive...
Implements:
Inherited Members
Constructors
public ProgressBarPrimitive()
Fields
Identifies whether diagonal separator stripes are drawn over the primary progress fill.
public static RadProperty DashProperty
Identifies whether the separator pattern also draws its opposing diagonal stripes.
public static RadProperty HatchProperty
Identifies the upper bound of the progress value range.
public static RadProperty MaximumProperty
Identifies the lower bound of the progress value range.
public static RadProperty MinimumProperty
Identifies the direction from which the progress fill advances.
public static RadProperty ProgressOrientationProperty
Identifies the first color used to shade the separator stripes.
public static RadProperty SeparatorColorProperty1
Identifies the second color used to shade the separator stripes.
public static RadProperty SeparatorColorProperty2
Identifies the width of diagonal separator stripes.
public static RadProperty SeparatorWidthProperty
Identifies the setting that stores the step amount; its default is 10.
public static RadProperty StepProperty
Identifies the spacing between diagonal separator stripes.
public static RadProperty StepWidthProperty
Identifies the angle, in degrees, of the diagonal separator stripes.
public static RadProperty SweepAngleProperty
Identifies the primary progress value used to calculate the filled rectangle.
public static RadProperty ValueProperty1
Identifies the secondary progress value used to draw a translucent fill beneath the primary fill.
public static RadProperty ValueProperty2
Properties
Indicates whether the progress bar style is dash. If both dash and hash are true, hatch style is chosen.
public virtual bool Dash { get; set; }
Gets or sets a value indicating whether the progress bar has an associated image.
public bool HasImage { get; set; }
true if the progress bar displays an image; otherwise, false.
When set to
true, this property indicates that the progress bar should consider image rendering in its layout and painting operations. This affects how the progress bar calculates its visual representation and may influence spacing and alignment.
Indicates whether the progress bar style is hatch. When true, the style is Hatch. When both dash and hatch are true the style is hatch.
public virtual bool Hatch { get; set; }
Gets or sets progress bar orientation. Possible values are indicates in ProgressOrientaion enumeration: up, left, bottom, and right.
public virtual ProgressOrientation Orientation { get; set; }
Gets or sets the first color that is used in gradient effect.
public virtual Color SeparatorColor1 { get; set; }
Gets or sets the second color that is used in gradient effect.
public virtual Color SeparatorColor2 { get; set; }
Gets or sets separators width in pixels.
public virtual int SeparatorWidth { get; set; }
Gets or sets the step value used for discrete progress increments.
public virtual int Step { get; set; }
An integer value representing the increment amount for step-based progress updates.
The step value determines the amount by which the progress value increases when using step-based progress updates. This is useful for operations that complete in discrete, measurable increments rather than continuous progress.
Gets or sets the step width in pixels between separators.
public virtual int StepWidth { get; set; }
Gets or sets the angle in degrees of the progress bar dash or hatch parts.
public virtual int SweepAngle { get; set; }
Gets or sets the value of the first progress line. There could be two progress lines in the progress bar.
public virtual int Value1 { get; set; }
Methods
Updates the child border bounds to reflect the primary progress value for left-oriented progress.
Gets the primary progress rectangle calculated during the most recent paint operation.