gtk_progress_bar_new ()

GtkWidget *
gtk_progress_bar_new (void);

Creates a new GtkProgressBar.

gtk_progress_bar_pulse ()

void
gtk_progress_bar_pulse (GtkProgressBar *pbar);

Indicates that some progress is made, but you don't know how much. Causes the progress bar to enter "activity mode," where a block bounces back and forth. Each call to gtk_progress_bar_pulse() causes the block to move by a little bit (the amount of movement per pulse is determined by gtk_progress_bar_set_pulse_step()).

gtk_progress_bar_set_text ()

void
gtk_progress_bar_set_text (GtkProgressBar *pbar,
                           const gchar *text);

Causes the given text to appear superimposed on the progress bar.

gtk_progress_bar_set_fraction ()

void
gtk_progress_bar_set_fraction (GtkProgressBar *pbar,
                               gdouble fraction);

Causes the progress bar to "fill in" the given fraction of the bar. The fraction should be between 0.0 and 1.0, inclusive.

gtk_progress_bar_set_pulse_step ()

void
gtk_progress_bar_set_pulse_step (GtkProgressBar *pbar,
                                 gdouble fraction);

Sets the fraction of total progress bar length to move the bouncing block for each call to gtk_progress_bar_pulse().

gtk_progress_bar_set_orientation ()

void
gtk_progress_bar_set_orientation (GtkProgressBar *pbar,
                                  GtkProgressBarOrientation orientation);

Causes the progress bar to switch to a different orientation (left-to-right, right-to-left, top-to-bottom, or bottom-to-top).

gtk_progress_bar_set_ellipsize ()

void
gtk_progress_bar_set_ellipsize (GtkProgressBar *pbar,
                                PangoEllipsizeMode mode);

Sets the mode used to ellipsize (add an ellipsis: "...") the text if there is not enough space to render the entire string.

Since: 2.6

gtk_progress_bar_get_text ()

const gchar *
gtk_progress_bar_get_text (GtkProgressBar *pbar);

Retrieves the text displayed superimposed on the progress bar, if any, otherwise NULL. The return value is a reference to the text, not a copy of it, so will become invalid if you change the text in the progress bar.

gtk_progress_bar_get_fraction ()

gdouble
gtk_progress_bar_get_fraction (GtkProgressBar *pbar);

Returns the current fraction of the task that's been completed.

gtk_progress_bar_get_pulse_step ()

gdouble
gtk_progress_bar_get_pulse_step (GtkProgressBar *pbar);

Retrieves the pulse step set with gtk_progress_bar_set_pulse_step()

gtk_progress_bar_get_orientation ()

GtkProgressBarOrientation
gtk_progress_bar_get_orientation (GtkProgressBar *pbar);

Retrieves the current progress bar orientation.

gtk_progress_bar_get_ellipsize ()

PangoEllipsizeMode
gtk_progress_bar_get_ellipsize (GtkProgressBar *pbar);

Returns the ellipsizing position of the progressbar. See gtk_progress_bar_set_ellipsize().

Since: 2.6

gtk_progress_bar_new_with_adjustment ()

GtkWidget *
gtk_progress_bar_new_with_adjustment (GtkAdjustment *adjustment);

Creates a new GtkProgressBar with an associated GtkAdjustment.

gtk_progress_bar_set_bar_style ()

void
gtk_progress_bar_set_bar_style (GtkProgressBar *pbar,
                                GtkProgressBarStyle style);

gtk_progress_bar_set_discrete_blocks ()

void
gtk_progress_bar_set_discrete_blocks (GtkProgressBar *pbar,
                                      guint blocks);

gtk_progress_bar_set_activity_step ()

void
gtk_progress_bar_set_activity_step (GtkProgressBar *pbar,
                                    guint step);

gtk_progress_bar_set_activity_blocks ()

void
gtk_progress_bar_set_activity_blocks (GtkProgressBar *pbar,
                                      guint blocks);

gtk_progress_bar_update ()

void
gtk_progress_bar_update (GtkProgressBar *pbar,
                         gdouble percentage);

