gtkbutton.c 44.7 KB
Newer Older
Elliot Lee's avatar
Elliot Lee committed
1 2 3 4
/* GTK - The GIMP Toolkit
 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
 *
 * This library is free software; you can redistribute it and/or
5
 * modify it under the terms of the GNU Lesser General Public
Elliot Lee's avatar
Elliot Lee committed
6 7 8 9 10 11
 * 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
12
 * Lesser General Public License for more details.
Elliot Lee's avatar
Elliot Lee committed
13
 *
14
 * You should have received a copy of the GNU Lesser General Public
15 16 17
 * License along with this library; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
Elliot Lee's avatar
Elliot Lee committed
18
 */
19 20

/*
21
 * Modified by the GTK+ Team and others 1997-2001.  See the AUTHORS
22 23 24 25 26
 * 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/. 
 */

27
#include <string.h>
28
#include "gtkalignment.h"
Elliot Lee's avatar
Elliot Lee committed
29 30 31
#include "gtkbutton.h"
#include "gtklabel.h"
#include "gtkmain.h"
32
#include "gtkmarshalers.h"
33 34 35 36
#include "gtkimage.h"
#include "gtkhbox.h"
#include "gtkstock.h"
#include "gtkiconfactory.h"
37
#include "gtkintl.h"
Elliot Lee's avatar
Elliot Lee committed
38 39

#define CHILD_SPACING     1
40

41 42
static const GtkBorder default_default_border = { 1, 1, 1, 1 };
static const GtkBorder default_default_outside_border = { 0, 0, 0, 0 };
Elliot Lee's avatar
Elliot Lee committed
43

Matthias Clasen's avatar
Matthias Clasen committed
44
/* Time out before giving up on getting a key release when animating
45 46 47
 * the close button.
 */
#define ACTIVATE_TIMEOUT 250
Elliot Lee's avatar
Elliot Lee committed
48 49 50 51 52 53 54

enum {
  PRESSED,
  RELEASED,
  CLICKED,
  ENTER,
  LEAVE,
55
  ACTIVATE,
Elliot Lee's avatar
Elliot Lee committed
56 57
  LAST_SIGNAL
};
58

59
enum {
60 61
  PROP_0,
  PROP_LABEL,
62 63
  PROP_RELIEF,
  PROP_USE_UNDERLINE,
Soeren Sandmann's avatar
Soeren Sandmann committed
64
  PROP_USE_STOCK,
65 66 67 68 69 70 71 72 73 74
  PROP_FOCUS_ON_CLICK,
  PROP_XALIGN,
  PROP_YALIGN
};

#define GTK_BUTTON_GET_PRIVATE(o)       (G_TYPE_INSTANCE_GET_PRIVATE ((o), GTK_TYPE_BUTTON, GtkButtonPrivate))
typedef struct _GtkButtonPrivate GtkButtonPrivate;

struct _GtkButtonPrivate
{
Matthias Clasen's avatar
Matthias Clasen committed
75 76 77 78 79
  gfloat       xalign;
  gfloat       yalign;
  GtkSettings *settings;
  guint        show_image_connection;
  GtkWidget   *image;
80
};
81

Elliot Lee's avatar
Elliot Lee committed
82 83
static void gtk_button_class_init     (GtkButtonClass   *klass);
static void gtk_button_init           (GtkButton        *button);
84
static void gtk_button_destroy        (GtkObject        *object);
85 86 87 88 89 90 91 92
static void gtk_button_set_property   (GObject         *object,
                                       guint            prop_id,
                                       const GValue    *value,
                                       GParamSpec      *pspec);
static void gtk_button_get_property   (GObject         *object,
                                       guint            prop_id,
                                       GValue          *value,
                                       GParamSpec      *pspec);
Matthias Clasen's avatar
Matthias Clasen committed
93 94
static void gtk_button_screen_changed (GtkWidget        *widget,
				       GdkScreen        *previous_screen);
Elliot Lee's avatar
Elliot Lee committed
95
static void gtk_button_realize        (GtkWidget        *widget);
96
static void gtk_button_unrealize      (GtkWidget        *widget);
97 98
static void gtk_button_map            (GtkWidget        *widget);
static void gtk_button_unmap          (GtkWidget        *widget);
Elliot Lee's avatar
Elliot Lee committed
99 100 101 102 103 104 105 106 107 108
static void gtk_button_size_request   (GtkWidget        *widget,
				       GtkRequisition   *requisition);
static void gtk_button_size_allocate  (GtkWidget        *widget,
				       GtkAllocation    *allocation);
static gint gtk_button_expose         (GtkWidget        *widget,
				       GdkEventExpose   *event);
static gint gtk_button_button_press   (GtkWidget        *widget,
				       GdkEventButton   *event);
static gint gtk_button_button_release (GtkWidget        *widget,
				       GdkEventButton   *event);
109 110
static gint gtk_button_key_release    (GtkWidget        *widget,
				       GdkEventKey      *event);
Elliot Lee's avatar
Elliot Lee committed
111 112 113 114 115 116
static gint gtk_button_enter_notify   (GtkWidget        *widget,
				       GdkEventCrossing *event);
static gint gtk_button_leave_notify   (GtkWidget        *widget,
				       GdkEventCrossing *event);
static void gtk_real_button_pressed   (GtkButton        *button);
static void gtk_real_button_released  (GtkButton        *button);
Manish Singh's avatar
Manish Singh committed
117
static void gtk_real_button_activate  (GtkButton         *button);
118
static void gtk_button_update_state   (GtkButton        *button);
119 120
static void gtk_button_add            (GtkContainer   *container,
			               GtkWidget      *widget);
Manish Singh's avatar
Manish Singh committed
121
static GType gtk_button_child_type    (GtkContainer     *container);
122 123
static void gtk_button_finish_activate (GtkButton *button,
					gboolean   do_it);
