Foreground Settings in Windows Forms Progress Bar (ProgressBarAdv)

This section discusses the foreground settings of the ProgressBarAdv control.

Foreground segment settings

The foreground segment settings available in the ProgressBarAdv control are explained below.

The foreground of the ProgressBarAdv can be displayed with a segmented appearance using the property given below.

Property table

ProgressBarAdv property Description
ForeSegments Determines if the foreground is segmented.

By default this property will be set to true. To set it to false, use the code snippet given below.

this.progressBarAdv1.ForeSegments = false;
Me.progressBarAdv1.ForeSegments = False

Segment width

The foreground segments can be customized using the property given below.

Property table

ProgressBarAdv property Description
SegmentWidth Specifies the width of the segments.
this.progressBarAdv1.SegmentWidth = 20;
Me.progressBarAdv1.SegmentWidth = 20

Foreground color settings

This section illustrates the color settings that can be applied to the foreground of the ProgressBarAdv.

Font and fore color settings

The font color and the fore color can be set using the properties given below.

Property table

ProgressBarAdv property Description
ForeColor Specifies the color used to draw the foreground in segment mode and constant mode.
FontColor Specifies the color of the font used to draw the text of the ProgressBarAdv.
this.progressBarAdv1.FontColor = System.Drawing.Color.SteelBlue;

this.progressBarAdv1.ForeColor = System.Drawing.Color.Turquoise;
Me.progressBarAdv1.FontColor = System.Drawing.Color.SteelBlue

Me.progressBarAdv1.ForeColor = System.Drawing.Color.Turquoise

Gradient color settings

The color of the foreground gradient can be changed using the properties given below.

Property table

ProgressBarAdv property Description
GradientStartColor Specifies the start color of the foreground gradient.The ProgressStyle property should be set to 'Gradient'.
GradientEndColor Specifies the start color of the foreground gradient.The ProgressStyle property should be set to 'Gradient'.
this.progressBarAdv1.GradientEndColor = System.Drawing.Color.Yellow;

this.progressBarAdv1.GradientStartColor = System.Drawing.Color.OrangeRed;
Me.progressBarAdv1.GradientEndColor = System.Drawing.Color.Yellow

Me.progressBarAdv1.GradientStartColor = System.Drawing.Color.OrangeRed

The foreground can be displayed with multiple colors using the property given below.

Property table

ProgressBarAdv property Description
MultipleColors Specifies the array of colors used to draw the multiple gradient of the foreground.The ProgressStyle property should be set to 'MultipleGradient'.
StretchMultiGrad Determines if the multiple gradient will be stretched.
this.progressBarAdv1.ProgressStyle = Syncfusion.Windows.Forms.Tools.ProgressBarStyles.MultipleGradient;

this.progressBarAdv1.MultipleColors = new System.Drawing.Color[] {System.Drawing.Color.Orange, System.Drawing.Color.Yellow, System.Drawing.Color.Blue, System.Drawing.Color.Pink, System.Drawing.Color.Green};

this.progressBarAdv1.StretchMultGrad = false;
Me.progressBarAdv1.ProgressStyle = Syncfusion.Windows.Forms.Tools.ProgressBarStyles.MultipleGradient

Me.progressBarAdv1.MultipleColors = New System.Drawing.Color[] {System.Drawing.Color.Orange, System.Drawing.Color.Yellow, System.Drawing.Color.Blue, System.Drawing.Color.Pink, System.Drawing.Color.Green};

Me.progressBarAdv1.StretchMultGrad = False

Tube color settings

Colors can be set for the foreground tube of the ProgressBarAdv.

Property table

ProgressBarAdv property Description
TubeStartColor Specifies the start color of the foreground tube.The ProgressStyle property should be set to 'Tube'.
TubeEndColor Specifies the start color of the foreground tube.The ProgressStyle property should be set to 'Tube'.
this.progressBarAdv1.TubeEndColor = System.Drawing.Color.Black;

this.progressBarAdv1.TubeStartColor = System.Drawing.Color.Red;
Me.progressBarAdv1.TubeEndColor = System.Drawing.Color.Black

Me.progressBarAdv1.TubeStartColor = System.Drawing.Color.Red

Foreground image settings

This section discusses the foreground image settings of ProgressBarAdv.

When the BackgroundStyle and ProgressStyle are set to the ‘Image’ style, then the foreground image can be specified using the below given property.

Property table

ProgressBarAdv property Description
ForegroundImage Determines if the foreground is segmented.
StretchImage Indicates whether the foreground image will be stretched.
this.progressBarAdv1.ForegroundImage = ((System.Drawing.Image)(resources.GetObject("clouds")));

