gtkspinner.c 7.99 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
/* GTK - The GIMP Toolkit
 *
 * Copyright (C) 2007 John Stowers, Neil Jagdish Patel.
 * Copyright (C) 2009 Bastien Nocera, David Zeuthen
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.	 See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
Javier Jardón's avatar
Javier Jardón committed
17
 * License along with this library. If not, see <http://www.gnu.org/licenses/>.
18 19 20 21 22 23 24 25 26 27 28 29 30 31 32
 *
 * Code adapted from egg-spinner
 * by Christian Hergert <christian.hergert@gmail.com>
 */

/*
 * Modified by the GTK+ Team and others 2007.  See the AUTHORS
 * file for a list of people on the GTK+ Team.  See the ChangeLog
 * files for a list of changes.  These files are distributed with
 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
 */

#include "config.h"

#include "gtkspinner.h"
33 34 35 36

#include "gtkimage.h"
#include "gtkintl.h"
#include "gtkstylecontext.h"
Matthias Clasen's avatar
Matthias Clasen committed
37
#include "a11y/gtkspinneraccessible.h"
38

39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54

/**
 * SECTION:gtkspinner
 * @Short_description: Show a spinner animation
 * @Title: GtkSpinner
 * @See_also: #GtkCellRendererSpinner, #GtkProgressBar
 *
 * A GtkSpinner widget displays an icon-size spinning animation.
 * It is often used as an alternative to a #GtkProgressBar for
 * displaying indefinite activity, instead of actual progress.
 *
 * To start the animation, use gtk_spinner_start(), to stop it
 * use gtk_spinner_stop().
 */


55 56
#define SPINNER_SIZE 12

57 58 59 60 61 62 63
enum {
  PROP_0,
  PROP_ACTIVE
};

struct _GtkSpinnerPrivate
{
64
  gboolean active;
65 66
};

Benjamin Otte's avatar
Benjamin Otte committed
67 68
static gboolean gtk_spinner_draw       (GtkWidget       *widget,
                                        cairo_t         *cr);
69 70 71 72 73 74 75 76
static void gtk_spinner_get_property   (GObject         *object,
                                        guint            param_id,
                                        GValue          *value,
                                        GParamSpec      *pspec);
static void gtk_spinner_set_property   (GObject         *object,
                                        guint            param_id,
                                        const GValue    *value,
                                        GParamSpec      *pspec);
77 78
static void gtk_spinner_set_active     (GtkSpinner      *spinner,
                                        gboolean         active);
79 80 81 82 83 84 85
static void gtk_spinner_get_preferred_width (GtkWidget  *widget,
                                        gint            *minimum_size,
                                        gint            *natural_size);
static void gtk_spinner_get_preferred_height (GtkWidget *widget,
                                        gint            *minimum_size,
                                        gint            *natural_size);

86

87
G_DEFINE_TYPE (GtkSpinner, gtk_spinner, GTK_TYPE_WIDGET)
88

89 90 91 92 93 94 95 96 97 98 99 100
static void
gtk_spinner_class_init (GtkSpinnerClass *klass)
{
  GObjectClass *gobject_class;
  GtkWidgetClass *widget_class;

  gobject_class = G_OBJECT_CLASS(klass);
  g_type_class_add_private (gobject_class, sizeof (GtkSpinnerPrivate));
  gobject_class->get_property = gtk_spinner_get_property;
  gobject_class->set_property = gtk_spinner_set_property;

  widget_class = GTK_WIDGET_CLASS(klass);
Benjamin Otte's avatar
Benjamin Otte committed
101
  widget_class->draw = gtk_spinner_draw;
102 103
  widget_class->get_preferred_width = gtk_spinner_get_preferred_width;
  widget_class->get_preferred_height = gtk_spinner_get_preferred_height;
104

105
  /* GtkSpinner:active:
106 107 108
   *
   * Whether the spinner is active
   *
109
   * Since: 2.20
110 111 112 113 114 115 116 117
   */
  g_object_class_install_property (gobject_class,
                                   PROP_ACTIVE,
                                   g_param_spec_boolean ("active",
                                                         P_("Active"),
                                                         P_("Whether the spinner is active"),
                                                         FALSE,
                                                         G_PARAM_READWRITE));
118

119
  gtk_widget_class_set_accessible_type (widget_class, GTK_TYPE_SPINNER_ACCESSIBLE);
120 121 122 123 124 125 126 127 128 129
}

static void
gtk_spinner_get_property (GObject    *object,
                          guint       param_id,
                          GValue     *value,
                          GParamSpec *pspec)
{
  GtkSpinnerPrivate *priv;

130
  priv = GTK_SPINNER (object)->priv;
131 132 133 134

  switch (param_id)
    {
      case PROP_ACTIVE:
135
        g_value_set_boolean (value, priv->active);
136 137 138 139 140 141 142 143 144 145 146 147 148 149 150
        break;
      default:
        G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
    }
}