Elliot Lee's avatar
Elliot Lee committed
124

125 126 127
static GObject*	gtk_button_constructor     (GType                  type,
					    guint                  n_construct_properties,
					    GObjectConstructParam *construct_params);
Matthias Clasen's avatar
Matthias Clasen committed
128
static void gtk_button_construct_child (GtkButton             *button);
129 130


131
static GtkBinClass *parent_class = NULL;
132
static guint button_signals[LAST_SIGNAL] = { 0 };
Elliot Lee's avatar
Elliot Lee committed
133 134


Manish Singh's avatar
Manish Singh committed
135
GType
136
gtk_button_get_type (void)
Elliot Lee's avatar
Elliot Lee committed
137
{
Manish Singh's avatar
Manish Singh committed
138
  static GType button_type = 0;
Elliot Lee's avatar
Elliot Lee committed
139 140 141

  if (!button_type)
    {
142
      static const GTypeInfo button_info =
Elliot Lee's avatar
Elliot Lee committed
143 144
      {
	sizeof (GtkButtonClass),
145 146 147 148 149 150 151 152
	NULL,		/* base_init */
	NULL,		/* base_finalize */
	(GClassInitFunc) gtk_button_class_init,
	NULL,		/* class_finalize */
	NULL,		/* class_data */
	sizeof (GtkButton),
	16,		/* n_preallocs */
	(GInstanceInitFunc) gtk_button_init,
Elliot Lee's avatar
Elliot Lee committed
153 154
      };

Manish Singh's avatar
Manish Singh committed
155 156
      button_type = g_type_register_static (GTK_TYPE_BIN, "GtkButton",
					    &button_info, 0);
Elliot Lee's avatar
Elliot Lee committed
157 158 159 160 161 162 163 164
    }

  return button_type;
}

