![]() |
![]() |
![]() |
GTK+ Reference Manual | ![]() |
---|---|---|---|---|
#include <gtk/gtk.h> GtkCellRendererProgress; GtkCellRenderer* gtk_cell_renderer_progress_new (void);
GObject +----GInitiallyUnowned +----GtkObject +----GtkCellRenderer +----GtkCellRendererProgress
orientation GtkProgressBarOrientation : Read / Write pulsegint : Read / Write textgchararray : Read / Write text-xaligngfloat : Read / Write text-yaligngfloat : Read / Write valuegint : Read / Write
GtkCellRendererProgress renders a numeric value as a progress par in a cell. Additionally, it can display a text on top of the progress bar.
The GtkCellRendererProgress cell renderer was added in GTK+ 2.6.
GtkCellRenderer* gtk_cell_renderer_progress_new (void);
Creates a new GtkCellRendererProgress.
Returns : | the new cell renderer |
Since 2.6
orientation
propertyorientation GtkProgressBarOrientation : Read / Write
The "orientation" property controls the direction and growth direction of the progress bar (left-to-right, right-to-left, top-to-bottom or bottom-to-top).
Default value: GTK_PROGRESS_LEFT_TO_RIGHT
Since 2.12
pulse
propertypulsegint : Read / Write
Setting this to a non-negative value causes the cell renderer to enter "activity mode", where a block bounces back and forth to indicate that some progress is made, without specifying exactly how much.
Each increment of the property causes the block to move by a little bit.
To indicate that the activity has not started yet, set the property
to zero. To indicate completion, set the property to G_MAXINT
Allowed values: >= -1
Default value: -1
Since 2.12
text
propertytextgchararray : Read / Write
The "text" property determines the label which will be drawn
over the progress bar. Setting this property to NULL
Default value: NULL
Since 2.6
text-xalign
propertytext-xaligngfloat : Read / Write
The "text-xalign" property controls the horizontal alignment of the text in the progress bar. Valid values range from 0 (left) to 1 (right). Reserved for RTL layouts.
Allowed values: [0,1]
Default value: 0.5
Since 2.12
text-yalign
propertytext-yaligngfloat : Read / Write
The "text-yalign" property controls the vertical alignment of the text in the progress bar. Valid values range from 0 (top) to 1 (bottom).
Allowed values: [0,1]
Default value: 0.5
Since 2.12