GTK+ 2 Reference Manual | ||||
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties |
#include <gtk/gtk.h>
struct GtkCellRendererSpinner;
GtkCellRenderer * gtk_cell_renderer_spinner_new (void
);
GObject +----GInitiallyUnowned +----GtkObject +----GtkCellRenderer +----GtkCellRendererSpinner
"active" gboolean : Read / Write "pulse" guint : Read / Write "size" GtkIconSize : Read / Write
GtkCellRendererSpinner renders a spinning animation in a cell, very similar to GtkSpinner. It can often be used as an alternative to a GtkCellRendererProgress for displaying indefinite activity, instead of actual progress.
To start the animation in a cell, set the "active"
property to TRUE
and increment the "pulse" property
at regular intervals. The usual way to set the cell renderer properties
for each cell is to bind them to columns in your tree model using e.g.
gtk_tree_view_column_add_attribute()
.
GtkCellRenderer * gtk_cell_renderer_spinner_new (void
);
Returns a new cell renderer which will show a spinner to indicate activity.
Returns : |
a new GtkCellRenderer |
Since 2.20
"active"
property"active" gboolean : Read / Write
Whether the spinner is active (ie. shown) in the cell.
Default value: FALSE
"pulse"
property"pulse" guint : Read / Write
Pulse of the spinner. Increment this value to draw the next frame of the spinner animation. Usually, you would update this value in a timeout.
The GtkSpinner widget draws one full cycle of the animation per second by default. You can learn about the number of frames used by the theme by looking at the "num-steps" style property and the duration of the cycle by looking at "cycle-duration".
Default value: 0
Since 2.20
"size"
property"size" GtkIconSize : Read / Write
The GtkIconSize value that specifies the size of the rendered spinner.
Default value: GTK_ICON_SIZE_MENU
Since 2.20