static void
gtk_button_class_init (GtkButtonClass *klass)
{
Manish Singh's avatar
Manish Singh committed
165
  GObjectClass *gobject_class;
Elliot Lee's avatar
Elliot Lee committed
166 167 168 169
  GtkObjectClass *object_class;
  GtkWidgetClass *widget_class;
  GtkContainerClass *container_class;

Manish Singh's avatar
Manish Singh committed
170
  gobject_class = G_OBJECT_CLASS (klass);
Elliot Lee's avatar
Elliot Lee committed
171 172 173
  object_class = (GtkObjectClass*) klass;
  widget_class = (GtkWidgetClass*) klass;
  container_class = (GtkContainerClass*) klass;
174 175
  
  parent_class = g_type_class_peek_parent (klass);
176

Manish Singh's avatar
Manish Singh committed
177 178 179
  gobject_class->constructor = gtk_button_constructor;
  gobject_class->set_property = gtk_button_set_property;
  gobject_class->get_property = gtk_button_get_property;
180

181 182
  object_class->destroy = gtk_button_destroy;

Matthias Clasen's avatar
Matthias Clasen committed
183
  widget_class->screen_changed = gtk_button_screen_changed;
184
  widget_class->realize = gtk_button_realize;
185
  widget_class->unrealize = gtk_button_unrealize;
186 187
  widget_class->map = gtk_button_map;
  widget_class->unmap = gtk_button_unmap;
188 189 190 191 192
  widget_class->size_request = gtk_button_size_request;
  widget_class->size_allocate = gtk_button_size_allocate;
  widget_class->expose_event = gtk_button_expose;
  widget_class->button_press_event = gtk_button_button_press;
  widget_class->button_release_event = gtk_button_button_release;
193
  widget_class->key_release_event = gtk_button_key_release;
194 195 196 197 198 199 200 201
  widget_class->enter_notify_event = gtk_button_enter_notify;
  widget_class->leave_notify_event = gtk_button_leave_notify;

  container_class->child_type = gtk_button_child_type;

  klass->pressed = gtk_real_button_pressed;
  klass->released = gtk_real_button_released;
  klass->clicked = NULL;
202 203
  klass->enter = gtk_button_update_state;
  klass->leave = gtk_button_update_state;
204
  klass->activate = gtk_real_button_activate;
205

Manish Singh's avatar
Manish Singh committed
206
  g_object_class_install_property (gobject_class,
207 208
                                   PROP_LABEL,
                                   g_param_spec_string ("label",
209 210
                                                        P_("Label"),
                                                        P_("Text of the label widget inside the button, if the button contains a label widget"),
211
                                                        NULL,
212 213
                                                        G_PARAM_READWRITE | G_PARAM_CONSTRUCT));
  
Manish Singh's avatar
Manish Singh committed
214
  g_object_class_install_property (gobject_class,
215 216
                                   PROP_USE_UNDERLINE,
                                   g_param_spec_boolean ("use_underline",
217 218
							 P_("Use underline"),
							 P_("If set, an underline in the text indicates the next character should be used for the mnemonic accelerator key"),
219 220 221
                                                        FALSE,
                                                        G_PARAM_READWRITE | G_PARAM_CONSTRUCT));
  
Manish Singh's avatar
Manish Singh committed
222
  g_object_class_install_property (gobject_class,
223 224
                                   PROP_USE_STOCK,
                                   g_param_spec_boolean ("use_stock",
225 226
							 P_("Use stock"),
							 P_("If set, the label is used to pick a stock item instead of being displayed"),
227 228
                                                        FALSE,
                                                        G_PARAM_READWRITE | G_PARAM_CONSTRUCT));
229
  
Soeren Sandmann's avatar
Soeren Sandmann committed
230 231 232
  g_object_class_install_property (gobject_class,
                                   PROP_FOCUS_ON_CLICK,
                                   g_param_spec_boolean ("focus_on_click",
233 234
							 P_("Focus on click"),
							 P_("Whether the button grabs focus when it is clicked with the mouse"),
Soeren Sandmann's avatar
Soeren Sandmann committed
235 236 237
							 TRUE,
							 G_PARAM_READWRITE));
  
Manish Singh's avatar
Manish Singh committed
238
  g_object_class_install_property (gobject_class,
239 240
                                   PROP_RELIEF,
                                   g_param_spec_enum ("relief",
241 242
                                                      P_("Border relief"),
                                                      P_("The border relief style"),
243 244 245
                                                      GTK_TYPE_RELIEF_STYLE,
                                                      GTK_RELIEF_NORMAL,
                                                      G_PARAM_READABLE | G_PARAM_WRITABLE));
246 247 248 249 250 251 252 253 254 255 256 257 258
  
  /**
   * GtkButton:xalign:
   *
   * If the child of the button is a #GtkMisc or #GtkAlignment, this property 
   * can be used to control it's horizontal alignment. 0.0 is left aligned, 
   * 1.0 is right aligned.
   * 
   * Since: 2.4
   */
  g_object_class_install_property (gobject_class,
                                   PROP_XALIGN,
                                   g_param_spec_float("xalign",
259 260
                                                      P_("Horizontal alignment for child"),
                                                      P_("Horizontal position of child in available space. 0.0 is left aligned, 1.0 is right aligned"),
261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277
                                                      0.0,
                                                      1.0,
                                                      0.5,
                                                      G_PARAM_READABLE | G_PARAM_WRITABLE));

  /**
   * GtkButton:yalign:
   *
   * If the child of the button is a #GtkMisc or #GtkAlignment, this property 
   * can be used to control it's vertical alignment. 0.0 is top aligned, 
   * 1.0 is bottom aligned.
   * 
   * Since: 2.4
   */
  g_object_class_install_property (gobject_class,
                                   PROP_YALIGN,
                                   g_param_spec_float("yalign",
278 279
                                                      P_("Vertical alignment for child"),
                                                      P_("Vertical position of child in available space. 0.0 is top aligned, 1.0 is bottom aligned"),
280 281 282 283
                                                      0.0,
                                                      1.0,
                                                      0.5,
                                                      G_PARAM_READABLE | G_PARAM_WRITABLE));
Elliot Lee's avatar
Elliot Lee committed
284 285

  button_signals[PRESSED] =
Manish Singh's avatar
Manish Singh committed
286 287 288 289 290 291 292
    g_signal_new ("pressed",
		  G_OBJECT_CLASS_TYPE (object_class),
		  G_SIGNAL_RUN_FIRST,
		  G_STRUCT_OFFSET (GtkButtonClass, pressed),
		  NULL, NULL,
		  _gtk_marshal_VOID__VOID,
		  G_TYPE_NONE, 0);
Elliot Lee's avatar
Elliot Lee committed
293
  button_signals[RELEASED] =
Manish Singh's avatar
Manish Singh committed
294 295 296 297 298 299 300
    g_signal_new ("released",
		  G_OBJECT_CLASS_TYPE (object_class),
		  G_SIGNAL_RUN_FIRST,
		  G_STRUCT_OFFSET (GtkButtonClass, released),
		  NULL, NULL,
		  _gtk_marshal_VOID__VOID,
		  G_TYPE_NONE, 0);
Elliot Lee's avatar
Elliot Lee committed
301
  button_signals[CLICKED] =
Manish Singh's avatar
Manish Singh committed
302 303 304 305 306 307 308
    g_signal_new ("clicked",
		  G_OBJECT_CLASS_TYPE (object_class),
		  G_SIGNAL_RUN_FIRST | G_SIGNAL_ACTION,
		  G_STRUCT_OFFSET (GtkButtonClass, clicked),
		  NULL, NULL,
		  _gtk_marshal_VOID__VOID,
		  G_TYPE_NONE, 0);
Elliot Lee's avatar
Elliot Lee committed
309
  button_signals[ENTER] =
Manish Singh's avatar
Manish Singh committed
310 311 312 313 314 315 316
    g_signal_new ("enter",
		  G_OBJECT_CLASS_TYPE (object_class),
		  G_SIGNAL_RUN_FIRST,
		  G_STRUCT_OFFSET (GtkButtonClass, enter),
		  NULL, NULL,
		  _gtk_marshal_VOID__VOID,
		  G_TYPE_NONE, 0);
Elliot Lee's avatar
Elliot Lee committed
317
  button_signals[LEAVE] =
Manish Singh's avatar
Manish Singh committed
318 319 320 321 322 323 324
    g_signal_new ("leave",
		  G_OBJECT_CLASS_TYPE (object_class),
		  G_SIGNAL_RUN_FIRST,
		  G_STRUCT_OFFSET (GtkButtonClass, leave),
		  NULL, NULL,
		  _gtk_marshal_VOID__VOID,
		  G_TYPE_NONE, 0);
325 326 327 328 329 330 331 332 333

  /**
   * GtkButton::activate:
   *
   * The "activate" signal on GtkButton is an action signal and
   * emitting it causes the button to animate press then release. 
   * Applications should never connect to this signal, but use the
   * "clicked" signal.
   */
334
  button_signals[ACTIVATE] =
Manish Singh's avatar
Manish Singh committed
335 336 337 338 339 340 341
    g_signal_new ("activate",
		  G_OBJECT_CLASS_TYPE (object_class),
		  G_SIGNAL_RUN_FIRST | G_SIGNAL_ACTION,
		  G_STRUCT_OFFSET (GtkButtonClass, activate),
		  NULL, NULL,
		  _gtk_marshal_VOID__VOID,
		  G_TYPE_NONE, 0);
342
  widget_class->activate_signal = button_signals[ACTIVATE];
343 344

  gtk_widget_class_install_style_property (widget_class,
345
					   g_param_spec_boxed ("default_border",
346 347
							       P_("Default Spacing"),
							       P_("Extra space to add for CAN_DEFAULT buttons"),
348 349 350 351 352
							       GTK_TYPE_BORDER,
							       G_PARAM_READABLE));

  gtk_widget_class_install_style_property (widget_class,
					   g_param_spec_boxed ("default_outside_border",
353 354
							       P_("Default Outside Spacing"),
							       P_("Extra space to add for CAN_DEFAULT buttons that is always drawn outside the border"),
355 356
							       GTK_TYPE_BORDER,
							       G_PARAM_READABLE));
357 358
  gtk_widget_class_install_style_property (widget_class,
					   g_param_spec_int ("child_displacement_x",
359 360
							     P_("Child X Displacement"),
							     P_("How far in the x direction to move the child when the button is depressed"),
361 362 363 364 365 366
							     G_MININT,
							     G_MAXINT,
							     0,
							     G_PARAM_READABLE));
  gtk_widget_class_install_style_property (widget_class,
					   g_param_spec_int ("child_displacement_y",
367 368
							     P_("Child Y Displacement"),
							     P_("How far in the y direction to move the child when the button is depressed"),
369 370 371 372
							     G_MININT,
							     G_MAXINT,
							     0,
							     G_PARAM_READABLE));
373

Matthias Clasen's avatar
Matthias Clasen committed
374 375 376 377 378 379
  gtk_settings_install_property (g_param_spec_boolean ("gtk-button-images",
						       P_("Show button images"),
						       P_("Whether stock icons should be shown in buttons"),
						       TRUE,
						       G_PARAM_READWRITE));
  
380
  g_type_class_add_private (gobject_class, sizeof (GtkButtonPrivate));  
Elliot Lee's avatar
Elliot Lee committed
381 382 383 384 385
}