static void
gtk_spinner_set_property (GObject      *object,
                          guint         param_id,
                          const GValue *value,
                          GParamSpec   *pspec)
{
  switch (param_id)
    {
      case PROP_ACTIVE:
151
        gtk_spinner_set_active (GTK_SPINNER (object), g_value_get_boolean (value));
152 153 154 155 156 157 158 159 160 161
        break;
      default:
        G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
    }
}

static void
gtk_spinner_init (GtkSpinner *spinner)
{
  GtkSpinnerPrivate *priv;
162
  GtkStyleContext *context;
163

164 165 166
  priv = G_TYPE_INSTANCE_GET_PRIVATE (spinner,
                                      GTK_TYPE_SPINNER,
                                      GtkSpinnerPrivate);
167 168
  spinner->priv = priv;

169
  gtk_widget_set_has_window (GTK_WIDGET (spinner), FALSE);
170 171 172

  context = gtk_widget_get_style_context (GTK_WIDGET (spinner));
  gtk_style_context_add_class (context, GTK_STYLE_CLASS_SPINNER);
173 174
}

175
static void
176 177 178
gtk_spinner_get_preferred_width (GtkWidget *widget,
                                 gint      *minimum_size,
                                 gint      *natural_size)
179 180 181 182 183 184 185 186 187
{
  if (minimum_size)
    *minimum_size = SPINNER_SIZE;

  if (natural_size)
    *natural_size = SPINNER_SIZE;
}

static void
188 189 190
gtk_spinner_get_preferred_height (GtkWidget *widget,
                                  gint      *minimum_size,
                                  gint      *natural_size)
191 192 193 194 195 196 197 198
{
  if (minimum_size)
    *minimum_size = SPINNER_SIZE;

  if (natural_size)
    *natural_size = SPINNER_SIZE;
}

199
static gboolean
Benjamin Otte's avatar
Benjamin Otte committed
200 201
gtk_spinner_draw (GtkWidget *widget,
                  cairo_t   *cr)
202
{
203
  GtkStyleContext *context;
204 205
  gint width, height;
  gint size;
206

207
  context = gtk_widget_get_style_context (widget);
208

209 210 211 212 213 214 215 216
  width = gtk_widget_get_allocated_width (widget);
  height = gtk_widget_get_allocated_height (widget);
  size = MIN (width, height);

  gtk_render_activity (context, cr,
                       (width - size) / 2,
                       (height - size) / 2,
                       size, size);
217 218 219 220 221

  return FALSE;
}

static void
222 223
gtk_spinner_set_active (GtkSpinner *spinner,
                        gboolean    active)
224
{
225
  GtkSpinnerPrivate *priv = spinner->priv;
226

227
  active = !!active;
228 229

  if (priv->active != active)
230
    {
231
      priv->active = active;
232

233 234
      g_object_notify (G_OBJECT (spinner), "active");

235 236 237 238 239 240
      if (active)
        gtk_widget_set_state_flags (GTK_WIDGET (spinner),
                                    GTK_STATE_FLAG_ACTIVE, FALSE);
      else
        gtk_widget_unset_state_flags (GTK_WIDGET (spinner),
                                      GTK_STATE_FLAG_ACTIVE);
241 242 243 244
    }
}

/**
245
 * gtk_spinner_new:
246 247 248 249 250 251 252 253 254 255 256 257 258 259
 *
 * Returns a new spinner widget. Not yet started.
 *
 * Return value: a new #GtkSpinner
 *
 * Since: 2.20
 */
GtkWidget *
gtk_spinner_new (void)
{
  return g_object_new (GTK_TYPE_SPINNER, NULL);
}

/**
260 261
 * gtk_spinner_start:
 * @spinner: a #GtkSpinner
262
 *
263
 * Starts the animation of the spinner.
264 265 266 267 268 269 270 271
 *
 * Since: 2.20
 */
void
gtk_spinner_start (GtkSpinner *spinner)
{
  g_return_if_fail (GTK_IS_SPINNER (spinner));

272
  gtk_spinner_set_active (spinner, TRUE);
273 274 275
}

/**
276 277
 * gtk_spinner_stop:
 * @spinner: a #GtkSpinner
278
 *
279
 * Stops the animation of the spinner.
280 281 282 283 284 285 286 287
 *
 * Since: 2.20
 */
void
gtk_spinner_stop (GtkSpinner *spinner)
{
  g_return_if_fail (GTK_IS_SPINNER (spinner));

288
  gtk_spinner_set_active (spinner, FALSE);
289
}