====== jProgress ======

The [[https://api.comfiletech.com/csharp/api/ComfileTech.jControls.jProgress.html|jProgress]] control is analogous the .NET Framework's [[https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.progressbar|ProgressBar]], but has a much more rich appearance, employing jControls' [[jcontrols:fills_and_borders:index|fill, border]], [[jcontrols:shape_and_cornerradii:index|shape, corner radii]], [[jcontrols:gloss_and_dropshadow:index#dropshadow_property|drop shadow]], and [[jcontrols:text_features:index|text features]], along with a few additional features.

===== Orientation Property =====

The [[https://api.comfiletech.com/csharp/api/ComfileTech.jControls.jProgress.Orientation.html#ComfileTech_jControls_jProgress_Orientation|Orientation]] property is used to orient the control horizontally over vertically.

| {{jprogress_horizontal.png}}   |  {{jprogress_horizontal_properties.png}}  |
|  {{:jprogress_vertical.png}}  |   {{jprogress_vertical_properties.png}} |

===== Bar Property =====

The [[https://api.comfiletech.com/csharp/api/ComfileTech.jControls.jProgress.Bar.html#ComfileTech_jControls_jProgress_Bar|Bar]] property is used to customize the appearance of the part of the control that indicates progress.

{{ https://downloads.comfiletech.com/jControls/videos/jprogress_bar.mp4?900x534 }}
===== Track Property =====

The [[https://api.comfiletech.com/csharp/api/ComfileTech.jControls.jProgress.Track.html#ComfileTech_jControls_jProgress_Track|Track]] property is used to customize the appearance of the track that the bar travels along.

{{ https://downloads.comfiletech.com/jControls/videos/jprogress_track.mp4?900x531 }}

===== Minimum Property =====
The [[https://api.comfiletech.com/csharp/api/ComfileTech.jControls.jRangeControl.Minimum.html#ComfileTech_jControls_jRangeControl_Minimum|Minimum]] property sets the lower bound of the [[#value_property|Value]] property.

===== Maximum Property =====
The [[https://api.comfiletech.com/csharp/api/ComfileTech.jControls.jRangeControl.Maximum.html#ComfileTech_jControls_jRangeControl_Maximum|Maximum]] property sets the upper bound of the [[#value_property|Value]] property.

===== Text Property =====
The [[https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.control.text|Text]] property is a [[https://learn.microsoft.com/en-us/dotnet/standard/base-types/custom-numeric-format-strings|.NET format string]] that specifies the text to display on the control.  The only argument, ''{0}'', is the value of the [[#value_property|Value]] property.  The characters after the '':'' define the format.

|{{jprogress_text1.png }}|{{jprogress_text1_properties.png }}|
|{{jprogress_text2.png }}|{{jprogress_text2_properties.png }}|
|{{jprogress_text3.png }}|{{jprogress_text3_properties.png }}|

===== Value Property =====
The [[https://api.comfiletech.com/csharp/api/ComfileTech.jControls.jRangeControl.Value.html#ComfileTech_jControls_jRangeControl_Value|Value]] property gets or sets the length progress bar.  The value will be clipped if attempting to set it outside of the range specified by the [[#minimum_property|Minimum]] property and the [[#maximum_property|Maximum]] property.



===== ValueChanged Event =====
The [[https://api.comfiletech.com/csharp/api/ComfileTech.jControlsNF4.jRangeControl.ValueChanged.html|ValueChanged]] event fires any time the [[#value_property|Value]] property changes.