static void
gtk_button_init (GtkButton *button)
{
386 387
  GtkButtonPrivate *priv = GTK_BUTTON_GET_PRIVATE (button);

388
  GTK_WIDGET_SET_FLAGS (button, GTK_CAN_FOCUS | GTK_RECEIVES_DEFAULT);
389
  GTK_WIDGET_SET_FLAGS (button, GTK_NO_WINDOW);
Elliot Lee's avatar
Elliot Lee committed
390

391 392 393
  button->label_text = NULL;
  
  button->constructed = FALSE;
Elliot Lee's avatar
Elliot Lee committed
394 395
  button->in_button = FALSE;
  button->button_down = FALSE;
396
  button->relief = GTK_RELIEF_NORMAL;
397 398
  button->use_stock = FALSE;
  button->use_underline = FALSE;
399
  button->depressed = FALSE;
400
  button->depress_on_activate = TRUE;
Soeren Sandmann's avatar
Soeren Sandmann committed
401
  button->focus_on_click = TRUE;
402 403 404

  priv->xalign = 0.5;
  priv->yalign = 0.5;
Elliot Lee's avatar
Elliot Lee committed
405 406
}

407 408 409 410 411 412 413 414 415 416 417 418 419 420
static void
gtk_button_destroy (GtkObject *object)
{
  GtkButton *button = GTK_BUTTON (object);
  
  if (button->label_text)
    {
      g_free (button->label_text);
      button->label_text = NULL;
    }
  
  (* GTK_OBJECT_CLASS (parent_class)->destroy) (object);
}

421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442
static GObject*
gtk_button_constructor (GType                  type,
			guint                  n_construct_properties,
			GObjectConstructParam *construct_params)
{
  GObject *object;
  GtkButton *button;

  object = (* G_OBJECT_CLASS (parent_class)->constructor) (type,
							   n_construct_properties,
							   construct_params);

  button = GTK_BUTTON (object);
  button->constructed = TRUE;

  if (button->label_text != NULL)
    gtk_button_construct_child (button);
  
  return object;
}


Manish Singh's avatar
Manish Singh committed
443
static GType
444 445
gtk_button_child_type  (GtkContainer     *container)
{
446
  if (!GTK_BIN (container)->child)
447 448
    return GTK_TYPE_WIDGET;
  else
Manish Singh's avatar
Manish Singh committed
449
    return G_TYPE_NONE;
450 451
}

452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479
static void
maybe_set_alignment (GtkWidget *widget,
		     gfloat     xalign,
		     gfloat     yalign)
{
  if (GTK_IS_MISC (widget))
    {
      GtkMisc *misc = GTK_MISC (widget);
      gtk_misc_set_alignment (misc, xalign, yalign);
    }
  else if (GTK_IS_ALIGNMENT (widget))
    {
      GtkAlignment *alignment = GTK_ALIGNMENT (widget);
      gtk_alignment_set (alignment, xalign, yalign, alignment->xscale, alignment->yscale);
    }
}

static void
gtk_button_add (GtkContainer *container,
		GtkWidget    *widget)
{
  GtkButton *button = GTK_BUTTON (container);
  GtkButtonPrivate *priv = GTK_BUTTON_GET_PRIVATE (button);

  maybe_set_alignment (widget, priv->xalign, priv->yalign);
  GTK_CONTAINER_CLASS (parent_class)->add (container, widget);
}

Elliot Lee's avatar
Elliot Lee committed
480
static void
481 482 483 484
gtk_button_set_property (GObject         *object,
                         guint            prop_id,
                         const GValue    *value,
                         GParamSpec      *pspec)
