VB.Net - ProgressBar Control

It represents a Windows progress bar control. It is used to provide visual feedback to your users about the status of some task. It shows a bar that fills in from left to right as the operation progresses.

Let's click on a ProgressBar control from the Toolbox and place it on the form.

The main properties of a progress bar are Value, Maximum and Minimum. The Minimum and Maximum properties are used to set the minimum and maximum values that the progress bar can display. The Value property specifies the current position of the progress bar.

The ProgressBar control is typically used when an application performs tasks such as copying files or printing documents. To a user the application might look unresponsive if there is no visual cue. In such cases, using the ProgressBar allows the programmer to provide a visual status of progress.

Properties of the ProgressBar Control

The following are some of the commonly used properties of the ProgressBar control −

Sr.No.	Property & Description
1	AllowDrop Overrides Control.AllowDrop.
2	BackgroundImage Gets or sets the background image for the ProgressBar control.
3	BackgroundImageLayout Gets or sets the layout of the background image of the progress bar.
4	CausesValidation Gets or sets a value indicating whether the control, when it receives focus, causes validation to be performed on any controls that require validation.
5	Font Gets or sets the font of text in the ProgressBar.
6	ImeMode Gets or sets the input method editor (IME) for the ProgressBar.
7	ImeModeBase Gets or sets the IME mode of a control.
8	MarqueeAnimationSpeed Gets or sets the time period, in milliseconds, that it takes the progress block to scroll across the progress bar.
9	Maximum Gets or sets the maximum value of the range of the control.v
10	Minimum Gets or sets the minimum value of the range of the control.
11	Padding Gets or sets the space between the edges of a ProgressBar control and its contents.
12	RightToLeftLayout Gets or sets a value indicating whether the ProgressBar and any text it contains is displayed from right to left.
13	Step Gets or sets the amount by which a call to the PerformStep method increases the current position of the progress bar.
14	Style Gets or sets the manner in which progress should be indicated on the progress bar.
15	Value Gets or sets the current position of the progress bar.v

Methods of the ProgressBar Control

The following are some of the commonly used methods of the ProgressBar control −

Sr.No.	Method Name & Description
1	Increment Increments the current position of the ProgressBar control by specified amount.
2	PerformStep Increments the value by the specified step.
3	ResetText Resets the Text property to its default value.
4	ToString Returns a string that represents the progress bar control.

Events of the ProgressBar Control

The following are some of the commonly used events of the ProgressBar control −

Sr.No.	Event & Description
1	BackgroundImageChanged Occurs when the value of the BackgroundImage property changes.
2	BackgroundImageLayoutChanged Occurs when the value of the BackgroundImageLayout property changes.
3	CausesValidationChanged Occurs when the value of the CausesValidation property changes.
4	Click Occurs when the control is clicked.
5	DoubleClick Occurs when the user double-clicks the control.
6	Enter Occurs when focus enters the control.
7	FontChanged Occurs when the value of the Font property changes.
8	ImeModeChanged Occurs when the value of the ImeMode property changes.
9	KeyDown Occurs when the user presses a key while the control has focus.
10	KeyPress Occurs when the user presses a key while the control has focus.
11	KeyUp Occurs when the user releases a key while the control has focus.
12	Leave Occurs when focus leaves the ProgressBar control.
13	MouseClick Occurs when the control is clicked by the mouse.
14	MouseDoubleClick Occurs when the user double-clicks the control.
15	PaddingChanged Occurs when the value of the Padding property changes.
16	Paint Occurs when the ProgressBar is drawn.
17	RightToLeftLayoutChanged Occurs when the RightToLeftLayout property changes.
18	TabStopChanged Occurs when the TabStop property changes.
19	TextChanged Occurs when the Text property changes.

Example

In this example, let us create a progress bar at runtime. Let's double click on the Form and put the follow code in the opened window.

Public Class Form1
   Private Sub Form1_Load(sender As Object, e As EventArgs) _
      Handles MyBase.Load
      'create two progress bars
      Dim ProgressBar1 As ProgressBar
      Dim ProgressBar2 As ProgressBar
      ProgressBar1 = New ProgressBar()
      ProgressBar2 = New ProgressBar()
      'set position
      ProgressBar1.Location = New Point(10, 10)
      ProgressBar2.Location = New Point(10, 50)
      'set values
      ProgressBar1.Minimum = 0
      ProgressBar1.Maximum = 200
      ProgressBar1.Value = 130
      ProgressBar2.Minimum = 0
      ProgressBar2.Maximum = 100
      ProgressBar2.Value = 40
      'add the progress bar to the form
      Me.Controls.Add(ProgressBar1)
      Me.Controls.Add(ProgressBar2)
      ' Set the caption bar text of the form.  
      Me.Text = "tutorialspoint.com"
   End Sub
End Class

When the above code is executed and run using Start button available at the Microsoft Visual Studio tool bar, it will show the following window −

vb.net_basic_controls.htm