this.progressBarAdv1.StretchImage = true;
Me.progressBarAdv1.ForegroundImage = CType((resources.GetObject("clouds")), System.Drawing.Image)

Me.progressBarAdv1.StretchImage = True

Foreground style settings

The progress style of the ProgressBarAdv control can be set using the properties given below.

Property table

ProgressBarAdv property Description
ProgressStyle Determines the foreground drawing style. It includes the options given below.Constant, Gradient, MultipleGradient, Tube, Image, System, Metro, Office2016Colorful, Office2016White, Office2016darkGray and Office2016Black.
ProgressFallBackStyle Determines the foreground drawing style when the ProgressStyle is set to 'System', provided the system doesn't support themes.
this.progressBarAdv1.ProgressStyle = Syncfusion.Windows.Forms.Tools.ProgressBarStyles.WaitingGradient;

this.progressBarAdv1.ProgressFallbackStyle = Syncfusion.Windows.Forms.Tools.ProgressBarStyles.MultipleGradient;
Me.progressBarAdv1.ProgressStyle = Syncfusion.Windows.Forms.Tools.ProgressBarStyles.WaitingGradient

Me.progressBarAdv1.ProgressFallbackStyle = Syncfusion.Windows.Forms.Tools.ProgressBarStyles.MultipleGradient;

The Waiting Gradient Style of the ProgressBarAdv consists of the following properties that can be used to change the appearance and behavior of the style.

Property table

ProgressBarAdv property Description
WaitingGradientEnabled Determines if the waiting gradient is enabled.The ProgressStyle property should be set to 'WaitingGradient'.
WaitingGradientInterval Determines the interval of the waiting gradient.
WaitingGradientWidth Determines the width of the waiting gradient.
CustomWaitingRender Indicates whether the waiting gradient will be replaced by another custom waiting render which is defaulted to segments.This property when set to `true` will display the foreground with segments in the color that has been set for the ForeColor property.This property when set to `false` will display the foreground in the default waiting gradient style.
this.progressBarAdv1.WaitingGradientEnabled = true;

this.progressBarAdv1.WaitingGradientInterval = 20;

this.progressBarAdv1.WaitingGradientWidth = 500;

this.progressBarAdv1.CustomWaitingRender = true;

this.progressBarAdv1.ForeColor = System.Drawing.Color.Crimson;
Me.progressBarAdv1.WaitingGradientEnabled = True

Me.progressBarAdv1.WaitingGradientInterval = 20

Me.progressBarAdv1.WaitingGradientWidth = 500

Me.progressBarAdv1.CustomWaitingRender = True

Me.progressBarAdv1.ForeColor = System.Drawing.Color.Crimson

Metro

This option helps to set the metro theme.

this.progressBarAdv1.ProgressStyle = Syncfusion.Windows.Forms.Tools.ProgressBarStyles.Metro;
Me.progressBarAdv1.ProgressStyle = Syncfusion.Windows.Forms.Tools.ProgressBarStyles.Metro;

Office2016Colorful

This option helps to set the Office2016Colorful appearance.

this.progressBarAdv1.ProgressStyle = Syncfusion.Windows.Forms.Tools.ProgressBarStyles.Office2016Colorful;
Me.progressBarAdv1.ProgressStyle = Syncfusion.Windows.Forms.Tools.ProgressBarStyles.Office2016Colorful;

Office2016White

This option helps to set the Office2016White appearance.

this.progressBarAdv1.ProgressStyle = Syncfusion.Windows.Forms.Tools.ProgressBarStyles.Office2016White;
Me.progressBarAdv1.ProgressStyle = Syncfusion.Windows.Forms.Tools.ProgressBarStyles.Office2016White;

Office2016DarkGray

This option helps to set the Office2016DarkGray appearance.

this.progressBarAdv1.ProgressStyle = Syncfusion.Windows.Forms.Tools.ProgressBarStyles.Office2016DarkGray;
Me.progressBarAdv1.ProgressStyle = Syncfusion.Windows.Forms.Tools.ProgressBarStyles.Office2016DarkGray;

Office2016Black

This option helps to set the Office2016Black appearance.

this.progressBarAdv1.ProgressStyle = Syncfusion.Windows.Forms.Tools.ProgressBarStyles.Office2016Black;
Me.progressBarAdv1.ProgressStyle = Syncfusion.Windows.Forms.Tools.ProgressBarStyles.Office2016Black;