Elliot Lee's avatar
Elliot Lee committed
485
{
486 487
  GtkButton *button = GTK_BUTTON (object);
  GtkButtonPrivate *priv = GTK_BUTTON_GET_PRIVATE (button);
Elliot Lee's avatar
Elliot Lee committed
488

489
  switch (prop_id)
490
    {
491
    case PROP_LABEL:
492
      gtk_button_set_label (button, g_value_get_string (value));
493
      break;
494 495
    case PROP_RELIEF:
      gtk_button_set_relief (button, g_value_get_enum (value));
496
      break;
497 498 499 500 501 502
    case PROP_USE_UNDERLINE:
      gtk_button_set_use_underline (button, g_value_get_boolean (value));
      break;
    case PROP_USE_STOCK:
      gtk_button_set_use_stock (button, g_value_get_boolean (value));
      break;
Soeren Sandmann's avatar
Soeren Sandmann committed
503 504 505
    case PROP_FOCUS_ON_CLICK:
      gtk_button_set_focus_on_click (button, g_value_get_boolean (value));
      break;
506 507 508 509 510 511
    case PROP_XALIGN:
      gtk_button_set_alignment (button, g_value_get_float (value), priv->yalign);
      break;
    case PROP_YALIGN:
      gtk_button_set_alignment (button, priv->xalign, g_value_get_float (value));
      break;
512
    default:
513
      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
514 515 516 517 518
      break;
    }
}

static void
519 520 521 522
gtk_button_get_property (GObject         *object,
                         guint            prop_id,
                         GValue          *value,
                         GParamSpec      *pspec)
523
{
524 525
  GtkButton *button = GTK_BUTTON (object);
  GtkButtonPrivate *priv = GTK_BUTTON_GET_PRIVATE (button);
526

527
  switch (prop_id)
528
    {
529
    case PROP_LABEL:
530
      g_value_set_string (value, button->label_text);
531
      break;
532
    case PROP_RELIEF:
Alexander Larsson's avatar
Alexander Larsson committed
533
      g_value_set_enum (value, gtk_button_get_relief (button));
534
      break;
535 536 537 538 539 540
    case PROP_USE_UNDERLINE:
      g_value_set_boolean (value, button->use_underline);
      break;
    case PROP_USE_STOCK:
      g_value_set_boolean (value, button->use_stock);
      break;
Soeren Sandmann's avatar
Soeren Sandmann committed
541 542 543
    case PROP_FOCUS_ON_CLICK:
      g_value_set_boolean (value, button->focus_on_click);
      break;
544 545 546 547 548 549
    case PROP_XALIGN:
      g_value_set_float (value, priv->xalign);
      break;
    case PROP_YALIGN:
      g_value_set_float (value, priv->yalign);
      break;
Tim Janik's avatar
Tim Janik committed
550
    default:
551
      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
Tim Janik's avatar
Tim Janik committed
552
      break;
Elliot Lee's avatar
Elliot Lee committed
553 554 555 556
    }
}

GtkWidget*
557
gtk_button_new (void)
Elliot Lee's avatar
Elliot Lee committed
558
{
Manish Singh's avatar
Manish Singh committed
559
  return g_object_new (GTK_TYPE_BUTTON, NULL);
Elliot Lee's avatar
Elliot Lee committed
560 561
}

Matthias Clasen's avatar
Matthias Clasen committed
562 563 564 565 566 567 568 569 570 571 572
static gboolean
show_image (GtkButton *button)
{
  GtkSettings *settings = gtk_widget_get_settings (GTK_WIDGET (button));  
  gboolean show;

  g_object_get (settings, "gtk-button-images", &show, NULL);

  return show;
}

573 574
static void
gtk_button_construct_child (GtkButton *button)
Elliot Lee's avatar
Elliot Lee committed
575
{
Matthias Clasen's avatar
Matthias Clasen committed
576
  GtkButtonPrivate *priv = GTK_BUTTON_GET_PRIVATE (button);
577 578 579
  GtkStockItem item;
  GtkWidget *label;
  GtkWidget *hbox;
580
  GtkWidget *align;
581
  
582 583 584 585 586
  if (!button->constructed)
    return;
  
  if (button->label_text == NULL)
    return;
Elliot Lee's avatar
Elliot Lee committed
587

588
  if (GTK_BIN (button)->child)
589 590 591 592 593
    {
      gtk_container_remove (GTK_CONTAINER (button),
  			    GTK_BIN (button)->child);
      priv->image = NULL;
    }
594 595 596
  
  if (button->use_stock &&
      gtk_stock_lookup (button->label_text, &item))
597
    {
598 599
      label = gtk_label_new_with_mnemonic (item.label);

600 601
      gtk_label_set_mnemonic_widget (GTK_LABEL (label), GTK_WIDGET (button));
      
Matthias Clasen's avatar
Matthias Clasen committed
602 603 604 605 606
      priv->image = gtk_image_new_from_stock (button->label_text, GTK_ICON_SIZE_BUTTON);
      g_object_set (priv->image, 
		    "visible", show_image (button),
		    "no_show_all", TRUE,
		    NULL);
607
      hbox = gtk_hbox_new (FALSE, 2);
608

609
      align = gtk_alignment_new (priv->xalign, priv->yalign, 0.0, 0.0);
610
      
Matthias Clasen's avatar
Matthias Clasen committed
611
      gtk_box_pack_start (GTK_BOX (hbox), priv->image, FALSE, FALSE, 0);
612
      gtk_box_pack_end (GTK_BOX (hbox), label, FALSE, FALSE, 0);
613
      
614 615 616
      gtk_container_add (GTK_CONTAINER (button), align);
      gtk_container_add (GTK_CONTAINER (align), hbox);
      gtk_widget_show_all (align);
617 618

      return;
619
    }
620 621

  if (button->use_underline)
622
    {
623 624
      label = gtk_label_new_with_mnemonic (button->label_text);
      gtk_label_set_mnemonic_widget (GTK_LABEL (label), GTK_WIDGET (button));
625
    }
626 627
  else
    label = gtk_label_new (button->label_text);
628
  
629
  gtk_misc_set_alignment (GTK_MISC (label), priv->xalign, priv->yalign);
630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648

  gtk_widget_show (label);
  gtk_container_add (GTK_CONTAINER (button), label);
}


