Blitz3D+ Command Reference

CreateProgBar ( x,y,width,height,group[,style] )

Parameters

x,y - position of the progress bar's top-left corner within the group's client area

width,height - size of the progress bar

group - window or gadget group that owns the progress bar

style (optional) - 0 (default); other values are reserved

Description

Creates a progress bar gadget and returns its handle.

Requires Extended language mode.

The standard feedback control for anything that takes a while in a tool: exporting a level, baking lightmaps, downloading assets. Drive it with UpdateProgBar, which takes a floating point fraction from 0.0 (empty) to 1.0 (full).

Progress bars are display-only - the user cannot interact with them and they post no events. Pair one with SetStatusText or a label for a message about what is happening.

See it working in the layout and controls sample, where a slider drives it live; the world editor shell sample shows the surrounding editor layout.

See also: UpdateProgBar, CreateSlider, SetStatusText, CreateLabel.

Index