1 /* GTK - The GIMP Toolkit
3 * Copyright (C) 2009 Matthias Clasen <mclasen@redhat.com>
4 * Copyright (C) 2008 Richard Hughes <richard@hughsie.com>
5 * Copyright (C) 2009 Bastien Nocera <hadess@hadess.net>
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2 of the License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with this library; if not, write to the
19 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 * Boston, MA 02111-1307, USA.
24 * Modified by the GTK+ Team and others 2007. See the AUTHORS
25 * file for a list of people on the GTK+ Team. See the ChangeLog
26 * files for a list of changes. These files are distributed with
27 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
32 #include "gtkcellrendererspinner.h"
33 #include "gtkiconfactory.h"
34 #include "gtkicontheme.h"
40 * SECTION:gtkcellrendererspinner
41 * @Short_description: Renders a spinning animation in a cell
42 * @Title: GtkCellRendererSpinner
43 * @See_also: #GtkSpinner, #GtkCellRendererProgress
45 * GtkCellRendererSpinner renders a spinning animation in a cell, very
46 * similar to #GtkSpinner. It can often be used as an alternative
47 * to a #GtkCellRendererProgress for displaying indefinite activity,
48 * instead of actual progress.
50 * To start the animation in a cell, set the #GtkCellRendererSpinner:active
51 * property to %TRUE and increment the #GtkCellRendererSpinner:pulse property
52 * at regular intervals. The usual way to set the cell renderer properties
53 * for each cell is to bind them to columns in your tree model using e.g.
54 * gtk_tree_view_column_add_attribute().
65 struct _GtkCellRendererSpinnerPrivate
69 GtkIconSize icon_size, old_icon_size;
73 #define GTK_CELL_RENDERER_SPINNER_GET_PRIVATE(object) \
74 (G_TYPE_INSTANCE_GET_PRIVATE ((object), \
75 GTK_TYPE_CELL_RENDERER_SPINNER, \
76 GtkCellRendererSpinnerPrivate))
78 static void gtk_cell_renderer_spinner_get_property (GObject *object,
82 static void gtk_cell_renderer_spinner_set_property (GObject *object,
86 static void gtk_cell_renderer_spinner_get_size (GtkCellRenderer *cell,
88 GdkRectangle *cell_area,
93 static void gtk_cell_renderer_spinner_render (GtkCellRenderer *cell,
96 GdkRectangle *background_area,
97 GdkRectangle *cell_area,
98 GdkRectangle *expose_area,
101 G_DEFINE_TYPE (GtkCellRendererSpinner, gtk_cell_renderer_spinner, GTK_TYPE_CELL_RENDERER)
104 gtk_cell_renderer_spinner_class_init (GtkCellRendererSpinnerClass *klass)
106 GObjectClass *object_class = G_OBJECT_CLASS (klass);
107 GtkCellRendererClass *cell_class = GTK_CELL_RENDERER_CLASS (klass);
109 object_class->get_property = gtk_cell_renderer_spinner_get_property;
110 object_class->set_property = gtk_cell_renderer_spinner_set_property;
112 cell_class->get_size = gtk_cell_renderer_spinner_get_size;
113 cell_class->render = gtk_cell_renderer_spinner_render;
115 /* GtkCellRendererSpinner:active:
117 * Whether the spinner is active (ie. shown) in the cell
121 g_object_class_install_property (object_class,
123 g_param_spec_boolean ("active",
125 P_("Whether the spinner is active (ie. shown) in the cell"),
129 * GtkCellRendererSpinner:pulse:
131 * Pulse of the spinner. Increment this value to draw the next frame of the
132 * spinner animation. Usually, you would update this value in a timeout.
134 * The #GtkSpinner widget draws one full cycle of the animation per second by default.
135 * You can learn about the number of frames used by the theme
136 * by looking at the #GtkSpinner:num-steps style property and the duration
137 * of the cycle by looking at #GtkSpinner:cycle-duration.
141 g_object_class_install_property (object_class,
143 g_param_spec_uint ("pulse",
145 P_("Pulse of the spinner"),
149 * GtkCellRendererSpinner:size:
151 * The #GtkIconSize value that specifies the size of the rendered spinner.
155 g_object_class_install_property (object_class,
157 g_param_spec_enum ("size",
159 P_("The GtkIconSize value that specifies the size of the rendered spinner"),
160 GTK_TYPE_ICON_SIZE, GTK_ICON_SIZE_MENU,
164 g_type_class_add_private (object_class, sizeof (GtkCellRendererSpinnerPrivate));
168 gtk_cell_renderer_spinner_init (GtkCellRendererSpinner *cell)
170 cell->priv = GTK_CELL_RENDERER_SPINNER_GET_PRIVATE (cell);
171 cell->priv->pulse = 0;
172 cell->priv->old_icon_size = GTK_ICON_SIZE_INVALID;
173 cell->priv->icon_size = GTK_ICON_SIZE_MENU;
177 * gtk_cell_renderer_spinner_new
179 * Returns a new cell renderer which will show a spinner to indicate
182 * Return value: a new #GtkCellRenderer
187 gtk_cell_renderer_spinner_new (void)
189 return g_object_new (GTK_TYPE_CELL_RENDERER_SPINNER, NULL);
193 gtk_cell_renderer_spinner_update_size (GtkCellRendererSpinner *cell,
196 GtkCellRendererSpinnerPrivate *priv = cell->priv;
198 GtkIconTheme *icon_theme;
199 GtkSettings *settings;
201 if (cell->priv->old_icon_size == cell->priv->icon_size)
204 screen = gtk_widget_get_screen (GTK_WIDGET (widget));
205 icon_theme = gtk_icon_theme_get_for_screen (screen);
206 settings = gtk_settings_get_for_screen (screen);
208 if (!gtk_icon_size_lookup_for_settings (settings, priv->icon_size, &priv->size, NULL))
210 g_warning ("Invalid icon size %u\n", priv->icon_size);
216 gtk_cell_renderer_spinner_get_property (GObject *object,
221 GtkCellRendererSpinner *cell = GTK_CELL_RENDERER_SPINNER (object);
222 GtkCellRendererSpinnerPrivate *priv = cell->priv;
227 g_value_set_boolean (value, priv->active);
230 g_value_set_uint (value, priv->pulse);
233 g_value_set_enum (value, priv->icon_size);
236 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
241 gtk_cell_renderer_spinner_set_property (GObject *object,
246 GtkCellRendererSpinner *cell = GTK_CELL_RENDERER_SPINNER (object);
247 GtkCellRendererSpinnerPrivate *priv = cell->priv;
252 priv->active = g_value_get_boolean (value);
255 priv->pulse = g_value_get_uint (value);
258 priv->old_icon_size = priv->icon_size;
259 priv->icon_size = g_value_get_enum (value);
262 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
267 gtk_cell_renderer_spinner_get_size (GtkCellRenderer *cellr,
269 GdkRectangle *cell_area,
275 GtkCellRendererSpinner *cell = GTK_CELL_RENDERER_SPINNER (cellr);
276 GtkCellRendererSpinnerPrivate *priv = cell->priv;
280 gfloat xalign, yalign;
283 rtl = gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL;
285 gtk_cell_renderer_spinner_update_size (cell, widget);
299 align = rtl ? 1.0 - xalign : xalign;
300 *x_offset = align * (cell_area->width - w);
301 *x_offset = MAX (*x_offset, 0);
305 align = rtl ? 1.0 - yalign : yalign;
306 *y_offset = align * (cell_area->height - h);
307 *y_offset = MAX (*y_offset, 0);
325 gtk_cell_renderer_spinner_render (GtkCellRenderer *cellr,
328 GdkRectangle *background_area,
329 GdkRectangle *cell_area,
330 GdkRectangle *expose_area,
333 GtkCellRendererSpinner *cell = GTK_CELL_RENDERER_SPINNER (cellr);
334 GtkCellRendererSpinnerPrivate *priv = cell->priv;
336 GdkRectangle pix_rect;
337 GdkRectangle draw_rect;
343 gtk_cell_renderer_spinner_get_size (cellr, widget, cell_area,
344 &pix_rect.x, &pix_rect.y,
345 &pix_rect.width, &pix_rect.height);
351 pix_rect.x += cell_area->x + xpad;
352 pix_rect.y += cell_area->y + ypad;
353 pix_rect.width -= xpad * 2;
354 pix_rect.height -= ypad * 2;
356 if (!gdk_rectangle_intersect (cell_area, &pix_rect, &draw_rect) ||
357 !gdk_rectangle_intersect (expose_area, &pix_rect, &draw_rect))
362 state = GTK_STATE_NORMAL;
363 if (GTK_WIDGET_STATE (widget) == GTK_STATE_INSENSITIVE || !cellr->sensitive)
365 state = GTK_STATE_INSENSITIVE;
369 if ((flags & GTK_CELL_RENDERER_SELECTED) != 0)
371 if (gtk_widget_has_focus (widget))
372 state = GTK_STATE_SELECTED;
374 state = GTK_STATE_ACTIVE;
377 state = GTK_STATE_PRELIGHT;
380 gtk_paint_spinner (widget->style,
387 draw_rect.x, draw_rect.y,
388 draw_rect.width, draw_rect.height);
391 #define __GTK_CELL_RENDERER_SPINNER_C__
392 #include "gtkaliasdef.c"