GtkWidget*
gtk_button_new_with_label (const gchar *label)
{
  return g_object_new (GTK_TYPE_BUTTON, "label", label, NULL);
}

/**
 * gtk_button_new_from_stock:
 * @stock_id: the name of the stock item 
 *
 * Creates a new #GtkButton containing the image and text from a stock item.
 * Some stock ids have preprocessor macros like #GTK_STOCK_OK and
 * #GTK_STOCK_APPLY.
649 650 651 652 653
 *
 * If @stock_id is unknown, then it will be treated as a mnemonic
 * label (as for gtk_button_new_with_mnemonic()).
 *
 * Returns: a new #GtkButton
654 655
 **/
GtkWidget*
656
gtk_button_new_from_stock (const gchar *stock_id)
657
{
658 659 660 661 662
  return g_object_new (GTK_TYPE_BUTTON,
                       "label", stock_id,
                       "use_stock", TRUE,
                       "use_underline", TRUE,
                       NULL);
663 664
}

665 666 667 668 669 670 671
/**
 * gtk_button_new_with_mnemonic:
 * @label: The text of the button, with an underscore in front of the
 *         mnemonic character
 * @returns: a new #GtkButton
 *
 * Creates a new #GtkButton containing a label.
672 673 674 675
 * If characters in @label are preceded by an underscore, they are underlined.
 * If you need a literal underscore character in a label, use '__' (two 
 * underscores). The first underlined character represents a keyboard 
 * accelerator called a mnemonic.
676 677
 * Pressing Alt and that key activates the button.
 **/
678
GtkWidget*
679
gtk_button_new_with_mnemonic (const gchar *label)
680
{
681
  return g_object_new (GTK_TYPE_BUTTON, "label", label, "use_underline", TRUE,  NULL);
682 683
}

Elliot Lee's avatar
Elliot Lee committed
684 685 686
void
gtk_button_pressed (GtkButton *button)
{
687 688
  g_return_if_fail (GTK_IS_BUTTON (button));

Matthias Clasen's avatar
Matthias Clasen committed
689
  
Manish Singh's avatar
Manish Singh committed
690
  g_signal_emit (button, button_signals[PRESSED], 0);
Elliot Lee's avatar
Elliot Lee committed
691 692 693 694 695
}

void
gtk_button_released (GtkButton *button)
{
696 697
  g_return_if_fail (GTK_IS_BUTTON (button));

Manish Singh's avatar
Manish Singh committed
698
  g_signal_emit (button, button_signals[RELEASED], 0);
Elliot Lee's avatar
Elliot Lee committed
699 700 701 702 703
}

void
gtk_button_clicked (GtkButton *button)
{
704 705
  g_return_if_fail (GTK_IS_BUTTON (button));

Manish Singh's avatar
Manish Singh committed
706
  g_signal_emit (button, button_signals[CLICKED], 0);
Elliot Lee's avatar
Elliot Lee committed
707 708 709 710 711
}

void
gtk_button_enter (GtkButton *button)
{
712 713
  g_return_if_fail (GTK_IS_BUTTON (button));

Manish Singh's avatar
Manish Singh committed
714
  g_signal_emit (button, button_signals[ENTER], 0);
Elliot Lee's avatar
Elliot Lee committed
715 716 717 718 719
}

void
gtk_button_leave (GtkButton *button)
{
720 721
  g_return_if_fail (GTK_IS_BUTTON (button));

Manish Singh's avatar
Manish Singh committed
722
  g_signal_emit (button, button_signals[LEAVE], 0);
Elliot Lee's avatar
Elliot Lee committed
723 724
}

725 726 727 728 729 730
void
gtk_button_set_relief (GtkButton *button,
		       GtkReliefStyle newrelief)
{
  g_return_if_fail (GTK_IS_BUTTON (button));

731 732 733 734 735 736
  if (newrelief != button->relief) 
    {
       button->relief = newrelief;
       g_object_notify (G_OBJECT (button), "relief");
       gtk_widget_queue_draw (GTK_WIDGET (button));
    }
737 738 739
}

GtkReliefStyle
740
gtk_button_get_relief (GtkButton *button)
741 742 743 744 745 746 747
{
  g_return_val_if_fail (button != NULL, GTK_RELIEF_NORMAL);
  g_return_val_if_fail (GTK_IS_BUTTON (button), GTK_RELIEF_NORMAL);

  return button->relief;
}

Elliot Lee's avatar
Elliot Lee committed
748 749 750 751 752 753
static void
gtk_button_realize (GtkWidget *widget)
{
  GtkButton *button;
  GdkWindowAttr attributes;
  gint attributes_mask;
Owen Taylor's avatar
Owen Taylor committed
754
  gint border_width;
Elliot Lee's avatar
Elliot Lee committed
755 756 757 758

  button = GTK_BUTTON (widget);
  GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED);

Owen Taylor's avatar
Owen Taylor committed
759 760
  border_width = GTK_CONTAINER (widget)->border_width;

Elliot Lee's avatar
Elliot Lee committed
761
  attributes.window_type = GDK_WINDOW_CHILD;
Owen Taylor's avatar
Owen Taylor committed
762 763 764 765
  attributes.x = widget->allocation.x + border_width;
  attributes.y = widget->allocation.y + border_width;
  attributes.width = widget->allocation.width - border_width * 2;
  attributes.height = widget->allocation.height - border_width * 2;
766
  attributes.wclass = GDK_INPUT_ONLY;
Elliot Lee's avatar
Elliot Lee committed
767
  attributes.event_mask = gtk_widget_get_events (widget);
768
  attributes.event_mask |= (GDK_BUTTON_PRESS_MASK |
Elliot Lee's avatar
Elliot Lee committed
769 770 771 772
			    GDK_BUTTON_RELEASE_MASK |
			    GDK_ENTER_NOTIFY_MASK |
			    GDK_LEAVE_NOTIFY_MASK);

