|
Server : Apache/2.2.17 (Unix) mod_ssl/2.2.17 OpenSSL/0.9.8e-fips-rhel5 DAV/2 PHP/5.2.17 System : Linux localhost 2.6.18-419.el5 #1 SMP Fri Feb 24 22:47:42 UTC 2017 x86_64 User : nobody ( 99) PHP Version : 5.2.17 Disable Function : NONE Directory : /usr/share/gtk-doc/html/gtk/ |
Upload File : |
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>GtkProgressBar</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="index.html" title="GTK+ Reference Manual">
<link rel="up" href="DisplayWidgets.html" title="Display Widgets">
<link rel="prev" href="GtkLabel.html" title="GtkLabel">
<link rel="next" href="GtkStatusbar.html" title="GtkStatusbar">
<meta name="generator" content="GTK-Doc V1.6 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="part" href="gtk.html" title="Part I. GTK+ Overview">
<link rel="part" href="gtkbase.html" title="Part II. GTK+ Core Reference">
<link rel="part" href="gtkobjects.html" title="Part III. GTK+ Widgets and Objects">
<link rel="chapter" href="ch01.html" title="Object Hierarchy">
<link rel="chapter" href="ch02.html" title="Widget Gallery">
<link rel="chapter" href="WindowWidgets.html" title="Windows">
<link rel="chapter" href="DisplayWidgets.html" title="Display Widgets">
<link rel="chapter" href="ButtonWidgets.html" title="Buttons and Toggles">
<link rel="chapter" href="NumericEntry.html" title="Numeric/Text Data Entry">
<link rel="chapter" href="TextWidgetObjects.html" title="Multiline Text Editor">
<link rel="chapter" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
<link rel="chapter" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
<link rel="chapter" href="Actions.html" title="Action-based menus and toolbars">
<link rel="chapter" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)">
<link rel="chapter" href="LayoutContainers.html" title="Layout Containers">
<link rel="chapter" href="Ornaments.html" title="Ornaments">
<link rel="chapter" href="ScrollingWidgets.html" title="Scrolling">
<link rel="chapter" href="Printing.html" title="Printing">
<link rel="chapter" href="MiscObjects.html" title="Miscellaneous">
<link rel="chapter" href="AbstractObjects.html" title="Abstract Base Classes">
<link rel="chapter" href="PlugSocket.html" title="Cross-process Embedding">
<link rel="chapter" href="SpecialObjects.html" title="Special-purpose features">
<link rel="chapter" href="RecentDocuments.html" title="Recently Used Documents">
<link rel="chapter" href="DeprecatedObjects.html" title="Deprecated">
<link rel="part" href="migrating.html" title="Part IV. Migrating from Previous Versions of GTK+">
<link rel="chapter" href="gtk-migrating-checklist.html" title="Migration Checklist">
<link rel="chapter" href="gtk-migrating-GtkFileChooser.html" title="Migrating from GtkFileSelection to GtkFileChooser">
<link rel="chapter" href="gtk-migrating-GtkAction.html" title="Migrating from old menu and toolbar systems to GtkAction">
<link rel="chapter" href="gtk-migrating-GtkComboBox.html" title="Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and
GtkComboBoxEntry">
<link rel="chapter" href="gtk-migrating-GtkIconView.html" title="Migrating from GnomeIconList to GtkIconView">
<link rel="chapter" href="gtk-migrating-GtkAboutDialog.html" title="Migrating from GnomeAbout to GtkAboutDialog">
<link rel="chapter" href="gtk-migrating-GtkColorButton.html" title="Migrating from GnomeColorPicker to GtkColorButton">
<link rel="chapter" href="gtk-migrating-GtkAssistant.html" title="Migrating from GnomeDruid to GtkAssistant">
<link rel="chapter" href="gtk-migrating-GtkRecentChooser.html" title="Migrating from EggRecent to GtkRecentChooser">
<link rel="chapter" href="gtk-migrating-GtkLinkButton.html" title="Migrating from GnomeHRef to GtkLinkButton">
<link rel="part" href="pt05.html" title="Part V. GTK+ Tools">
<link rel="glossary" href="glossary.html" title="Glossary">
<link rel="index" href="ix01.html" title="Index">
<link rel="index" href="ix02.html" title="Index of deprecated symbols">
<link rel="index" href="ix03.html" title="Index of new symbols in 2.2">
<link rel="index" href="ix04.html" title="Index of new symbols in 2.4">
<link rel="index" href="ix05.html" title="Index of new symbols in 2.6">
<link rel="index" href="ix06.html" title="Index of new symbols in 2.8">
<link rel="index" href="ix07.html" title="Index of new symbols in 2.10">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="GtkLabel.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="DisplayWidgets.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GTK+ Reference Manual</th>
<td><a accesskey="n" href="GtkStatusbar.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2882643" class="shortcut">Top</a>
 | 
