Creates a progress bar control. Shows a percent value that can be updated to simulate a progression.
It is similar to IupGauge, but uses native controls internally. Also does not have support for text inside the bar.
Ihandle* IupProgressBar(void);
Returns: the identifier of the created element, or NULL if an error occurs.
BGCOLOR: controls the background color. Default: the global attribute DLGBGCOLOR. In Android the platform theme background is used.
DASHED (creation-only in Windows): Changes the style of the progress bar for a dashed pattern. Default is "NO". In Windows, it is not supported when using Visual Styles. Supported in Win32 (without Visual Styles), GTK 2, GTK 3, GTK 4, Qt and iOS.
FGCOLOR: Controls the bar color. By default the native/system bar color is used. Not supported in macOS and EFL.
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.
CIRCULAR [Android, iOS] (creation-only): when "YES", renders the indicator as a circular spinner instead of a linear bar. On Android uses Material CircularProgressIndicator (supports both determinate and indeterminate via MARQUEE). On iOS uses UIActivityIndicatorView (always indeterminate; VALUE / MAX / MIN / DASHED / ORIENTATION are ignored). Default: "NO". Ignored on desktop drivers.
RASTERSIZE: The initial size is 200 pixels along the bar (width for HORIZONTAL, height for VERTICAL); the other dimension uses the native minimum. When CIRCULAR=YES it is "48x48". 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.
MAP_CB, UNMAP_CB, DESTROY_CB: common callbacks are supported.
| GTK | Qt | Win32 | macOS |
 |
 |
 |
 |