GtkProgress

GtkProgress — Base class for GtkProgressBar

Synopsis


#include <gtk/gtk.h>


                    GtkProgress;
void                gtk_progress_set_show_text          (GtkProgress *progress,
                                                         gboolean show_text);
void                gtk_progress_set_text_alignment     (GtkProgress *progress,
                                                         gfloat x_align,
                                                         gfloat y_align);
void                gtk_progress_set_format_string      (GtkProgress *progress,
                                                         const gchar *format);
void                gtk_progress_set_adjustment         (GtkProgress *progress,
                                                         GtkAdjustment *adjustment);
void                gtk_progress_set_percentage         (GtkProgress *progress,
                                                         gdouble percentage);
void                gtk_progress_set_value              (GtkProgress *progress,
                                                         gdouble value);
gdouble             gtk_progress_get_value              (GtkProgress *progress);
void                gtk_progress_set_activity_mode      (GtkProgress *progress,
                                                         gboolean activity_mode);
gchar*              gtk_progress_get_current_text       (GtkProgress *progress);
gchar*              gtk_progress_get_text_from_value    (GtkProgress *progress,
                                                         gdouble value);
gdouble             gtk_progress_get_current_percentage (GtkProgress *progress);
gdouble             gtk_progress_get_percentage_from_value
                                                        (GtkProgress *progress,
                                                         gdouble value);
void                gtk_progress_configure              (GtkProgress *progress,
                                                         gdouble value,
                                                         gdouble hmin,
                                                         gdouble max);


Description

A GtkProgress is the abstract base class used to derive a GtkProgressBar which provides a visual representation of the progress of a long running operation.

Details

GtkProgress

typedef struct {
  GtkWidget widget;

  GtkAdjustment *adjustment;
  GdkPixmap     *offscreen_pixmap;
  gchar         *format;
  gfloat         x_align;
  gfloat         y_align;

  guint          show_text : 1;
  guint          activity_mode : 1;
  guint          use_text_format : 1;
} GtkProgress;

The GtkProgress struct contains private data only. and should be accessed using the functions below.


gtk_progress_set_show_text ()

void                gtk_progress_set_show_text          (GtkProgress *progress,
                                                         gboolean show_text);

Warning

gtk_progress_set_show_text is deprecated and should not be used in newly-written code.

Controls whether progress text is shown.

progress :

a GtkProgress.

show_text :

a boolean indicating whether the progress text is shown.

gtk_progress_set_text_alignment ()

void                gtk_progress_set_text_alignment     (GtkProgress *progress,
                                                         gfloat x_align,
                                                         gfloat y_align);

Warning

gtk_progress_set_text_alignment is deprecated and should not be used in newly-written code.

Controls the alignment of the text within the progress bar area.

progress :

a GtkProgress.

x_align :

a number between 0.0 and 1.0 indicating the horizontal alignment of the progress text within the GtkProgress.

y_align :

a number between 0.0 and 1.0 indicating the vertical alignment of the progress text within the GtkProgress.

gtk_progress_set_format_string ()

void                gtk_progress_set_format_string      (GtkProgress *progress,
                                                         const gchar *format);

Warning

gtk_progress_set_format_string is deprecated and should not be used in newly-written code.

Sets a format string used to display text indicating the current progress. The string can contain the following substitution characters:

  • %v - the current progress value.

  • %l - the lower bound for the progress value.

  • %u - the upper bound for the progress value.

  • %p - the current progress percentage.

progress :

a GtkProgress.

format :

a string used to display progress text, or NULL to restore to the default format.

gtk_progress_set_adjustment ()

void                gtk_progress_set_adjustment         (GtkProgress *progress,
                                                         GtkAdjustment *adjustment);

Warning

gtk_progress_set_adjustment is deprecated and should not be used in newly-written code.

Associates a GtkAdjustment with the GtkProgress. A GtkAdjustment is used to represent the upper and lower bounds and the step interval of the underlying value for which progress is shown.

progress :

a GtkProgress.

adjustment :

the GtkAdjustment to be associated with the GtkProgress.

gtk_progress_set_percentage ()

void                gtk_progress_set_percentage         (GtkProgress *progress,
                                                         gdouble percentage);

Warning

gtk_progress_set_percentage is deprecated and should not be used in newly-written code.

Sets the current percentage completion for the GtkProgress.

progress :

a GtkProgress.

percentage :

the percentage complete which must be between 0.0 and 1.0.

gtk_progress_set_value ()

void                gtk_progress_set_value              (GtkProgress *progress,
                                                         gdouble value);

Warning

gtk_progress_set_value is deprecated and should not be used in newly-written code.

Sets the value within the GtkProgress to an absolute value. The value must be within the valid range of values for the underlying GtkAdjustment.

progress :

a GtkProgress.

value :

the value indicating the current completed amount.

gtk_progress_get_value ()

gdouble             gtk_progress_get_value              (GtkProgress *progress);

Warning

gtk_progress_get_value is deprecated and should not be used in newly-written code.

Returns the current progress complete value.

progress :

a GtkProgress.

Returns :

the current progress complete value.

gtk_progress_set_activity_mode ()

void                gtk_progress_set_activity_mode      (GtkProgress *progress,
                                                         gboolean activity_mode);

Warning

gtk_progress_set_activity_mode is deprecated and should not be used in newly-written code.

A GtkProgress can be in one of two different modes: percentage mode (the default) and activity mode. In activity mode, the progress is simply indicated as activity rather than as a percentage complete.

progress :

a GtkProgress.

activity_mode :

a boolean, TRUE for activity mode.

gtk_progress_get_current_text ()

gchar*              gtk_progress_get_current_text       (GtkProgress *progress);

Warning

gtk_progress_get_current_text is deprecated and should not be used in newly-written code.

Returns the current text associated with the GtkProgress. This text is the based on the underlying format string after any substitutions are made.

progress :

a GtkProgress.

Returns :

the text indicating the current progress.

gtk_progress_get_text_from_value ()

gchar*              gtk_progress_get_text_from_value    (GtkProgress *progress,
                                                         gdouble value);

Warning

gtk_progress_get_text_from_value is deprecated and should not be used in newly-written code.

Returns the text indicating the progress based on the supplied value. The current value for the GtkProgress remains unchanged.

progress :

a GtkProgress.

value :

an absolute progress value to use when formatting the progress text.

Returns :

a string indicating the progress.

gtk_progress_get_current_percentage ()

gdouble             gtk_progress_get_current_percentage (GtkProgress *progress);

Warning

gtk_progress_get_current_percentage is deprecated and should not be used in newly-written code.

Returns the current progress as a percentage.

progress :

a GtkProgress.

Returns :

a number between 0.0 and 1.0 indicating the percentage complete.

gtk_progress_get_percentage_from_value ()

gdouble             gtk_progress_get_percentage_from_value
                                                        (GtkProgress *progress,
                                                         gdouble value);

Warning

gtk_progress_get_percentage_from_value is deprecated and should not be used in newly-written code.

Returns the progress as a percentage calculated from the supplied absolute progress value.

progress :

a GtkProgress.

value :

an absolute progress value.

Returns :

a number between 0.0 and 1.0 indicating the percentage complete represented by value.

gtk_progress_configure ()

void                gtk_progress_configure              (GtkProgress *progress,
                                                         gdouble value,
                                                         gdouble hmin,
                                                         gdouble max);

Warning

gtk_progress_configure is deprecated and should not be used in newly-written code.

Allows the configuration of the minimum, maximum, and current values for the GtkProgress.

progress :

a GtkProgress.

value :

the current progress value.

hmin :

max :

the maximum progress value.