GtkCellRendererSpinner

GtkCellRendererSpinner — Renders a spinning animation in a cell

Synopsis

#include <gtk/gtk.h>

struct              GtkCellRendererSpinner;
GtkCellRenderer *   gtk_cell_renderer_spinner_new       (void);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkCellRenderer
                     +----GtkCellRendererSpinner

Properties

  "active"                   gboolean              : Read / Write
  "pulse"                    guint                 : Read / Write
  "size"                     GtkIconSize           : Read / Write

Description

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().

Details

struct GtkCellRendererSpinner

struct GtkCellRendererSpinner;


gtk_cell_renderer_spinner_new ()

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

Property Details

The "active" property

  "active"                   gboolean              : Read / Write

Whether the spinner is active (ie. shown) in the cell.

Default value: FALSE


The "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


The "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

See Also

GtkSpinner, GtkCellRendererProgress