Copyright © 2003-2010 MultiMedia Soft

How to use the Progress Bar component

Previous pageReturn to chapter overviewNext page

As you can see on the screenshots below, with 3D Control Magic you have the possibility to create enhanced Progress Bars with several graphical options that will allow a perfect integration into modern user interfaces.

3dcm_i0001a0

All you have to do is to place a Ctl3dProgressBar control control into your form

Then you should define the range of supported values inside the Minimum and Maximum properties: if for example you are going to display a percentage advancement, you will set these properties to 0 and 100 respectively. The current value can be set through the Value property.

 

Differently from the standard .NET progress bar, the control can not only have a horizontal but can also have a vertical and a radial evolution; furthermore, you can decide the direction of the progress evolution through the ProgressBarType property.

 

You can manage the color of the portion of the progress bar's surface still not covered by the advancement (the green area on the screenshot above) through the ProgressBarColor property; last but not least, if the control has been set to display a special effect, as seen in the screenshot above, you can decide on which portion of the control the progress bar will graphically evolve through the ProgressBarFillMode property.

 

Just for curiosity, an alternative way to simulate a progress bar is through the use of cells: you simply need adding a single cell, set its look and reposition it as needed as seen on the screenshot below:

3dcm_i0001a1

Details about the setup of cells can be found inside the How to manage cells tutorial.

 

The simplest way to change colors and options applied to the Progress Bar style is to use, inside 3D Button Visual Editor, the Progress Bar tab. At run-time each of these properties can be referenced by name.

Note: The images below have hot links to take you to explanations of the various button settings.

3dcm_i0001a2

 

 

 

Item name

Description

Corresponding property


Type

The type of progress bar

ProgressBarType


Fill mode

The fill mode when the SpecialEffect property has been set to a value different from SPECIAL_EFFECT_NONE.

ProgressBarFillMode


Color

The color used to render the portion of the progress bar's surface still not covered by the advancement.

ProgressBarColor


Min value

The control's minimum value

Minimum


Max Value

The control's maximum value

Maximum


Value

The current value

Value


Apply button

Applies displayed values to the control