773
  attributes_mask = GDK_WA_X | GDK_WA_Y;
Elliot Lee's avatar
Elliot Lee committed
774

775
  widget->window = gtk_widget_get_parent_window (widget);
Manish Singh's avatar
Manish Singh committed
776
  g_object_ref (widget->window);
777 778 779 780
  
  button->event_window = gdk_window_new (gtk_widget_get_parent_window (widget),
					 &attributes, attributes_mask);
  gdk_window_set_user_data (button->event_window, button);
Elliot Lee's avatar
Elliot Lee committed
781 782 783 784

  widget->style = gtk_style_attach (widget->style, widget->window);
}

785 786 787 788 789 790 791
static void
gtk_button_unrealize (GtkWidget *widget)
{
  GtkButton *button = GTK_BUTTON (widget);

  if (button->activate_timeout)
    gtk_button_finish_activate (button, FALSE);
792 793 794 795 796 797 798 799

  if (button->event_window)
    {
      gdk_window_set_user_data (button->event_window, NULL);
      gdk_window_destroy (button->event_window);
      button->event_window = NULL;
    }
  
800 801 802
  GTK_WIDGET_CLASS (parent_class)->unrealize (widget);
}

803 804 805 806 807 808 809
static void
gtk_button_map (GtkWidget *widget)
{
  GtkButton *button = GTK_BUTTON (widget);
  
  g_return_if_fail (GTK_IS_BUTTON (widget));

810 811
  GTK_WIDGET_CLASS (parent_class)->map (widget);

812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828
  if (button->event_window)
    gdk_window_show (button->event_window);
}

static void
gtk_button_unmap (GtkWidget *widget)
{
  GtkButton *button = GTK_BUTTON (widget);
    
  g_return_if_fail (GTK_IS_BUTTON (widget));

  if (button->event_window)
    gdk_window_hide (button->event_window);

  GTK_WIDGET_CLASS (parent_class)->unmap (widget);
}

Elliot Lee's avatar
Elliot Lee committed
829
static void
830
gtk_button_get_props (GtkButton *button,
831 832
		      GtkBorder *default_border,
		      GtkBorder *default_outside_border,
833
		      gboolean  *interior_focus)
Elliot Lee's avatar
Elliot Lee committed
834
{
835
  GtkWidget *widget =  GTK_WIDGET (button);
836 837 838 839 840 841 842 843 844 845 846 847 848 849
  GtkBorder *tmp_border;

  if (default_border)
    {
      gtk_widget_style_get (widget, "default_border", &tmp_border, NULL);

      if (tmp_border)
	{
	  *default_border = *tmp_border;
	  g_free (tmp_border);
	}
      else
	*default_border = default_default_border;
    }
Elliot Lee's avatar
Elliot Lee committed
850

851 852 853 854 855 856 857 858 859 860 861 862
  if (default_outside_border)
    {
      gtk_widget_style_get (widget, "default_outside_border", &tmp_border, NULL);

      if (tmp_border)
	{
	  *default_outside_border = *tmp_border;
	  g_free (tmp_border);
	}
      else
	*default_outside_border = default_default_outside_border;
    }
Elliot Lee's avatar
Elliot Lee committed
863

864 865 866 867 868 869 870 871 872
  if (interior_focus)
    gtk_widget_style_get (widget, "interior_focus", interior_focus, NULL);
}
	
static void
gtk_button_size_request (GtkWidget      *widget,
			 GtkRequisition *requisition)
{
  GtkButton *button = GTK_BUTTON (widget);
873
  GtkBorder default_border;
874
  gboolean interior_focus;
875 876
  gint focus_width;
  gint focus_pad;
Elliot Lee's avatar
Elliot Lee committed
877

878
  gtk_button_get_props (button, &default_border, NULL, &interior_focus);
879 880 881 882 883
  gtk_widget_style_get (GTK_WIDGET (widget),
			"focus-line-width", &focus_width,
			"focus-padding", &focus_pad,
			NULL);
 
Elliot Lee's avatar
Elliot Lee committed
884
  requisition->width = (GTK_CONTAINER (widget)->border_width + CHILD_SPACING +
885
			GTK_WIDGET (widget)->style->xthickness) * 2;
Elliot Lee's avatar
Elliot Lee committed
886
  requisition->height = (GTK_CONTAINER (widget)->border_width + CHILD_SPACING +
887
			 GTK_WIDGET (widget)->style->ythickness) * 2;
Elliot Lee's avatar
Elliot Lee committed
888 889 890

  if (GTK_WIDGET_CAN_DEFAULT (widget))
    {
891 892
      requisition->width += default_border.left + default_border.right;
      requisition->height += default_border.top + default_border.bottom;
Elliot Lee's avatar
Elliot Lee committed
893 894
    }

895
  if (GTK_BIN (button)->child && GTK_WIDGET_VISIBLE (GTK_BIN (button)->child))
Elliot Lee's avatar
Elliot Lee committed
896
    {
897
      GtkRequisition child_requisition;
Elliot Lee's avatar
Elliot Lee committed
898

899 900 901 902
      gtk_widget_size_request (GTK_BIN (button)->child, &child_requisition);

      requisition->width += child_requisition.width;
      requisition->height += child_requisition.height;
Elliot Lee's avatar
Elliot Lee committed
903
    }
904 905 906
  
  requisition->width += 2 * (focus_width + focus_pad);
  requisition->height += 2 * (focus_width + focus_pad);
Elliot Lee's avatar
Elliot Lee committed
907 908 909 910 911 912
}

