1999-08-16 18:51:52 +00:00
|
|
|
<!-- ##### SECTION Title ##### -->
|
|
|
|
GtkProgress
|
|
|
|
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
2004-10-11 20:10:52 +00:00
|
|
|
Base class for GtkProgressBar
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
|
|
<para>
|
1999-11-16 00:33:10 +00:00
|
|
|
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.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
2000-09-07 18:17:06 +00:00
|
|
|
|
1999-08-16 18:51:52 +00:00
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### STRUCT GtkProgress ##### -->
|
|
|
|
<para>
|
1999-11-16 00:33:10 +00:00
|
|
|
The #GtkProgress-struct struct contains private data only.
|
|
|
|
and should be accessed using the functions below.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
2000-09-07 18:17:06 +00:00
|
|
|
|
2004-07-20 02:26:06 +00:00
|
|
|
<!-- ##### ARG GtkProgress:activity-mode ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkProgress:show-text ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkProgress:text-xalign ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkProgress:text-yalign ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
1999-08-16 18:51:52 +00:00
|
|
|
<!-- ##### FUNCTION gtk_progress_set_show_text ##### -->
|
|
|
|
<para>
|
1999-11-16 00:33:10 +00:00
|
|
|
Controls whether progress text is shown.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
1999-11-16 00:33:10 +00:00
|
|
|
@progress: a #GtkProgress.
|
|
|
|
@show_text: a boolean indicating whether the progress text
|
|
|
|
is shown.
|
1999-08-16 18:51:52 +00:00
|
|
|
|
2000-09-07 18:17:06 +00:00
|
|
|
|
1999-08-16 18:51:52 +00:00
|
|
|
<!-- ##### FUNCTION gtk_progress_set_text_alignment ##### -->
|
|
|
|
<para>
|
1999-11-16 00:33:10 +00:00
|
|
|
Controls the alignment of the text within the progress bar area.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
1999-11-16 00:33:10 +00:00
|
|
|
@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.
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_progress_set_format_string ##### -->
|
|
|
|
<para>
|
1999-11-16 00:33:10 +00:00
|
|
|
Sets a format string used to display text indicating the
|
|
|
|
current progress. The string can contain the following substitution characters:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
1999-11-16 00:33:10 +00:00
|
|
|
<itemizedlist>
|
|
|
|
<listitem>
|
|
|
|
<para>
|
2002-06-03 17:47:31 +00:00
|
|
|
%v - the current progress value.
|
1999-11-16 00:33:10 +00:00
|
|
|
</para>
|
2000-01-05 15:04:23 +00:00
|
|
|
</listitem>
|
1999-11-16 00:33:10 +00:00
|
|
|
<listitem>
|
|
|
|
<para>
|
2002-06-03 17:47:31 +00:00
|
|
|
%l - the lower bound for the progress value.
|
1999-11-16 00:33:10 +00:00
|
|
|
</para>
|
2000-01-05 15:04:23 +00:00
|
|
|
</listitem>
|
1999-11-16 00:33:10 +00:00
|
|
|
<listitem>
|
|
|
|
<para>
|
2002-06-03 17:47:31 +00:00
|
|
|
%u - the upper bound for the progress value.
|
1999-11-16 00:33:10 +00:00
|
|
|
</para>
|
2000-01-05 15:04:23 +00:00
|
|
|
</listitem>
|
1999-11-16 00:33:10 +00:00
|
|
|
<listitem>
|
|
|
|
<para>
|
2002-06-03 17:47:31 +00:00
|
|
|
%p - the current progress percentage.
|
1999-11-16 00:33:10 +00:00
|
|
|
</para>
|
2000-01-05 15:04:23 +00:00
|
|
|
</listitem>
|
1999-11-16 00:33:10 +00:00
|
|
|
</itemizedlist>
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
1999-11-16 00:33:10 +00:00
|
|
|
@progress: a #GtkProgress.
|
2002-09-23 22:57:13 +00:00
|
|
|
@format: a string used to display progress text, or %NULL
|
|
|
|
to restore to the default format.
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_progress_set_adjustment ##### -->
|
|
|
|
<para>
|
1999-11-16 00:33:10 +00:00
|
|
|
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.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
1999-11-16 00:33:10 +00:00
|
|
|
@progress: a #GtkProgress.
|
|
|
|
@adjustment: the #GtkAdjustment to be associated with the #GtkProgress.
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_progress_set_percentage ##### -->
|
|
|
|
<para>
|
1999-11-16 00:33:10 +00:00
|
|
|
Sets the current percentage completion for the #GtkProgress.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
1999-11-16 00:33:10 +00:00
|
|
|
@progress: a #GtkProgress.
|
|
|
|
@percentage: the percentage complete which must be between 0.0
|
|
|
|
and 1.0.
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_progress_set_value ##### -->
|
|
|
|
<para>
|
1999-11-16 00:33:10 +00:00
|
|
|
Sets the value within the #GtkProgress to an absolute value.
|
|
|
|
The value must be within the valid range of values for the
|
|
|
|
underlying #GtkAdjustment.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
1999-11-16 00:33:10 +00:00
|
|
|
@progress: a #GtkProgress.
|
|
|
|
@value: the value indicating the current completed amount.
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_progress_get_value ##### -->
|
|
|
|
<para>
|
1999-11-16 00:33:10 +00:00
|
|
|
Returns the current progress complete value.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
1999-11-16 00:33:10 +00:00
|
|
|
@progress: a #GtkProgress.
|
|
|
|
@Returns: the current progress complete value.
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_progress_set_activity_mode ##### -->
|
|
|
|
<para>
|
1999-11-16 00:33:10 +00:00
|
|
|
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.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
1999-11-16 00:33:10 +00:00
|
|
|
@progress: a #GtkProgress.
|
Markup fixes.
* gtk/gtkdialog.c, gtk/gtkrc.c, gtk/gtkwidget.c: Markup fixes.
* gdk-pixbuf-io.c: Markup fixes.
* gdk-pixbuf/tmpl/scaling.sgml, gdk/tmpl/fonts.sgml,
gdk/tmpl/general.sgml, gdk/tmpl/rgb.sgml, gdk/tmpl/visuals.sgml,
gdk/tmpl/windows.sgml, gtk/gtk-docs.sgml, gtk/tmpl/gtkaccellabel.sgml,
gtk/tmpl/gtkcombo.sgml, gtk/tmpl/gtkdialog.sgml,
gtk/tmpl/gtkdrawingarea.sgml, gtk/tmpl/gtkeditable.sgml,
gtk/tmpl/gtkfilesel.sgml, gtk/tmpl/gtkfontseldlg.sgml,
gtk/tmpl/gtkimage.sgml, gtk/tmpl/gtkmain.sgml, gtk/tmpl/gtkmenu.sgml,
gtk/tmpl/gtkmessagedialog.sgml, gtk/tmpl/gtkobject.sgml,
gtk/tmpl/gtkpaned.sgml, gtk/tmpl/gtkradiobutton.sgml,
gtk/tmpl/gtkrc.sgml, gtk/tmpl/gtkscale.sgml, gtk/tmpl/gtksignal.sgml,
gtk/tmpl/gtksocket.sgml, gtk/tmpl/gtkspinbutton.sgml,
gtk/tmpl/gtktogglebutton.sgml, gtk/tmpl/gtksignal.sgml,
gtk/tmpl/gtktooltips.sgml, gtk/tmpl/gtkwindow.sgml,
gdk/tmpl/regions.sgml, gtk/tmpl/gtkfontsel.sgml,
gtk/tmpl/gtkpixmap.sgml, gtk/tmpl/gtkprogress.sgml,
gtk/tmpl/gtkselection.sgml, gtk/tmpl/gtktable.sgml,
gtk/tmpl/gtktipsquery.sgml: Markup fixes (mainly examples).
2001-12-13 19:51:24 +00:00
|
|
|
@activity_mode: a boolean, %TRUE for activity mode.
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_progress_get_current_text ##### -->
|
|
|
|
<para>
|
1999-11-16 00:33:10 +00:00
|
|
|
Returns the current text associated with the #GtkProgress. This
|
|
|
|
text is the based on the underlying format string after any substitutions
|
|
|
|
are made.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
1999-11-16 00:33:10 +00:00
|
|
|
@progress: a #GtkProgress.
|
|
|
|
@Returns: the text indicating the current progress.
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_progress_get_text_from_value ##### -->
|
|
|
|
<para>
|
1999-11-16 00:33:10 +00:00
|
|
|
Returns the text indicating the progress based on the supplied value.
|
|
|
|
The current value for the #GtkProgress remains unchanged.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
1999-11-16 00:33:10 +00:00
|
|
|
@progress: a #GtkProgress.
|
|
|
|
@value: an absolute progress value to use when formatting the progress text.
|
|
|
|
@Returns: a string indicating the progress.
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_progress_get_current_percentage ##### -->
|
|
|
|
<para>
|
1999-11-16 00:33:10 +00:00
|
|
|
Returns the current progress as a percentage.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
1999-11-16 00:33:10 +00:00
|
|
|
@progress: a #GtkProgress.
|
|
|
|
@Returns: a number between 0.0 and 1.0 indicating the percentage complete.
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_progress_get_percentage_from_value ##### -->
|
|
|
|
<para>
|
1999-11-16 00:33:10 +00:00
|
|
|
Returns the progress as a percentage calculated from the supplied
|
|
|
|
absolute progress value.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
1999-11-16 00:33:10 +00:00
|
|
|
@progress: a #GtkProgress.
|
|
|
|
@value: an absolute progress value.
|
|
|
|
@Returns: a number between 0.0 and 1.0 indicating the percentage complete
|
|
|
|
represented by @value.
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_progress_configure ##### -->
|
|
|
|
<para>
|
1999-11-16 00:33:10 +00:00
|
|
|
Allows the configuration of the minimum, maximum, and current values for
|
|
|
|
the #GtkProgress.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
1999-11-16 00:33:10 +00:00
|
|
|
@progress: a #GtkProgress.
|
|
|
|
@value: the current progress value.
|
|
|
|
@min: the minimum progress value.
|
|
|
|
@max: the maximum progress value.
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|