Top |
Description
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.
Functions
gtk_cell_renderer_progress_new ()
GtkCellRenderer *
gtk_cell_renderer_progress_new (void
);
Creates a new GtkCellRendererProgress.
Since 2.6
Property Details
The “inverted”
property
“inverted” gboolean
Invert the direction in which the progress bar grows.
Flags: Read / Write
Default value: FALSE
The “pulse”
property
“pulse” gint
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
.
Flags: Read / Write
Allowed values: >= -1
Default value: -1
Since 2.12
The “text”
property
“text” gchar *
The "text" property determines the label which will be drawn
over the progress bar. Setting this property to NULL
causes the default
label to be displayed. Setting this property to an empty string causes
no label to be displayed.
Flags: Read / Write
Default value: NULL
Since 2.6
The “text-xalign”
property
“text-xalign” gfloat
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.
Flags: Read / Write
Allowed values: [0,1]
Default value: 0.5
Since 2.12
The “text-yalign”
property
“text-yalign” gfloat
The "text-yalign" property controls the vertical alignment of the text in the progress bar. Valid values range from 0 (top) to 1 (bottom).
Flags: Read / Write
Allowed values: [0,1]
Default value: 0.5
Since 2.12
The “value”
property
“value” gint
The "value" property determines the percentage to which the progress bar will be "filled in".
Flags: Read / Write
Allowed values: [0,100]
Default value: 0
Since 2.6