## IupProgressBar (since 3.0)

Creates a progress bar control. Shows a percent value that can be updated to simulate a progression.

It is similar of IupGauge, but uses native controls internally. Also does not have support for text inside the bar.

### Creation

    Ihandle* IupProgressBar(void); [in C]
    iup.progressbar{} -> (ih: ihandle) [in Lua]
    progressbar() [in LED]

Returns: the identifier of the created element, or NULL if an error occurs.

### Attributes

BGCOLOR [Windows Classic and Motif only]: controls the background color. Default: the global attribute DLGBGCOLOR.

DASHED (creation only in Windows) [Windows and GTK only]: Changes the style of the progress bar for a dashed pattern. Default is "NO". In Windows it is not supported since Windows Vista when using Visual Styles.

FGCOLOR [Windows Classic and Motif only]: Controls the bar color. Default: the global attribute DLGFGCOLOR.

MARQUEE (creation): displays an undefined state. Default: NO. You can set the attribute after map but only to start or stop the animation. In Windows it will work only if using Visual Styles.

MAX (non inheritable): Contains the maximum value. Default is "1". The control display is not updated, must set VALUE attribute to update.

MIN (non inheritable): Contains the minimum value. Default is "0". The control display is not updated, must set VALUE attribute to update.

ORIENTATION (creation only): can be "VERTICAL" or "HORIZONTAL". Default: "HORIZONTAL". Horizontal goes from left to right, and vertical from bottom to top.

RASTERSIZE: The initial size is defined as "200x30". Set to NULL to allow the use of smaller values in the layout computation.

VALUE (non inheritable): Contains a number between "MIN" and "MAX", controlling the current position.

ACTIVE, EXPAND, FONT, SCREENPOSITION, POSITION, MINSIZE, MAXSIZE, WID, TIP, SIZE, ZORDER, VISIBLE, THEME: also accepted.

### Callbacks

MAP_CB, UNMAP_CB, DESTROY_CB: common callbacks are supported.

### Notes

In GTK uses GtkProgressBar, in Windows uses PROGRESS_CLASS, and in Motif uses xmScale.

### Examples

Browse for Example Files

| DASHED=NO | DASHED=YES | MARQUEE=YES
Motif |  | (same as DASHED=NO) |
Windows Classic |  |  | (same as DASHED)
Windows w/ Styles | (same as DASHED=YES) |  |
Windows Vista |  | (same as DASHED=NO) |
GTK |  |  |

### See Also

IupGauge