forked from AuroraMiddleware/gtk
7447ef0fc2
In particular, rename - libraries to lib*-3.0.so - pc files to *-3.0.pc - include paths to /usr/include/gtk-3.0/* - module paths to /usr/lib/gtk-3.0/* - rc files names to gtk-3.0/gtkrc - commandline utilities to *-3.0 - adjust documentation Also change the install location for unix-print headers to /usr/include/gtk-3.0/unix-print/gtk.
253 lines
5.2 KiB
Plaintext
253 lines
5.2 KiB
Plaintext
<!-- ##### SECTION Title ##### -->
|
|
GtkProgressBar
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
A widget which indicates progress visually
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
<para>
|
|
The #GtkProgressBar is typically used to display the progress of a long
|
|
running operation. It provides a visual clue that processing
|
|
is underway. The #GtkProgressBar can be used in two different
|
|
modes: percentage mode and activity mode.
|
|
</para>
|
|
|
|
<para>
|
|
When an application can determine how much work needs to take place
|
|
(e.g. read a fixed number of bytes from a file) and can monitor its
|
|
progress, it can use the #GtkProgressBar in percentage mode and the user
|
|
sees a growing bar indicating the percentage of the work that has
|
|
been completed. In this mode, the application is required to call
|
|
gtk_progress_bar_set_fraction() periodically to update the progress bar.
|
|
</para>
|
|
|
|
<para>
|
|
When an application has no accurate way of knowing the amount of work
|
|
to do, it can use the #GtkProgressBar in activity mode, which shows activity
|
|
by a block moving back and forth within the progress area. In this mode,
|
|
the application is required to call gtk_progress_bar_pulse() perodically
|
|
to update the progress bar.
|
|
</para>
|
|
|
|
<para>
|
|
There is quite a bit of flexibility provided to control the appearance
|
|
of the #GtkProgressBar. Functions are provided to control the
|
|
orientation of the bar, optional text can be displayed along with
|
|
the bar, and the step size used in activity mode can be set.
|
|
</para>
|
|
|
|
<note>
|
|
<para>
|
|
The #GtkProgressBar/#GtkProgress API in GTK 1.2 was bloated, needlessly complex
|
|
and hard to use properly. Therefore #GtkProgress has been deprecated
|
|
completely and the #GtkProgressBar API has been reduced to the following 10
|
|
functions: gtk_progress_bar_new(), gtk_progress_bar_pulse(),
|
|
gtk_progress_bar_set_text(), gtk_progress_bar_set_fraction(),
|
|
gtk_progress_bar_set_pulse_step(), gtk_progress_bar_set_orientation(),
|
|
gtk_progress_bar_get_text(), gtk_progress_bar_get_fraction(),
|
|
gtk_progress_bar_get_pulse_step(), gtk_progress_bar_get_orientation().
|
|
These have been grouped at the beginning of this section, followed by
|
|
a large chunk of deprecated 1.2 compatibility functions.
|
|
</para>
|
|
</note>
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### SECTION Stability_Level ##### -->
|
|
|
|
|
|
<!-- ##### SECTION Image ##### -->
|
|
|
|
|
|
<!-- ##### STRUCT GtkProgressBar ##### -->
|
|
<para>
|
|
The #GtkProgressBar-struct struct contains private data only,
|
|
and should be accessed using the functions below.
|
|
</para>
|
|
|
|
|
|
<!-- ##### ARG GtkProgressBar:ellipsize ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkProgressBar:fraction ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkProgressBar:orientation ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkProgressBar:pulse-step ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkProgressBar:text ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkProgressBar:min-horizontal-bar-height ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkProgressBar:min-horizontal-bar-width ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkProgressBar:min-vertical-bar-height ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkProgressBar:min-vertical-bar-width ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkProgressBar:xspacing ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkProgressBar:yspacing ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### FUNCTION gtk_progress_bar_new ##### -->
|
|
<para>
|
|
Creates a new #GtkProgressBar.
|
|
</para>
|
|
|
|
@void:
|
|
@Returns: a #GtkProgressBar.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_progress_bar_pulse ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pbar:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_progress_bar_set_text ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pbar:
|
|
@text:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_progress_bar_set_fraction ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pbar:
|
|
@fraction:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_progress_bar_set_pulse_step ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pbar:
|
|
@fraction:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_progress_bar_set_orientation ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pbar:
|
|
@orientation:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_progress_bar_set_ellipsize ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pbar:
|
|
@mode:
|
|
|
|
|
|
<!-- ##### ENUM GtkProgressBarOrientation ##### -->
|
|
<para>
|
|
An enumeration representing possible orientations and growth
|
|
directions for the visible progress bar.
|
|
</para>
|
|
|
|
@GTK_PROGRESS_LEFT_TO_RIGHT: A horizontal progress bar growing from left to right.
|
|
@GTK_PROGRESS_RIGHT_TO_LEFT: A horizontal progress bar growing from right to left.
|
|
@GTK_PROGRESS_BOTTOM_TO_TOP: A vertical progress bar growing from bottom to top.
|
|
@GTK_PROGRESS_TOP_TO_BOTTOM: A vertical progress bar growing from top to bottom.
|
|
|
|
<!-- ##### FUNCTION gtk_progress_bar_get_text ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pbar:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_progress_bar_get_fraction ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pbar:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_progress_bar_get_pulse_step ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pbar:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_progress_bar_get_orientation ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pbar:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_progress_bar_get_ellipsize ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pbar:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### ENUM GtkProgressBarStyle ##### -->
|
|
<para>
|
|
An enumeration representing the styles for drawing the progress bar.
|
|
</para>
|
|
|
|
@GTK_PROGRESS_CONTINUOUS: The progress bar grows in a smooth, continuous manner.
|
|
@GTK_PROGRESS_DISCRETE: The progress bar grows in discrete, visible blocks.
|
|
|