struct GtkProgressBar

struct GtkProgressBar;

enum GtkProgressBarOrientation

enum GtkProgressBarStyle

The “activity-blocks” property

  “activity-blocks”          guint

The number of blocks which can fit in the progress bar area in activity mode (Deprecated).

Owner: GtkProgressBar

Flags: Read / Write

Allowed values: >= 2

Default value: 5

The “activity-step” property

  “activity-step”            guint

The increment used for each iteration in activity mode (Deprecated).

Owner: GtkProgressBar

Flags: Read / Write

Default value: 3

The “adjustment” property

  “adjustment”               GtkAdjustment *

The GtkAdjustment connected to the progress bar (Deprecated).

Owner: GtkProgressBar

Flags: Read / Write

The “bar-style” property

  “bar-style”                GtkProgressBarStyle

Specifies the visual style of the bar in percentage mode (Deprecated).

Owner: GtkProgressBar

Flags: Read / Write

Default value: GTK_PROGRESS_CONTINUOUS

The “discrete-blocks” property

  “discrete-blocks”          guint

The number of discrete blocks in a progress bar (when shown in the discrete style).

Owner: GtkProgressBar

Flags: Read / Write

Allowed values: >= 2

Default value: 10

The “ellipsize” property

  “ellipsize”                PangoEllipsizeMode

The preferred place to ellipsize the string, if the progressbar does not have enough room to display the entire string, specified as a PangoEllisizeMode.

Note that setting this property to a value other than PANGO_ELLIPSIZE_NONE has the side-effect that the progressbar requests only enough space to display the ellipsis "...". Another means to set a progressbar's width is gtk_widget_set_size_request().

Owner: GtkProgressBar

Flags: Read / Write

Default value: PANGO_ELLIPSIZE_NONE

Since: 2.6

The “fraction” property

  “fraction”                 double

The fraction of total work that has been completed.

Owner: GtkProgressBar

Flags: Read / Write

Allowed values: [0,1]

Default value: 0

The “orientation” property

  “orientation”              GtkProgressBarOrientation

Orientation and growth direction of the progress bar.

Owner: GtkProgressBar

Flags: Read / Write

Default value: GTK_PROGRESS_LEFT_TO_RIGHT

The “pulse-step” property

  “pulse-step”               double

The fraction of total progress to move the bouncing block when pulsed.

Owner: GtkProgressBar

Flags: Read / Write

Allowed values: [0,1]

Default value: 0.1

The “text” property

  “text”                     char *

Text to be displayed in the progress bar.

Owner: GtkProgressBar

Flags: Read / Write

Default value: NULL

The “min-horizontal-bar-height” style property

  “min-horizontal-bar-height” int

Minimum horizontal height of the progress bar.

Owner: GtkProgressBar

Flags: Read / Write

Allowed values: >= 1

Default value: 20

Since: 2.14

The “min-horizontal-bar-width” style property

  “min-horizontal-bar-width” int

The minimum horizontal width of the progress bar.

Owner: GtkProgressBar

Flags: Read / Write

Allowed values: >= 1

Default value: 150

Since: 2.14

The “min-vertical-bar-height” style property

  “min-vertical-bar-height”  int

The minimum vertical height of the progress bar.

Owner: GtkProgressBar

Flags: Read / Write

Allowed values: >= 1

Default value: 80

Since: 2.14

The “min-vertical-bar-width” style property

  “min-vertical-bar-width”   int

The minimum vertical width of the progress bar.

Owner: GtkProgressBar

Flags: Read / Write

Allowed values: >= 1

Default value: 22

Since: 2.14

The “xspacing” style property

  “xspacing”                 int

Extra spacing applied to the width of a progress bar.

Owner: GtkProgressBar

Flags: Read / Write

Allowed values: >= 0

Default value: 7

The “yspacing” style property

  “yspacing”                 int

Extra spacing applied to the height of a progress bar.

Owner: GtkProgressBar

Flags: Read / Write

Allowed values: >= 0

Default value: 7