Back to Projects
TUIX v0.5Beta

Last Updated: 2026-05-20

Progressbar Widget

Progressbar renders a horizontal fill bar with a value in the 0.0 to 1.0 range. It supports configurable fill/empty characters, fill and empty colors, and optional percentage display.

Creating A Progressbar

uid = objects.create_object(builders.PROGRESSBAR, 'Main', 0.6, 0.08, 0.1, 0.2)
bar = objects.get_object_by_uid(uid)

API Functions

FunctionDescription
objects.tuix_progressbar_set_value(obj, value)Sets the current value. Values are expected in the 0.0..1.0 range.
objects.tuix_progressbar_get_value(obj)Returns the current value.
objects.tuix_progressbar_set_style(obj, fill, empty, fr, fg, fb, er, eg, eb)Sets fill/empty characters and RGB colors.
objects.tuix_progressbar_show_percentage(obj, show=True)Enables or disables percentage text.

Example

objects.tuix_progressbar_set_value(bar, 0.75)
objects.tuix_progressbar_set_style(
    bar,
    '#', '-',
    120, 220, 80,
    50, 50, 50,
)
objects.tuix_progressbar_show_percentage(bar, True)
engine.main_loop()