Copyright © 1998-2010 MultiMedia Soft

How to use the control as a Progress Bar control

Previous pageReturn to chapter overviewNext page

A Progress Bar control can graphically display the advancement of a lengthy operation.

3dabm_i000197

As you can see on the screenshots above, taken from the demo application, you have several graphical options that will allow a perfect integration into modern user interfaces.

First of all, set the Style property value to STYLE_PROGRESS_BAR.  (For more details on button styles, see How to change the button style. For more details on setting button properties, see How to use the control in your projects)

Then you should define the range of supported values inside the ProgressBarMin and ProgressBarMax 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 ProgressBarValue property.

 

Differently from the standard Windows progress bar, the control can not only have a horizontal and vertical evolution but can also have 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:

3dabm_i000198

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.

3dabm_i00019a

 

 

 

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

ProgressBarMin


Max Value

The control's maximum value

ProgressBarMax


Value

The current value

ProgressBarValue


Apply button

Applies displayed values to the control