System.Windows.Forms
2.0.0.0
System.Windows.Forms.ToolStripControlHost
System.ComponentModel.DefaultProperty("Value")
is the optimized for hosting in a . A subset of the hosted control's properties and events are exposed at the level, but the underlying control is fully accessible through the property.
A control visually indicates the progress of a lengthy operation. The control displays a bar that fills in from left to right with the system highlight color as an operation progresses.
The control can only be oriented horizontally.
The control is typically used when an application performs tasks such as copying files or printing documents. Users of an application might consider an application unresponsive if there is no visual cue. Use the to notify the user that the application is performing a lengthy task and that the application is still responding.
The and properties define the range of values to represent the progress of a task. The property is typically set to a value of zero, and the property is typically set to a value indicating the completion of a task. For example, to display the progress properly when copying a group of files, the property could be set to the total number of files to be copied. The property represents the progress that the application has made toward completing the operation. Because the bar displayed in the control is a collection of blocks, the value displayed by the only approximates the property's current value. Based on the size of the , the property determines when to display the next block.
There are a number of ways to modify the value displayed by the other than changing the property directly. You can use the property to specify a specific value to increment the property by, and then call the method to increment the value. To vary the increment value, you can use the method and specify a value by which to increment the property.
replaces the older control, which is nevertheless retained for backward compatibility.
Represents a Windows progress bar control contained in a .
Constructor
By default, the property is set to 0, the property is set to 100, and the property is set to 10.
Initializes a new instance of the class.
2.0.0.0
Constructor
To be added.
Initializes a new instance of the class with specified name.
The name of the .
2.0.0.0
Property
2.0.0.0
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.Browsable(false)
System.Drawing.Image
To be added.
This property is not relevant to this class.
This property is not relevant to this class.
Property
2.0.0.0
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.Browsable(false)
System.Windows.Forms.ImageLayout
To be added.
This property is not relevant to this class.
This property is not relevant to this class.
Property
2.0.0.0
System.Windows.Forms.Padding
To be added.
To be added.
Gets the spacing between the and adjacent items.
Property
System.Drawing.Size
To be added.
To be added.
Gets the height and width of the in pixels.
2.0.0.0
Method
System.Void
The method enables you to increment the value of the progress bar by a specific amount. This method of incrementing the progress bar is similar to using the property with the method. The property specifies the current position of the . If, after calling the method, the property is greater than the value of the property, the property remains at the value of the property. If, after calling the method with a negative value specified in the parameter, the property is less than the value of the property, the property remains at the value of the property.
Advances the current position of the progress bar by the specified amount.
The amount by which to increment the progress bar's current position.
2.0.0.0
Event
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.Browsable(false)
System.Windows.Forms.KeyEventHandler
This event is not relevant for this class.
This event is not relevant for this class.
2.0.0.0
Event
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.Browsable(false)
System.Windows.Forms.KeyPressEventHandler
This event is not relevant for this class.
This event is not relevant for this class.
2.0.0.0
Event
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.Browsable(false)
System.Windows.Forms.KeyEventHandler
This event is not relevant for this class.
This event is not relevant for this class.
2.0.0.0
Event
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.Browsable(false)
System.EventHandler
This event is not relevant for this class.
This event is not relevant for this class.
2.0.0.0
Property
2.0.0.0
System.ComponentModel.DefaultValue(100)
System.Int32
To be added.
The property gets or sets the delay of display update. Therefore, as you decrease the value of the property, the speed of the animation increases.
Gets or sets a value representing the delay between each display update, in milliseconds.
Property
System.ComponentModel.RefreshProperties(System.ComponentModel.RefreshProperties.Repaint)
System.ComponentModel.DefaultValue(100)
System.Int32
To be added.
This property specifies the upper limit of the property. When the value of the property is changed, the control is redrawn to reflect the new range of the control. When the value of the property is equal to the value of the property, the progress bar is completely filled.
You can use this property to specify a value that the property must be set to (by setting the property or using the or methods) to indicate that an operation is complete. For example, you can set the value of the property to the total number of files in a file copy operation. Each time a file is copied, the property can be increased by one until the total number of files is copied. At that point, the progress bar would be completely filled.
Gets or sets the upper bound of the range that is defined for this .
2.0.0.0
Property
System.ComponentModel.RefreshProperties(System.ComponentModel.RefreshProperties.Repaint)
System.ComponentModel.DefaultValue(0)
System.Int32
To be added.
This property specifies the lower limit of the property. When the value of the property is changed, the control is redrawn to reflect the new range of the control. When the value of the property is equal to the value of the property, the progress bar is empty. To change the value of the progress bar, use the property with the method, use the method, or set the value of the property directly.
Gets or sets the lower bound of the range that is defined for this .
2.0.0.0
Method
2.0.0.0
System.Void
Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.
The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.
Raises the event.
An that contains the event data.
Method
System.Void
To be added.
To be added.
To be added.
2.0.0.0
Method
System.Void
To be added.
To be added.
To be added.
2.0.0.0
Event
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.Browsable(false)
System.EventHandler
This event is not relevant for this class.
This event is not relevant for this class.
2.0.0.0
Method
System.Void
The method increments the value of the progress bar by the amount specified by the property. You can use the property to specify the amount that each completed task in an operation changes the value of the progress bar. For example, if you are copying a group of files, you might want to set the value of the property to 1 and the value of the property to the total number of files to copy. When each file is copied, you can call the method to increment the progress bar by the value of the property. If you want to have more flexible control of the value of the progress bar, you can use the method or set the value of the property directly.
The property specifies the current position of the . If, after calling the method, the property is greater than the value of the property, the property remains at the value of the property. If, after calling the method with a negative value specified in the parameter, the property is less than the value of the property, the property remains at the value of the property.
Advances the current position of the progress bar by the amount of the property.
2.0.0.0
Property
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
System.ComponentModel.Browsable(false)
System.Windows.Forms.ProgressBar
To be added.
This is a strongly typed accessor for this .
Gets the .
2.0.0.0
Property
2.0.0.0
System.ComponentModel.DefaultValue(false)
System.ComponentModel.Localizable(true)
System.Boolean
To be added.
Use the property to control the layout of international applications in which the language is written from right to left. When the property is true, and the property is set to , mirroring will be enabled on the Windows form and control placement and text will be from right to left.
Gets or sets a value indicating whether the layout is right-to-left or left-to-right when the property is set to .
Event
2.0.0.0
System.EventHandler
For more information about handling events, see Consuming Events.
Occurs when the value of the property changes.
Property
System.ComponentModel.DefaultValue(10)
System.Int32
To be added.
To be added.
Gets or sets the amount by which to increment the current value of the when the method is called.
2.0.0.0
Property
System.ComponentModel.DefaultValue(System.Windows.Forms.ProgressBarStyle.Blocks)
System.Windows.Forms.ProgressBarStyle
To be added.
To be added.
Gets or sets the style of the .
2.0.0.0
Property
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.Browsable(false)
System.String
To be added.
Although the has a property, no text is shown on the control.
Gets or sets the text displayed on the .
2.0.0.0
Event
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.Browsable(false)
System.EventHandler
This event is not relevant for this class.
This event is not relevant for this class.
2.0.0.0
Event
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.Browsable(false)
System.EventHandler
This event is not relevant to this class.
This event is not relevant to this class.
2.0.0.0
Event
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.Browsable(false)
System.ComponentModel.CancelEventHandler
This event is not relevant to this class.
This event is not relevant to this class.
2.0.0.0
Property
System.ComponentModel.DefaultValue(0)
System.ComponentModel.Bindable(true)
System.Int32
To be added.
The property must be in the range specified by the and properties.
Gets or sets the current value of the .
2.0.0.0