static void
gtk_button_size_allocate (GtkWidget     *widget,
			  GtkAllocation *allocation)
{
913
  GtkButton *button = GTK_BUTTON (widget);
Elliot Lee's avatar
Elliot Lee committed
914 915
  GtkAllocation child_allocation;

916 917 918
  gint border_width = GTK_CONTAINER (widget)->border_width;
  gint xthickness = GTK_WIDGET (widget)->style->xthickness;
  gint ythickness = GTK_WIDGET (widget)->style->ythickness;
919
  GtkBorder default_border;
Elliot Lee's avatar
Elliot Lee committed
920

921
  gtk_button_get_props (button, &default_border, NULL, NULL);
922
			    
Elliot Lee's avatar
Elliot Lee committed
923 924 925
  widget->allocation = *allocation;

  if (GTK_WIDGET_REALIZED (widget))
926
    gdk_window_move_resize (button->event_window,
Elliot Lee's avatar
Elliot Lee committed
927 928 929 930 931
			    widget->allocation.x + border_width,
			    widget->allocation.y + border_width,
			    widget->allocation.width - border_width * 2,
			    widget->allocation.height - border_width * 2);

932
  if (GTK_BIN (button)->child && GTK_WIDGET_VISIBLE (GTK_BIN (button)->child))
Elliot Lee's avatar
Elliot Lee committed
933
    {
934 935 936 937 938 939 940
      child_allocation.x = widget->allocation.x + border_width + CHILD_SPACING + xthickness;
      child_allocation.y = widget->allocation.y + border_width + CHILD_SPACING + ythickness;
      
      child_allocation.width = MAX (1, widget->allocation.width - (CHILD_SPACING + xthickness) * 2 -
				    border_width * 2);
      child_allocation.height = MAX (1, widget->allocation.height - (CHILD_SPACING + ythickness) * 2 -
				     border_width * 2);
Elliot Lee's avatar
Elliot Lee committed
941 942 943

      if (GTK_WIDGET_CAN_DEFAULT (button))
	{
944 945 946 947
	  child_allocation.x += default_border.left;
	  child_allocation.y += default_border.top;
	  child_allocation.width =  MAX (1, child_allocation.width - default_border.left - default_border.right);
	  child_allocation.height = MAX (1, child_allocation.height - default_border.top - default_border.bottom);
Elliot Lee's avatar
Elliot Lee committed
948 949
	}

950 951 952 953 954 955 956 957 958 959 960 961 962
      if (button->depressed)
	{
	  gint child_displacement_x;
	  gint child_displacement_y;
	  
	  gtk_widget_style_get (widget,
				"child_displacement_x", &child_displacement_x, 
				"child_displacement_y", &child_displacement_y,
				NULL);
	  child_allocation.x += child_displacement_x;
	  child_allocation.y += child_displacement_y;
	}

963
      gtk_widget_size_allocate (GTK_BIN (button)->child, &child_allocation);
Elliot Lee's avatar
Elliot Lee committed
964 965 966
    }
}

967 968 969 970 971 972 973
void
_gtk_button_paint (GtkButton    *button,
		   GdkRectangle *area,
		   GtkStateType  state_type,
		   GtkShadowType shadow_type,
		   const gchar  *main_detail,
		   const gchar  *default_detail)
Elliot Lee's avatar
Elliot Lee committed
974
{
975
  GtkWidget *widget;
Elliot Lee's avatar
Elliot Lee committed
976 977
  gint width, height;
  gint x, y;
978
  gint border_width;
979 980
  GtkBorder default_border;
  GtkBorder default_outside_border;
981
  gboolean interior_focus;
982 983
  gint focus_width;
  gint focus_pad;
984
   
985
  if (GTK_WIDGET_DRAWABLE (button))
Elliot Lee's avatar
Elliot Lee committed
986
    {
987
      widget = GTK_WIDGET (button);
988
      border_width = GTK_CONTAINER (widget)->border_width;
989

990
      gtk_button_get_props (button, &default_border, &default_outside_border, &interior_focus);
991 992 993 994
      gtk_widget_style_get (GTK_WIDGET (widget),
			    "focus-line-width", &focus_width,
			    "focus-padding", &focus_pad,
			    NULL); 
995
	
996 997 998 999
      x = widget->allocation.x + border_width;
      y = widget->allocation.y + border_width;
      width = widget->allocation.width - border_width * 2;
      height = widget->allocation.height - border_width * 2;
1000 1001 1002 1003 1004 1005 1006 1007 1008

      if (GTK_WIDGET_HAS_DEFAULT (widget) &&
	  GTK_BUTTON (widget)->relief == GTK_RELIEF_NORMAL)
	{
	  gtk_paint_box (widget->style, widget->window,
			 GTK_STATE_NORMAL, GTK_SHADOW_IN,
			 area, widget, "buttondefault",
			 x, y, width, height);

1009 1010 1011 1012 1013 1014
	  x += default_border.left;
	  y += default_border.top;
	  width -= default_border.left + default_border.right;
	  height -= default_border.top + default_border.bottom;
	}
      else if (GTK_WIDGET_CAN_DEFAULT (widget))
Elliot Lee's avatar
Elliot Lee committed
1015
	{
1016 1017 1018 1019
	  x += default_outside_border.left;
	  y += default_outside_border.top;
	  width -= default_outside_border.left + default_outside_border.right;
	  height -= default_outside_border.top + default_outside_border.bottom;
Elliot Lee's avatar
Elliot Lee committed
1020
	}
1021
       
1022
      if (!interior_focus && GTK_WIDGET_HAS_FOCUS (widget))
Elliot Lee's avatar
Elliot Lee committed
1023
	{
1024 1025 1026 1027
	  x += focus_width + focus_pad;
	  y += focus_width + focus_pad;
	  width -= 2 * (focus_width + focus_pad);
	  height -= 2 * (focus_width + focus_pad);
Elliot Lee's avatar
Elliot Lee committed
1028
	}