ClassProgressBarPrimitive
Represents a primitive element that renders progress bars with support for various styles, orientations, and customization options.
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
ProgressBarPrimitive()
Declaration
public ProgressBarPrimitive()
Fields
ProgressOrientationProperty
Declaration
public static RadProperty ProgressOrientationProperty
Field Value
SeparatorColorProperty1
Declaration
public static RadProperty SeparatorColorProperty1
Field Value
SeparatorColorProperty2
Declaration
public static RadProperty SeparatorColorProperty2
Field Value
SeparatorWidthProperty
Declaration
public static RadProperty SeparatorWidthProperty
Field Value
Properties
Dash
Indicates whether the progress bar style is dash. If both dash and hash are true, hatch style is chosen.
HasImage
Gets or sets a value indicating whether the progress bar has an associated image.
Declaration
public bool HasImage { get; set; }
Property Value
true if the progress bar displays an image; otherwise, false.
Remarks
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.
Hatch
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.
Maximum
Gets or sets maximum value for the progress.
Minimum
Specifies minimum value for the progress.
Orientation
Gets or sets progress bar orientation. Possible values are indicates in ProgressOrientaion enumeration: up, left, bottom, and right.
Declaration
public virtual ProgressOrientation Orientation { get; set; }
Property Value
SeparatorColor1
Gets or sets the first color that is used in gradient effect.
Declaration
public virtual Color SeparatorColor1 { get; set; }
Property Value
SeparatorColor2
Gets or sets the second color that is used in gradient effect.
Declaration
public virtual Color SeparatorColor2 { get; set; }
Property Value
SeparatorWidth
Gets or sets separators width in pixels.
Step
Gets or sets the step value used for discrete progress increments.
Declaration
public virtual int Step { get; set; }
Property Value
An integer value representing the increment amount for step-based progress updates.
Remarks
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.
StepWidth
Gets or sets the step width in pixels between separators.
SweepAngle
Gets or sets the angle in degrees of the progress bar dash or hatch parts.
Value1
Gets or sets the value of the first progress line. There could be two progress lines in the progress bar.
Methods
ArrangeOverride(SizeF)
Arranges the RadElement to its final location. The element must call the Arrange method of each of its children.
Declaration
protected override SizeF ArrangeOverride(SizeF finalSize)
Parameters
finalSize
The size that is available for element.
Returns
The rectangle occupied by the element. Usually finalSize. Should you return different size, the Layout system will restart measuring and rearranging the items. That could lead to infinite recursion.
Overrides
Remarks
In this method call to the Arrange method of each child must be made.
PaintPrimitive(IGraphics, float, SizeF)
Draws the primitive on the screen.