<a href="#id2883442" class="shortcut">Description</a>
 | 
<a href="#id2883179" class="shortcut">Object Hierarchy</a>
 | 
<a href="#id2883233" class="shortcut">Implemented Interfaces</a>
 | 
<a href="#id2883256" class="shortcut">Properties</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="GtkProgressBar"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id2882643"></a><span class="refentrytitle">GtkProgressBar</span>
</h2>
<p>GtkProgressBar — A widget which indicates progress visually</p>
</td>
<td valign="top" align="right"><img src="progressbar.png"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<pre class="synopsis">
#include <gtk/gtk.h>
<a href="GtkProgressBar.html#GtkProgressBar-struct">GtkProgressBar</a>;
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* <a href="GtkProgressBar.html#gtk-progress-bar-new">gtk_progress_bar_new</a> (void);
void <a href="GtkProgressBar.html#gtk-progress-bar-pulse">gtk_progress_bar_pulse</a> (<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar);
void <a href="GtkProgressBar.html#gtk-progress-bar-set-text">gtk_progress_bar_set_text</a> (<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *text);
void <a href="GtkProgressBar.html#gtk-progress-bar-set-fraction">gtk_progress_bar_set_fraction</a> (<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> fraction);
void <a href="GtkProgressBar.html#gtk-progress-bar-set-pulse-step">gtk_progress_bar_set_pulse_step</a> (<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> fraction);
void <a href="GtkProgressBar.html#gtk-progress-bar-set-orientation">gtk_progress_bar_set_orientation</a>
(<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar,
<a href="GtkProgressBar.html#GtkProgressBarOrientation">GtkProgressBarOrientation</a> orientation);
void <a href="GtkProgressBar.html#gtk-progress-bar-set-ellipsize">gtk_progress_bar_set_ellipsize</a> (<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar,
<a
href="../pango/pango-Layout-Objects.html#PangoEllipsizeMode"
>PangoEllipsizeMode</a> mode);
enum <a href="GtkProgressBar.html#GtkProgressBarOrientation">GtkProgressBarOrientation</a>;
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a>* <a href="GtkProgressBar.html#gtk-progress-bar-get-text">gtk_progress_bar_get_text</a> (<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar);
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> <a href="GtkProgressBar.html#gtk-progress-bar-get-fraction">gtk_progress_bar_get_fraction</a> (<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar);
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> <a href="GtkProgressBar.html#gtk-progress-bar-get-pulse-step">gtk_progress_bar_get_pulse_step</a> (<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar);
<a href="GtkProgressBar.html#GtkProgressBarOrientation">GtkProgressBarOrientation</a> <a href="GtkProgressBar.html#gtk-progress-bar-get-orientation">gtk_progress_bar_get_orientation</a>
(<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar);
<a
href="../pango/pango-Layout-Objects.html#PangoEllipsizeMode"
>PangoEllipsizeMode</a> <a href="GtkProgressBar.html#gtk-progress-bar-get-ellipsize">gtk_progress_bar_get_ellipsize</a>
(<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar);
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* <a href="GtkProgressBar.html#gtk-progress-bar-new-with-adjustment">gtk_progress_bar_new_with_adjustment</a>
(<a href="GtkAdjustment.html" title="GtkAdjustment">GtkAdjustment</a> *adjustment);
void <a href="GtkProgressBar.html#gtk-progress-bar-set-bar-style">gtk_progress_bar_set_bar_style</a> (<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar,
<a href="GtkProgressBar.html#GtkProgressBarStyle">GtkProgressBarStyle</a> style);
enum <a href="GtkProgressBar.html#GtkProgressBarStyle">GtkProgressBarStyle</a>;
void <a href="GtkProgressBar.html#gtk-progress-bar-set-discrete-blocks">gtk_progress_bar_set_discrete_blocks</a>
(<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> blocks);
void <a href="GtkProgressBar.html#gtk-progress-bar-set-activity-step">gtk_progress_bar_set_activity_step</a>
(<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> step);
void <a href="GtkProgressBar.html#gtk-progress-bar-set-activity-blocks">gtk_progress_bar_set_activity_blocks</a>
(<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> blocks);
void <a href="GtkProgressBar.html#gtk-progress-bar-update">gtk_progress_bar_update</a> (<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> percentage);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2883179"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
<a
href="../gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a>
+----<a
href="../gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned"
>GInitiallyUnowned</a>
+----<a href="GtkObject.html" title="GtkObject">GtkObject</a>
+----<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
+----<a href="GtkProgress.html" title="GtkProgress">GtkProgress</a>
+----GtkProgressBar
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2883233"></a><h2>Implemented Interfaces</h2>
<p>
GtkProgressBar implements
AtkImplementorIface.</p>
</div>
<div class="refsect1" lang="en">
<a name="id2883256"></a><h2>Properties</h2>
<pre class="synopsis">
"<a href="GtkProgressBar.html#GtkProgressBar--activity-blocks">activity-blocks</a>" <a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> : Read / Write
"<a href="GtkProgressBar.html#GtkProgressBar--activity-step">activity-step</a>" <a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> : Read / Write
"<a href="GtkProgressBar.html#GtkProgressBar--adjustment">adjustment</a>" <a href="GtkAdjustment.html" title="GtkAdjustment">GtkAdjustment</a> : Read / Write
"<a href="GtkProgressBar.html#GtkProgressBar--bar-style">bar-style</a>" <a href="GtkProgressBar.html#GtkProgressBarStyle">GtkProgressBarStyle</a> : Read / Write
"<a href="GtkProgressBar.html#GtkProgressBar--discrete-blocks">discrete-blocks</a>" <a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> : Read / Write
"<a href="GtkProgressBar.html#GtkProgressBar--ellipsize">ellipsize</a>" <a
href="../pango/pango-Layout-Objects.html#PangoEllipsizeMode"
>PangoEllipsizeMode</a> : Read / Write
"<a href="GtkProgressBar.html#GtkProgressBar--fraction">fraction</a>" <a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> : Read / Write
"<a href="GtkProgressBar.html#GtkProgressBar--orientation">orientation</a>" <a href="GtkProgressBar.html#GtkProgressBarOrientation">GtkProgressBarOrientation</a> : Read / Write
"<a href="GtkProgressBar.html#GtkProgressBar--pulse-step">pulse-step</a>" <a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> : Read / Write
"<a href="GtkProgressBar.html#GtkProgressBar--text">text</a>" <a
href="../gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Read / Write
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2883442"></a><h2>Description</h2>
<p>
The <a href="GtkProgressBar.html" title="GtkProgressBar"><span class="type">GtkProgressBar</span></a> is typically used to display the progress of a long
running operation. It provides a visual clue that processing
is underway. The <a href="GtkProgressBar.html" title="GtkProgressBar"><span class="type">GtkProgressBar</span></a> can be used in two different
modes: percentage mode and activity mode.
</p>
<p>
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 <a href="GtkProgressBar.html" title="GtkProgressBar"><span class="type">GtkProgressBar</span></a> 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
<a href="GtkProgressBar.html#gtk-progress-bar-set-fraction"><code class="function">gtk_progress_bar_set_fraction()</code></a> periodically to update the progress bar.
</p>
<p>
When an application has no accurate way of knowing the amount of work
to do, it can use the <a href="GtkProgressBar.html" title="GtkProgressBar"><span class="type">GtkProgressBar</span></a> 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 <a href="GtkProgressBar.html#gtk-progress-bar-pulse"><code class="function">gtk_progress_bar_pulse()</code></a> perodically
to update the progress bar.
</p>
<p>
There is quite a bit of flexibility provided to control the appearance
of the <a href="GtkProgressBar.html" title="GtkProgressBar"><span class="type">GtkProgressBar</span></a>. 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.
</p>
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Note</h3>
<p>
The <a href="GtkProgressBar.html" title="GtkProgressBar"><span class="type">GtkProgressBar</span></a>/<a href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> API in GTK 1.2 was bloated, needlessly complex
and hard to use properly. Therefore <a href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> has been deprecated
completely and the <a href="GtkProgressBar.html" title="GtkProgressBar"><span class="type">GtkProgressBar</span></a> API has been reduced to the following 10
functions: <a href="GtkProgressBar.html#gtk-progress-bar-new"><code class="function">gtk_progress_bar_new()</code></a>, <a href="GtkProgressBar.html#gtk-progress-bar-pulse"><code class="function">gtk_progress_bar_pulse()</code></a>,
<a href="GtkProgressBar.html#gtk-progress-bar-set-text"><code class="function">gtk_progress_bar_set_text()</code></a>, <a href="GtkProgressBar.html#gtk-progress-bar-set-fraction"><code class="function">gtk_progress_bar_set_fraction()</code></a>,
<a href="GtkProgressBar.html#gtk-progress-bar-set-pulse-step"><code class="function">gtk_progress_bar_set_pulse_step()</code></a>, <a href="GtkProgressBar.html#gtk-progress-bar-set-orientation"><code class="function">gtk_progress_bar_set_orientation()</code></a>,
<a href="GtkProgressBar.html#gtk-progress-bar-get-text"><code class="function">gtk_progress_bar_get_text()</code></a>, <a href="GtkProgressBar.html#gtk-progress-bar-get-fraction"><code class="function">gtk_progress_bar_get_fraction()</code></a>,
<a href="GtkProgressBar.html#gtk-progress-bar-get-pulse-step"><code class="function">gtk_progress_bar_get_pulse_step()</code></a>, <a href="GtkProgressBar.html#gtk-progress-bar-get-orientation"><code class="function">gtk_progress_bar_get_orientation()</code></a>.
These have been grouped at the beginning of this section, followed by
a large chunk of deprecated 1.2 compatibility functions.
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id2883703"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2883713"></a><h3>
<a name="GtkProgressBar-struct"></a>GtkProgressBar</h3>
<a class="indexterm" name="id2883727"></a><pre class="programlisting">typedef struct _GtkProgressBar GtkProgressBar;</pre>
<p>
The <a href="GtkProgressBar.html#GtkProgressBar-struct"><span class="type">GtkProgressBar</span></a> struct contains private data only,
and should be accessed using the functions below.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2883753"></a><h3>
<a name="gtk-progress-bar-new"></a>gtk_progress_bar_new ()</h3>
<a class="indexterm" name="id2883766"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* gtk_progress_bar_new (void);</pre>
<p>
Creates a new <a href="GtkProgressBar.html" title="GtkProgressBar"><span class="type">GtkProgressBar</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>a <a href="GtkProgressBar.html" title="GtkProgressBar"><span class="type">GtkProgressBar</span></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2883818"></a><h3>
<a name="gtk-progress-bar-pulse"></a>gtk_progress_bar_pulse ()</h3>
<a class="indexterm" name="id2883831"></a><pre class="programlisting">void gtk_progress_bar_pulse (<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar);</pre>
<p>
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 <a href="GtkProgressBar.html#gtk-progress-bar-pulse"><code class="function">gtk_progress_bar_pulse()</code></a>
causes the block to move by a little bit (the amount of movement
per pulse is determined by <a href="GtkProgressBar.html#gtk-progress-bar-set-pulse-step"><code class="function">gtk_progress_bar_set_pulse_step()</code></a>).</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>pbar</code></em> :</span></td>
<td> a <a href="GtkProgressBar.html" title="GtkProgressBar"><span class="type">GtkProgressBar</span></a>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2883916"></a><h3>
<a name="gtk-progress-bar-set-text"></a>gtk_progress_bar_set_text ()</h3>
<a class="indexterm" name="id2883929"></a><pre class="programlisting">void gtk_progress_bar_set_text (<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *text);</pre>
<p>
Causes the given <em class="parameter"><code>text</code></em> to appear superimposed on the progress bar.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>pbar</code></em> :</span></td>
<td> a <a href="GtkProgressBar.html" title="GtkProgressBar"><span class="type">GtkProgressBar</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>text</code></em> :</span></td>
<td> a UTF-8 string, or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2884026"></a><h3>
<a name="gtk-progress-bar-set-fraction"></a>gtk_progress_bar_set_fraction ()</h3>
<a class="indexterm" name="id2884039"></a><pre class="programlisting">void gtk_progress_bar_set_fraction (<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> fraction);</pre>
<p>
Causes the progress bar to "fill in" the given fraction
of the bar. The fraction should be between 0.0 and 1.0,
inclusive.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>pbar</code></em> :</span></td>
<td> a <a href="GtkProgressBar.html" title="GtkProgressBar"><span class="type">GtkProgressBar</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>fraction</code></em> :</span></td>
<td> fraction of the task that's been completed
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2884121"></a><h3>
<a name="gtk-progress-bar-set-pulse-step"></a>gtk_progress_bar_set_pulse_step ()</h3>
<a class="indexterm" name="id2884135"></a><pre class="programlisting">void gtk_progress_bar_set_pulse_step (<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> fraction);</pre>
<p>
Sets the fraction of total progress bar length to move the
bouncing block for each call to <a href="GtkProgressBar.html#gtk-progress-bar-pulse"><code class="function">gtk_progress_bar_pulse()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>pbar</code></em> :</span></td>
<td> a <a href="GtkProgressBar.html" title="GtkProgressBar"><span class="type">GtkProgressBar</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>fraction</code></em> :</span></td>
<td> fraction between 0.0 and 1.0
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2884227"></a><h3>
<a name="gtk-progress-bar-set-orientation"></a>gtk_progress_bar_set_orientation ()</h3>
<a class="indexterm" name="id2884240"></a><pre class="programlisting">void gtk_progress_bar_set_orientation
(<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar,
<a href="GtkProgressBar.html#GtkProgressBarOrientation">GtkProgressBarOrientation</a> orientation);</pre>
<p>
Causes the progress bar to switch to a different orientation
(left-to-right, right-to-left, top-to-bottom, or bottom-to-top).</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>pbar</code></em> :</span></td>
<td> a <a href="GtkProgressBar.html" title="GtkProgressBar"><span class="type">GtkProgressBar</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>orientation</code></em> :</span></td>
<td> orientation of the progress bar
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2884324"></a><h3>
<a name="gtk-progress-bar-set-ellipsize"></a>gtk_progress_bar_set_ellipsize ()</h3>
<a class="indexterm" name="id2884340"></a><pre class="programlisting">void gtk_progress_bar_set_ellipsize (<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar,
<a
href="../pango/pango-Layout-Objects.html#PangoEllipsizeMode"
>PangoEllipsizeMode</a> mode);</pre>
<p>
Sets the mode used to ellipsize (add an ellipsis: "...") the text
if there is not enough space to render the entire string.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>pbar</code></em> :</span></td>
<td> a <a href="GtkProgressBar.html" title="GtkProgressBar"><span class="type">GtkProgressBar</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>mode</code></em> :</span></td>
<td> a <a
href="../pango/pango-Layout-Objects.html#PangoEllipsizeMode"
><span class="type">PangoEllipsizeMode</span></a>
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.6
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2884434"></a><h3>
<a name="GtkProgressBarOrientation"></a>enum GtkProgressBarOrientation</h3>
<a class="indexterm" name="id2884448"></a><pre class="programlisting">typedef enum
{
GTK_PROGRESS_LEFT_TO_RIGHT,
GTK_PROGRESS_RIGHT_TO_LEFT,
GTK_PROGRESS_BOTTOM_TO_TOP,
GTK_PROGRESS_TOP_TO_BOTTOM
} GtkProgressBarOrientation;
</pre>
<p>
An enumeration representing possible orientations and growth
directions for the visible progress bar.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><a name="GTK-PROGRESS-LEFT-TO-RIGHT:CAPS"></a><code class="literal">GTK_PROGRESS_LEFT_TO_RIGHT</code></span></td>
<td>A horizontal progress bar growing from left to right.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GTK-PROGRESS-RIGHT-TO-LEFT:CAPS"></a><code class="literal">GTK_PROGRESS_RIGHT_TO_LEFT</code></span></td>
<td>A horizontal progress bar growing from right to left.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GTK-PROGRESS-BOTTOM-TO-TOP:CAPS"></a><code class="literal">GTK_PROGRESS_BOTTOM_TO_TOP</code></span></td>
<td>A vertical progress bar growing from bottom to top.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GTK-PROGRESS-TOP-TO-BOTTOM:CAPS"></a><code class="literal">GTK_PROGRESS_TOP_TO_BOTTOM</code></span></td>
<td>A vertical progress bar growing from top to bottom.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2884565"></a><h3>
<a name="gtk-progress-bar-get-text"></a>gtk_progress_bar_get_text ()</h3>
<a class="indexterm" name="id2884579"></a><pre class="programlisting">const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a>* gtk_progress_bar_get_text (<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar);</pre>
<p>
Retrieves the text displayed superimposed on the progress bar,
if any, otherwise <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a>. 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.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>pbar</code></em> :</span></td>
<td> a <a href="GtkProgressBar.html" title="GtkProgressBar"><span class="type">GtkProgressBar</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> text, or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a>; this string is owned by the widget
and should not be modified or freed.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2884673"></a><h3>
<a name="gtk-progress-bar-get-fraction"></a>gtk_progress_bar_get_fraction ()</h3>
<a class="indexterm" name="id2884686"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> gtk_progress_bar_get_fraction (<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar);</pre>
<p>
Returns the current fraction of the task that's been completed.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>pbar</code></em> :</span></td>
<td> a <a href="GtkProgressBar.html" title="GtkProgressBar"><span class="type">GtkProgressBar</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> a fraction from 0.0 to 1.0
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2884756"></a><h3>
<a name="gtk-progress-bar-get-pulse-step"></a>gtk_progress_bar_get_pulse_step ()</h3>
<a class="indexterm" name="id2884769"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> gtk_progress_bar_get_pulse_step (<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar);</pre>
<p>
Retrieves the pulse step set with <a href="GtkProgressBar.html#gtk-progress-bar-set-pulse-step"><code class="function">gtk_progress_bar_set_pulse_step()</code></a></p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>pbar</code></em> :</span></td>
<td> a <a href="GtkProgressBar.html" title="GtkProgressBar"><span class="type">GtkProgressBar</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> a fraction from 0.0 to 1.0
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2884849"></a><h3>
<a name="gtk-progress-bar-get-orientation"></a>gtk_progress_bar_get_orientation ()</h3>
<a class="indexterm" name="id2884863"></a><pre class="programlisting"><a href="GtkProgressBar.html#GtkProgressBarOrientation">GtkProgressBarOrientation</a> gtk_progress_bar_get_orientation
(<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar);</pre>
<p>
Retrieves the current progress bar orientation.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>pbar</code></em> :</span></td>
<td> a <a href="GtkProgressBar.html" title="GtkProgressBar"><span class="type">GtkProgressBar</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> orientation of the progress bar
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2884934"></a><h3>
<a name="gtk-progress-bar-get-ellipsize"></a>gtk_progress_bar_get_ellipsize ()</h3>
<a class="indexterm" name="id2884950"></a><pre class="programlisting"><a
href="../pango/pango-Layout-Objects.html#PangoEllipsizeMode"
>PangoEllipsizeMode</a> gtk_progress_bar_get_ellipsize
(<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar);</pre>
<p>
Returns the ellipsizing position of the progressbar.
See <a href="GtkProgressBar.html#gtk-progress-bar-set-ellipsize"><code class="function">gtk_progress_bar_set_ellipsize()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>pbar</code></em> :</span></td>
<td> a <a href="GtkProgressBar.html" title="GtkProgressBar"><span class="type">GtkProgressBar</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> <a
href="../pango/pango-Layout-Objects.html#PangoEllipsizeMode"
><span class="type">PangoEllipsizeMode</span></a>
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.6
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2885044"></a><h3>
<a name="gtk-progress-bar-new-with-adjustment"></a>gtk_progress_bar_new_with_adjustment ()</h3>
<a class="indexterm" name="id2885059"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* gtk_progress_bar_new_with_adjustment
(<a href="GtkAdjustment.html" title="GtkAdjustment">GtkAdjustment</a> *adjustment);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_progress_bar_new_with_adjustment</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Creates a new <a href="GtkProgressBar.html" title="GtkProgressBar"><span class="type">GtkProgressBar</span></a> with an associated <a href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>adjustment</code></em> :</span></td>
<td>a <a href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>a <a href="GtkProgressBar.html" title="GtkProgressBar"><span class="type">GtkProgressBar</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2885164"></a><h3>
<a name="gtk-progress-bar-set-bar-style"></a>gtk_progress_bar_set_bar_style ()</h3>
<a class="indexterm" name="id2885180"></a><pre class="programlisting">void gtk_progress_bar_set_bar_style (<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar,
<a href="GtkProgressBar.html#GtkProgressBarStyle">GtkProgressBarStyle</a> style);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_progress_bar_set_bar_style</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Sets the style of the <a href="GtkProgressBar.html" title="GtkProgressBar"><span class="type">GtkProgressBar</span></a>. The default style is
<a href="GtkProgressBar.html#GTK-PROGRESS-CONTINUOUS:CAPS"><code class="literal">GTK_PROGRESS_CONTINUOUS</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>pbar</code></em> :</span></td>
<td>a <a href="GtkProgressBar.html" title="GtkProgressBar"><span class="type">GtkProgressBar</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>style</code></em> :</span></td>
<td>a <a href="GtkProgressBar.html#GtkProgressBarStyle"><span class="type">GtkProgressBarStyle</span></a> value indicating the desired style.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2885300"></a><h3>
<a name="GtkProgressBarStyle"></a>enum GtkProgressBarStyle</h3>
<a class="indexterm" name="id2885314"></a><pre class="programlisting">typedef enum
{
GTK_PROGRESS_CONTINUOUS,
GTK_PROGRESS_DISCRETE
} GtkProgressBarStyle;
</pre>
<p>
An enumeration representing the styles for drawing the progress bar.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><a name="GTK-PROGRESS-CONTINUOUS:CAPS"></a><code class="literal">GTK_PROGRESS_CONTINUOUS</code></span></td>
<td>The progress bar grows in a smooth, continuous manner.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GTK-PROGRESS-DISCRETE:CAPS"></a><code class="literal">GTK_PROGRESS_DISCRETE</code></span></td>
<td>The progress bar grows in discrete, visible blocks.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2885381"></a><h3>
<a name="gtk-progress-bar-set-discrete-blocks"></a>gtk_progress_bar_set_discrete_blocks ()</h3>
<a class="indexterm" name="id2885397"></a><pre class="programlisting">void gtk_progress_bar_set_discrete_blocks
(<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> blocks);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_progress_bar_set_discrete_blocks</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Sets the number of blocks that the progress bar is divided into
when the style is <a href="GtkProgressBar.html#GTK-PROGRESS-DISCRETE:CAPS"><code class="literal">GTK_PROGRESS_DISCRETE</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>pbar</code></em> :</span></td>
<td>a <a href="GtkProgressBar.html" title="GtkProgressBar"><span class="type">GtkProgressBar</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>blocks</code></em> :</span></td>
<td>number of individual blocks making up the bar.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2885500"></a><h3>
<a name="gtk-progress-bar-set-activity-step"></a>gtk_progress_bar_set_activity_step ()</h3>
<a class="indexterm" name="id2885516"></a><pre class="programlisting">void gtk_progress_bar_set_activity_step
(<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> step);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_progress_bar_set_activity_step</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Sets the step value used when the progress bar is in activity
mode. The step is the amount by which the progress is incremented
each iteration.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>pbar</code></em> :</span></td>
<td>a <a href="GtkProgressBar.html" title="GtkProgressBar"><span class="type">GtkProgressBar</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>step</code></em> :</span></td>
<td>the amount which the progress is incremented in activity
mode.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2885608"></a><h3>
<a name="gtk-progress-bar-set-activity-blocks"></a>gtk_progress_bar_set_activity_blocks ()</h3>
<a class="indexterm" name="id2885624"></a><pre class="programlisting">void gtk_progress_bar_set_activity_blocks
(<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> blocks);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_progress_bar_set_activity_blocks</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Sets the number of blocks used when the progress bar is in activity
mode. Larger numbers make the visible block smaller.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>pbar</code></em> :</span></td>
<td>a <a href="GtkProgressBar.html" title="GtkProgressBar"><span class="type">GtkProgressBar</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>blocks</code></em> :</span></td>
<td>number of blocks which can fit within the progress bar area.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2885717"></a><h3>
<a name="gtk-progress-bar-update"></a>gtk_progress_bar_update ()</h3>
<a class="indexterm" name="id2885733"></a><pre class="programlisting">void gtk_progress_bar_update (<a href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a> *pbar,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> percentage);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_progress_bar_update</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
This function is deprecated. Please use <a href="GtkProgress.html#gtk-progress-set-value"><code class="function">gtk_progress_set_value()</code></a> or
<a href="GtkProgress.html#gtk-progress-set-percentage"><code class="function">gtk_progress_set_percentage()</code></a> instead.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>pbar</code></em> :</span></td>
<td>a <a href="GtkProgressBar.html" title="GtkProgressBar"><span class="type">GtkProgressBar</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>percentage</code></em> :</span></td>
<td>the new percent complete value.
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id2885849"></a><h2>Property Details</h2>
<div class="refsect2" lang="en">
<a name="id2885859"></a><h3>
<a name="GtkProgressBar--activity-blocks"></a>The "<code class="literal">activity-blocks</code>" property</h3>
<a class="indexterm" name="id2885876"></a><pre class="programlisting"> "activity-blocks" <a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> : Read / Write</pre>
<p>The number of blocks which can fit in the progress bar area in activity mode (Deprecated).</p>
<p>Allowed values: >= 2</p>
<p>Default value: 5</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2885908"></a><h3>
<a name="GtkProgressBar--activity-step"></a>The "<code class="literal">activity-step</code>" property</h3>
<a class="indexterm" name="id2885925"></a><pre class="programlisting"> "activity-step" <a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> : Read / Write</pre>
<p>The increment used for each iteration in activity mode (Deprecated).</p>
<p>Default value: 3</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2885952"></a><h3>
<a name="GtkProgressBar--adjustment"></a>The "<code class="literal">adjustment</code>" property</h3>
<a class="indexterm" name="id2885968"></a><pre class="programlisting"> "adjustment" <a href="GtkAdjustment.html" title="GtkAdjustment">GtkAdjustment</a> : Read / Write</pre>
<p>The GtkAdjustment connected to the progress bar (Deprecated).</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2885992"></a><h3>
<a name="GtkProgressBar--bar-style"></a>The "<code class="literal">bar-style</code>" property</h3>
<a class="indexterm" name="id2886009"></a><pre class="programlisting"> "bar-style" <a href="GtkProgressBar.html#GtkProgressBarStyle">GtkProgressBarStyle</a> : Read / Write</pre>
<p>Specifies the visual style of the bar in percentage mode (Deprecated).</p>
<p>Default value: GTK_PROGRESS_CONTINUOUS</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2886036"></a><h3>
<a name="GtkProgressBar--discrete-blocks"></a>The "<code class="literal">discrete-blocks</code>" property</h3>
<a class="indexterm" name="id2886053"></a><pre class="programlisting"> "discrete-blocks" <a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> : Read / Write</pre>
<p>The number of discrete blocks in a progress bar (when shown in the discrete style).</p>
<p>Allowed values: >= 2</p>
<p>Default value: 10</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2886084"></a><h3>
<a name="GtkProgressBar--ellipsize"></a>The "<code class="literal">ellipsize</code>" property</h3>
<a class="indexterm" name="id2886100"></a><pre class="programlisting"> "ellipsize" <a
href="../pango/pango-Layout-Objects.html#PangoEllipsizeMode"
>PangoEllipsizeMode</a> : Read / Write</pre>
<p>
The preferred place to ellipsize the string, if the progressbar does
not have enough room to display the entire string, specified as a
<span class="type">PangoEllisizeMode</span>.
</p>
<p>
Note that setting this property to a value other than
<a
href="../pango/pango-Layout-Objects.html#PANGO-ELLIPSIZE-NONE:CAPS"
><code class="literal">PANGO_ELLIPSIZE_NONE</code></a> has the side-effect that the progressbar requests
only enough space to display the ellipsis "...". Another means to set a
progressbar's width is <a href="GtkWidget.html#gtk-widget-set-size-request"><code class="function">gtk_widget_set_size_request()</code></a>.</p>
<p>
</p>
<p>Default value: PANGO_ELLIPSIZE_NONE</p>
<p>Since 2.6
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2886175"></a><h3>
<a name="GtkProgressBar--fraction"></a>The "<code class="literal">fraction</code>" property</h3>
<a class="indexterm" name="id2886191"></a><pre class="programlisting"> "fraction" <a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> : Read / Write</pre>
<p>The fraction of total work that has been completed.</p>
<p>Allowed values: [0,1]</p>
<p>Default value: 0</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2886222"></a><h3>
<a name="GtkProgressBar--orientation"></a>The "<code class="literal">orientation</code>" property</h3>
<a class="indexterm" name="id2886238"></a><pre class="programlisting"> "orientation" <a href="GtkProgressBar.html#GtkProgressBarOrientation">GtkProgressBarOrientation</a> : Read / Write</pre>
<p>Orientation and growth direction of the progress bar.</p>
<p>Default value: GTK_PROGRESS_LEFT_TO_RIGHT</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2886266"></a><h3>
<a name="GtkProgressBar--pulse-step"></a>The "<code class="literal">pulse-step</code>" property</h3>
<a class="indexterm" name="id2886282"></a><pre class="programlisting"> "pulse-step" <a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> : Read / Write</pre>
<p>The fraction of total progress to move the bouncing block when pulsed.</p>
<p>Allowed values: [0,1]</p>
<p>Default value: 0.1</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2886313"></a><h3>
<a name="GtkProgressBar--text"></a>The "<code class="literal">text</code>" property</h3>
<a class="indexterm" name="id2886329"></a><pre class="programlisting"> "text" <a
href="../gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Read / Write</pre>
<p>Text to be displayed in the progress bar.</p>
<p>Default value: "%P %%"</p>
</div>
</div>
</div>
</body>
</html>