1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>GtkCellRendererProgress</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7 <link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
8 <link rel="up" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
9 <link rel="prev" href="GtkCellRendererPixbuf.html" title="GtkCellRendererPixbuf">
10 <link rel="next" href="GtkCellRendererSpin.html" title="GtkCellRendererSpin">
11 <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
12 <link rel="stylesheet" href="style.css" type="text/css">
14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
17 <td><a accesskey="p" href="GtkCellRendererPixbuf.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18 <td><a accesskey="u" href="TreeWidgetObjects.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20 <th width="100%" align="center">GTK+ 3 Reference Manual</th>
21 <td><a accesskey="n" href="GtkCellRendererSpin.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
23 <tr><td colspan="5" class="shortcuts">
24 <a href="#GtkCellRendererProgress.synopsis" class="shortcut">Top</a>
26 <a href="#GtkCellRendererProgress.description" class="shortcut">Description</a>
28 <a href="#GtkCellRendererProgress.object-hierarchy" class="shortcut">Object Hierarchy</a>
30 <a href="#GtkCellRendererProgress.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
32 <a href="#GtkCellRendererProgress.properties" class="shortcut">Properties</a>
35 <div class="refentry">
36 <a name="GtkCellRendererProgress"></a><div class="titlepage"></div>
37 <div class="refnamediv"><table width="100%"><tr>
39 <h2><span class="refentrytitle"><a name="GtkCellRendererProgress.top_of_page"></a>GtkCellRendererProgress</span></h2>
40 <p>GtkCellRendererProgress — Renders numbers as progress bars</p>
42 <td valign="top" align="right"></td>
44 <div class="refsynopsisdiv">
45 <a name="GtkCellRendererProgress.synopsis"></a><h2>Synopsis</h2>
46 <pre class="synopsis">
47 #include <gtk/gtk.h>
49 struct <a class="link" href="GtkCellRendererProgress.html#GtkCellRendererProgress-struct" title="struct GtkCellRendererProgress">GtkCellRendererProgress</a>;
50 <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="returnvalue">GtkCellRenderer</span></a> * <a class="link" href="GtkCellRendererProgress.html#gtk-cell-renderer-progress-new" title="gtk_cell_renderer_progress_new ()">gtk_cell_renderer_progress_new</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
53 <div class="refsect1">
54 <a name="GtkCellRendererProgress.object-hierarchy"></a><h2>Object Hierarchy</h2>
55 <pre class="synopsis">
56 <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
57 +----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
58 +----<a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer">GtkCellRenderer</a>
59 +----GtkCellRendererProgress
62 <div class="refsect1">
63 <a name="GtkCellRendererProgress.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
65 GtkCellRendererProgress implements
66 <a class="link" href="gtk3-Orientable.html#GtkOrientable">GtkOrientable</a>.</p>
68 <div class="refsect1">
69 <a name="GtkCellRendererProgress.properties"></a><h2>Properties</h2>
70 <pre class="synopsis">
71 "<a class="link" href="GtkCellRendererProgress.html#GtkCellRendererProgress--inverted" title='The "inverted" property'>inverted</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write
72 "<a class="link" href="GtkCellRendererProgress.html#GtkCellRendererProgress--pulse" title='The "pulse" property'>pulse</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write
73 "<a class="link" href="GtkCellRendererProgress.html#GtkCellRendererProgress--text" title='The "text" property'>text</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write
74 "<a class="link" href="GtkCellRendererProgress.html#GtkCellRendererProgress--text-xalign" title='The "text-xalign" property'>text-xalign</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> : Read / Write
75 "<a class="link" href="GtkCellRendererProgress.html#GtkCellRendererProgress--text-yalign" title='The "text-yalign" property'>text-yalign</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> : Read / Write
76 "<a class="link" href="GtkCellRendererProgress.html#GtkCellRendererProgress--value" title='The "value" property'>value</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write
79 <div class="refsect1">
80 <a name="GtkCellRendererProgress.description"></a><h2>Description</h2>
82 <a class="link" href="GtkCellRendererProgress.html" title="GtkCellRendererProgress"><span class="type">GtkCellRendererProgress</span></a> renders a numeric value as a progress par in a cell.
83 Additionally, it can display a text on top of the progress bar.
86 The <a class="link" href="GtkCellRendererProgress.html" title="GtkCellRendererProgress"><span class="type">GtkCellRendererProgress</span></a> cell renderer was added in GTK+ 2.6.
89 <div class="refsect1">
90 <a name="GtkCellRendererProgress.details"></a><h2>Details</h2>
91 <div class="refsect2">
92 <a name="GtkCellRendererProgress-struct"></a><h3>struct GtkCellRendererProgress</h3>
93 <pre class="programlisting">struct GtkCellRendererProgress;</pre>
96 <div class="refsect2">
97 <a name="gtk-cell-renderer-progress-new"></a><h3>gtk_cell_renderer_progress_new ()</h3>
98 <pre class="programlisting"><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="returnvalue">GtkCellRenderer</span></a> * gtk_cell_renderer_progress_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
100 Creates a new <a class="link" href="GtkCellRendererProgress.html" title="GtkCellRendererProgress"><span class="type">GtkCellRendererProgress</span></a>.
102 <div class="variablelist"><table border="0">
103 <col align="left" valign="top">
105 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
106 <td>the new cell renderer</td>
109 <p class="since">Since 2.6</p>
112 <div class="refsect1">
113 <a name="GtkCellRendererProgress.property-details"></a><h2>Property Details</h2>
114 <div class="refsect2">
115 <a name="GtkCellRendererProgress--inverted"></a><h3>The <code class="literal">"inverted"</code> property</h3>
116 <pre class="programlisting"> "inverted" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre>
117 <p>Invert the direction in which the progress bar grows.</p>
118 <p>Default value: FALSE</p>
121 <div class="refsect2">
122 <a name="GtkCellRendererProgress--pulse"></a><h3>The <code class="literal">"pulse"</code> property</h3>
123 <pre class="programlisting"> "pulse" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write</pre>
125 Setting this to a non-negative value causes the cell renderer to
126 enter "activity mode", where a block bounces back and forth to
127 indicate that some progress is made, without specifying exactly how
131 Each increment of the property causes the block to move by a little
135 To indicate that the activity has not started yet, set the property
136 to zero. To indicate completion, set the property to <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#G-MAXINT:CAPS"><code class="literal">G_MAXINT</code></a>.
138 <p>Allowed values: >= G_MAXULONG</p>
139 <p>Default value: -1</p>
140 <p class="since">Since 2.12</p>
143 <div class="refsect2">
144 <a name="GtkCellRendererProgress--text"></a><h3>The <code class="literal">"text"</code> property</h3>
145 <pre class="programlisting"> "text" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write</pre>
147 The "text" property determines the label which will be drawn
148 over the progress bar. Setting this property to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> causes the default
149 label to be displayed. Setting this property to an empty string causes
150 no label to be displayed.
152 <p>Default value: NULL</p>
153 <p class="since">Since 2.6</p>
156 <div class="refsect2">
157 <a name="GtkCellRendererProgress--text-xalign"></a><h3>The <code class="literal">"text-xalign"</code> property</h3>
158 <pre class="programlisting"> "text-xalign" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> : Read / Write</pre>
160 The "text-xalign" property controls the horizontal alignment of the
161 text in the progress bar. Valid values range from 0 (left) to 1
162 (right). Reserved for RTL layouts.
164 <p>Allowed values: [0,1]</p>
165 <p>Default value: 0.5</p>
166 <p class="since">Since 2.12</p>
169 <div class="refsect2">
170 <a name="GtkCellRendererProgress--text-yalign"></a><h3>The <code class="literal">"text-yalign"</code> property</h3>
171 <pre class="programlisting"> "text-yalign" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> : Read / Write</pre>
173 The "text-yalign" property controls the vertical alignment of the
174 text in the progress bar. Valid values range from 0 (top) to 1
177 <p>Allowed values: [0,1]</p>
178 <p>Default value: 0.5</p>
179 <p class="since">Since 2.12</p>
182 <div class="refsect2">
183 <a name="GtkCellRendererProgress--value"></a><h3>The <code class="literal">"value"</code> property</h3>
184 <pre class="programlisting"> "value" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write</pre>
186 The "value" property determines the percentage to which the
187 progress bar will be "filled in".
189 <p>Allowed values: [0,100]</p>
190 <p>Default value: 0</p>
191 <p class="since">Since 2.6</p>
197 Generated by GTK-Doc V1.18</div>