gtkbutton.c 37.1 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"
Elliot Lee's avatar
Elliot Lee committed
33
#include "gtksignal.h"
34 35 36 37
#include "gtkimage.h"
#include "gtkhbox.h"
#include "gtkstock.h"
#include "gtkiconfactory.h"
38
#include "gtkintl.h"
Elliot Lee's avatar
Elliot Lee committed
39 40

#define CHILD_SPACING     1
41

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

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

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

60
enum {
61 62
  PROP_0,
  PROP_LABEL,
63 64 65
  PROP_RELIEF,
  PROP_USE_UNDERLINE,
  PROP_USE_STOCK
66
};
67

Elliot Lee's avatar
Elliot Lee committed
68 69
static void gtk_button_class_init     (GtkButtonClass   *klass);
static void gtk_button_init           (GtkButton        *button);
70
static void gtk_button_destroy        (GtkObject        *object);
71 72 73 74 75 76 77 78
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);
Elliot Lee's avatar
Elliot Lee committed
79
static void gtk_button_realize        (GtkWidget        *widget);
80
static void gtk_button_unrealize      (GtkWidget        *widget);
81 82
static void gtk_button_map            (GtkWidget        *widget);
static void gtk_button_unmap          (GtkWidget        *widget);
Elliot Lee's avatar
Elliot Lee committed
83 84 85 86 87 88 89 90 91 92 93 94
static void gtk_button_size_request   (GtkWidget        *widget,
				       GtkRequisition   *requisition);
static void gtk_button_size_allocate  (GtkWidget        *widget,
				       GtkAllocation    *allocation);
static void gtk_button_paint          (GtkWidget        *widget,
				       GdkRectangle     *area);
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);
95 96
static gint gtk_button_key_release    (GtkWidget        *widget,
				       GdkEventKey      *event);
Elliot Lee's avatar
Elliot Lee committed
97 98 99 100 101 102
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);
103
static void gtk_real_button_activate (GtkButton         *button);
104
static void gtk_button_update_state   (GtkButton        *button);
105
static GtkType gtk_button_child_type  (GtkContainer     *container);
106 107
static void gtk_button_finish_activate (GtkButton *button,
					gboolean   do_it);
Elliot Lee's avatar
Elliot Lee committed
108

109 110 111 112 113 114
static GObject*	gtk_button_constructor     (GType                  type,
					    guint                  n_construct_properties,
					    GObjectConstructParam *construct_params);
static void     gtk_button_construct_child (GtkButton             *button);


115
static GtkBinClass *parent_class = NULL;
116
static guint button_signals[LAST_SIGNAL] = { 0 };
Elliot Lee's avatar
Elliot Lee committed
117 118


119
GtkType
120
gtk_button_get_type (void)
Elliot Lee's avatar
Elliot Lee committed
121
{
122
  static GtkType button_type = 0;
Elliot Lee's avatar
Elliot Lee committed
123 124 125

  if (!button_type)
    {
126
      static const GTypeInfo button_info =
Elliot Lee's avatar
Elliot Lee committed
127 128
      {
	sizeof (GtkButtonClass),
129 130 131 132 133 134 135 136
	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
137 138
      };

139
      button_type = g_type_register_static (GTK_TYPE_BIN, "GtkButton", &button_info, 0);
Elliot Lee's avatar
Elliot Lee committed
140 141 142 143 144 145 146 147
    }

  return button_type;
}

static void
gtk_button_class_init (GtkButtonClass *klass)
{
148
  GObjectClass *g_object_class;
Elliot Lee's avatar
Elliot Lee committed
149 150 151 152
  GtkObjectClass *object_class;
  GtkWidgetClass *widget_class;
  GtkContainerClass *container_class;

153
  g_object_class = G_OBJECT_CLASS (klass);
Elliot Lee's avatar
Elliot Lee committed
154 155 156
  object_class = (GtkObjectClass*) klass;
  widget_class = (GtkWidgetClass*) klass;
  container_class = (GtkContainerClass*) klass;
157 158
  
  parent_class = g_type_class_peek_parent (klass);
159

160 161 162
  g_object_class->constructor = gtk_button_constructor;
  g_object_class->set_property = gtk_button_set_property;
  g_object_class->get_property = gtk_button_get_property;
163

164 165
  object_class->destroy = gtk_button_destroy;

166
  widget_class->realize = gtk_button_realize;
167
  widget_class->unrealize = gtk_button_unrealize;
168 169
  widget_class->map = gtk_button_map;
  widget_class->unmap = gtk_button_unmap;
170 171 172 173 174
  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;
175
  widget_class->key_release_event = gtk_button_key_release;
176 177 178 179 180 181 182 183
  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;
184 185
  klass->enter = gtk_button_update_state;
  klass->leave = gtk_button_update_state;
186
  klass->activate = gtk_real_button_activate;
187

188 189 190 191 192 193
  g_object_class_install_property (G_OBJECT_CLASS(object_class),
                                   PROP_LABEL,
                                   g_param_spec_string ("label",
                                                        _("Label"),
                                                        _("Text of the label widget inside the button, if the button contains a label widget."),
                                                        NULL,
194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210
                                                        G_PARAM_READWRITE | G_PARAM_CONSTRUCT));
  
  g_object_class_install_property (G_OBJECT_CLASS(object_class),
                                   PROP_USE_UNDERLINE,
                                   g_param_spec_boolean ("use_underline",
							 _("Use underline"),
							 _("If set, an underline in the text indicates the next character should be used for the mnemonic accelerator key"),
                                                        FALSE,
                                                        G_PARAM_READWRITE | G_PARAM_CONSTRUCT));
  
  g_object_class_install_property (G_OBJECT_CLASS(object_class),
                                   PROP_USE_STOCK,
                                   g_param_spec_boolean ("use_stock",
							 _("Use stock"),
							 _("If set, the label is used to pick a stock item instead of being displayed"),
                                                        FALSE,
                                                        G_PARAM_READWRITE | G_PARAM_CONSTRUCT));
211 212 213 214 215 216 217 218 219
  
  g_object_class_install_property (G_OBJECT_CLASS(object_class),
                                   PROP_RELIEF,
                                   g_param_spec_enum ("relief",
                                                      _("Border relief"),
                                                      _("The border relief style."),
                                                      GTK_TYPE_RELIEF_STYLE,
                                                      GTK_RELIEF_NORMAL,
                                                      G_PARAM_READABLE | G_PARAM_WRITABLE));
Elliot Lee's avatar
Elliot Lee committed
220 221 222

  button_signals[PRESSED] =
    gtk_signal_new ("pressed",
223
                    GTK_RUN_FIRST,
224
                    GTK_CLASS_TYPE (object_class),
Elliot Lee's avatar
Elliot Lee committed
225
                    GTK_SIGNAL_OFFSET (GtkButtonClass, pressed),
226
                    _gtk_marshal_VOID__VOID,
Elliot Lee's avatar
Elliot Lee committed
227 228 229
		    GTK_TYPE_NONE, 0);
  button_signals[RELEASED] =
    gtk_signal_new ("released",
230
                    GTK_RUN_FIRST,
231
                    GTK_CLASS_TYPE (object_class),
Elliot Lee's avatar
Elliot Lee committed
232
                    GTK_SIGNAL_OFFSET (GtkButtonClass, released),
233
                    _gtk_marshal_VOID__VOID,
Elliot Lee's avatar
Elliot Lee committed
234 235 236
		    GTK_TYPE_NONE, 0);
  button_signals[CLICKED] =
    gtk_signal_new ("clicked",
237
                    GTK_RUN_FIRST | GTK_RUN_ACTION,
238
                    GTK_CLASS_TYPE (object_class),
Elliot Lee's avatar
Elliot Lee committed
239
                    GTK_SIGNAL_OFFSET (GtkButtonClass, clicked),
240
                    _gtk_marshal_VOID__VOID,
Elliot Lee's avatar
Elliot Lee committed
241 242 243
		    GTK_TYPE_NONE, 0);
  button_signals[ENTER] =
    gtk_signal_new ("enter",
244
                    GTK_RUN_FIRST,
245
                    GTK_CLASS_TYPE (object_class),
246
                    GTK_SIGNAL_OFFSET (GtkButtonClass, enter),
247
                    _gtk_marshal_VOID__VOID,
Elliot Lee's avatar
Elliot Lee committed
248 249 250
		    GTK_TYPE_NONE, 0);
  button_signals[LEAVE] =
    gtk_signal_new ("leave",
251
                    GTK_RUN_FIRST,
252
                    GTK_CLASS_TYPE (object_class),
253
                    GTK_SIGNAL_OFFSET (GtkButtonClass, leave),
254
                    _gtk_marshal_VOID__VOID,
Elliot Lee's avatar
Elliot Lee committed
255
		    GTK_TYPE_NONE, 0);
256 257
  button_signals[ACTIVATE] =
    gtk_signal_new ("activate",
258
                    GTK_RUN_FIRST,
259 260
                    GTK_CLASS_TYPE (object_class),
                    GTK_SIGNAL_OFFSET (GtkButtonClass, activate),
261
                    _gtk_marshal_VOID__VOID,
262 263
		    GTK_TYPE_NONE, 0);
  widget_class->activate_signal = button_signals[ACTIVATE];
264 265

  gtk_widget_class_install_style_property (widget_class,
266 267 268 269 270 271 272 273 274 275 276 277
					   g_param_spec_boxed ("default_border",
							       _("Default Spacing"),
							       _("Extra space to add for CAN_DEFAULT buttons"),
							       GTK_TYPE_BORDER,
							       G_PARAM_READABLE));

  gtk_widget_class_install_style_property (widget_class,
					   g_param_spec_boxed ("default_outside_border",
							       _("Default Outside Spacing"),
							       _("Extra space to add for CAN_DEFAULT buttons that is always drawn outside the border"),
							       GTK_TYPE_BORDER,
							       G_PARAM_READABLE));
278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293
  gtk_widget_class_install_style_property (widget_class,
					   g_param_spec_int ("child_displacement_x",
							     _("Child X Displacement"),
							     _("How far in the x direction to move the child when the button is depressed"),
							     G_MININT,
							     G_MAXINT,
							     0,
							     G_PARAM_READABLE));
  gtk_widget_class_install_style_property (widget_class,
					   g_param_spec_int ("child_displacement_y",
							     _("Child Y Displacement"),
							     _("How far in the y direction to move the child when the button is depressed"),
							     G_MININT,
							     G_MAXINT,
							     0,
							     G_PARAM_READABLE));
Elliot Lee's avatar
Elliot Lee committed
294 295 296 297 298
}

static void
gtk_button_init (GtkButton *button)
{
299
  GTK_WIDGET_SET_FLAGS (button, GTK_CAN_FOCUS | GTK_RECEIVES_DEFAULT);
300
  GTK_WIDGET_SET_FLAGS (button, GTK_NO_WINDOW);
Elliot Lee's avatar
Elliot Lee committed
301

302 303 304
  button->label_text = NULL;
  
  button->constructed = FALSE;
Elliot Lee's avatar
Elliot Lee committed
305 306
  button->in_button = FALSE;
  button->button_down = FALSE;
307
  button->relief = GTK_RELIEF_NORMAL;
308 309
  button->use_stock = FALSE;
  button->use_underline = FALSE;
310
  button->depressed = FALSE;
Elliot Lee's avatar
Elliot Lee committed
311 312
}

313 314 315 316 317 318 319 320 321 322 323 324 325 326
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);
}

327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348
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;
}


349 350 351
static GtkType
gtk_button_child_type  (GtkContainer     *container)
{
352
  if (!GTK_BIN (container)->child)
353 354 355 356 357
    return GTK_TYPE_WIDGET;
  else
    return GTK_TYPE_NONE;
}

Elliot Lee's avatar
Elliot Lee committed
358
static void
359 360 361 362
gtk_button_set_property (GObject         *object,
                         guint            prop_id,
                         const GValue    *value,
                         GParamSpec      *pspec)
Elliot Lee's avatar
Elliot Lee committed
363
{
364 365 366
  GtkButton *button;

  button = GTK_BUTTON (object);
Elliot Lee's avatar
Elliot Lee committed
367

368
  switch (prop_id)
369
    {
370
    case PROP_LABEL:
371
      gtk_button_set_label (button, g_value_get_string (value));
372
      break;
373 374
    case PROP_RELIEF:
      gtk_button_set_relief (button, g_value_get_enum (value));
375
      break;
376 377 378 379 380 381
    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;
382
    default:
383
      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
384 385 386 387 388
      break;
    }
}

static void
389 390 391 392
gtk_button_get_property (GObject         *object,
                         guint            prop_id,
                         GValue          *value,
                         GParamSpec      *pspec)
393
{
394 395 396 397
  GtkButton *button;

  button = GTK_BUTTON (object);

398
  switch (prop_id)
399
    {
400
    case PROP_LABEL:
401
      g_value_set_string (value, button->label_text);
402
      break;
403
    case PROP_RELIEF:
Alexander Larsson's avatar
Alexander Larsson committed
404
      g_value_set_enum (value, gtk_button_get_relief (button));
405
      break;
406 407 408 409 410 411
    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;
Tim Janik's avatar
Tim Janik committed
412
    default:
413
      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
Tim Janik's avatar
Tim Janik committed
414
      break;
Elliot Lee's avatar
Elliot Lee committed
415 416 417 418
    }
}

GtkWidget*
419
gtk_button_new (void)
Elliot Lee's avatar
Elliot Lee committed
420 421 422 423
{
  return GTK_WIDGET (gtk_type_new (gtk_button_get_type ()));
}

424 425
static void
gtk_button_construct_child (GtkButton *button)
Elliot Lee's avatar
Elliot Lee committed
426
{
427 428 429 430
  GtkStockItem item;
  GtkWidget *label;
  GtkWidget *image;
  GtkWidget *hbox;
431
  GtkWidget *align;
Elliot Lee's avatar
Elliot Lee committed
432

433 434 435 436 437
  if (!button->constructed)
    return;
  
  if (button->label_text == NULL)
    return;
Elliot Lee's avatar
Elliot Lee committed
438

439 440 441
  if (GTK_BIN (button)->child)
    gtk_container_remove (GTK_CONTAINER (button),
			  GTK_BIN (button)->child);
442

443 444 445
  
  if (button->use_stock &&
      gtk_stock_lookup (button->label_text, &item))
446
    {
447 448
      label = gtk_label_new_with_mnemonic (item.label);

449 450 451
      gtk_label_set_mnemonic_widget (GTK_LABEL (label), GTK_WIDGET (button));
      
      image = gtk_image_new_from_stock (button->label_text, GTK_ICON_SIZE_BUTTON);
452
      hbox = gtk_hbox_new (FALSE, 2);
453

454 455
      align = gtk_alignment_new (0.5, 0.5, 0.0, 0.0);
      
Havoc Pennington's avatar
Havoc Pennington committed
456
      gtk_box_pack_start (GTK_BOX (hbox), image, FALSE, FALSE, 0);
457
      gtk_box_pack_end (GTK_BOX (hbox), label, FALSE, FALSE, 0);
458
      
459 460 461
      gtk_container_add (GTK_CONTAINER (button), align);
      gtk_container_add (GTK_CONTAINER (align), hbox);
      gtk_widget_show_all (align);
462 463

      return;
464
    }
465 466

  if (button->use_underline)
467
    {
468 469
      label = gtk_label_new_with_mnemonic (button->label_text);
      gtk_label_set_mnemonic_widget (GTK_LABEL (label), GTK_WIDGET (button));
470
    }
471 472
  else
    label = gtk_label_new (button->label_text);
473
  
474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493
  gtk_misc_set_alignment (GTK_MISC (label), 0.5, 0.5);

  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.
494 495 496 497 498
 *
 * 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
499 500
 **/
GtkWidget*
501
gtk_button_new_from_stock (const gchar *stock_id)
502
{
503 504 505 506 507
  return g_object_new (GTK_TYPE_BUTTON,
                       "label", stock_id,
                       "use_stock", TRUE,
                       "use_underline", TRUE,
                       NULL);
508 509
}

510 511 512 513 514 515 516 517 518 519 520
/**
 * 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.
 * If characters in @label are preceded by an underscore, they are underlined
 * indicating that they represent a keyboard accelerator called a mnemonic.
 * Pressing Alt and that key activates the button.
 **/
521
GtkWidget*
522
gtk_button_new_with_mnemonic (const gchar *label)
523
{
524
  return g_object_new (GTK_TYPE_BUTTON, "label", label, "use_underline", TRUE,  NULL);
525 526
}

Elliot Lee's avatar
Elliot Lee committed
527 528 529
void
gtk_button_pressed (GtkButton *button)
{
530 531
  g_return_if_fail (GTK_IS_BUTTON (button));

Elliot Lee's avatar
Elliot Lee committed
532 533 534 535 536 537
  gtk_signal_emit (GTK_OBJECT (button), button_signals[PRESSED]);
}

void
gtk_button_released (GtkButton *button)
{
538 539
  g_return_if_fail (GTK_IS_BUTTON (button));

Elliot Lee's avatar
Elliot Lee committed
540 541 542 543 544 545
  gtk_signal_emit (GTK_OBJECT (button), button_signals[RELEASED]);
}

void
gtk_button_clicked (GtkButton *button)
{
546 547
  g_return_if_fail (GTK_IS_BUTTON (button));

Elliot Lee's avatar
Elliot Lee committed
548 549 550 551 552 553
  gtk_signal_emit (GTK_OBJECT (button), button_signals[CLICKED]);
}

void
gtk_button_enter (GtkButton *button)
{
554 555
  g_return_if_fail (GTK_IS_BUTTON (button));

Elliot Lee's avatar
Elliot Lee committed
556 557 558 559 560 561
  gtk_signal_emit (GTK_OBJECT (button), button_signals[ENTER]);
}

void
gtk_button_leave (GtkButton *button)
{
562 563
  g_return_if_fail (GTK_IS_BUTTON (button));

Elliot Lee's avatar
Elliot Lee committed
564 565 566
  gtk_signal_emit (GTK_OBJECT (button), button_signals[LEAVE]);
}

567 568 569 570 571 572 573
void
gtk_button_set_relief (GtkButton *button,
		       GtkReliefStyle newrelief)
{
  g_return_if_fail (GTK_IS_BUTTON (button));

  button->relief = newrelief;
574
  g_object_notify(G_OBJECT(button), "relief");
575
  gtk_widget_queue_draw (GTK_WIDGET (button));
576 577 578
}

GtkReliefStyle
579
gtk_button_get_relief (GtkButton *button)
580 581 582 583 584 585 586
{
  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
587 588 589 590 591 592
static void
gtk_button_realize (GtkWidget *widget)
{
  GtkButton *button;
  GdkWindowAttr attributes;
  gint attributes_mask;
Owen Taylor's avatar
Owen Taylor committed
593
  gint border_width;
Elliot Lee's avatar
Elliot Lee committed
594 595 596 597 598 599

  g_return_if_fail (GTK_IS_BUTTON (widget));

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

Owen Taylor's avatar
Owen Taylor committed
600 601
  border_width = GTK_CONTAINER (widget)->border_width;

Elliot Lee's avatar
Elliot Lee committed
602
  attributes.window_type = GDK_WINDOW_CHILD;
Owen Taylor's avatar
Owen Taylor committed
603 604 605 606
  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;
607
  attributes.wclass = GDK_INPUT_ONLY;
Elliot Lee's avatar
Elliot Lee committed
608 609 610 611 612 613 614
  attributes.event_mask = gtk_widget_get_events (widget);
  attributes.event_mask |= (GDK_EXPOSURE_MASK |
			    GDK_BUTTON_PRESS_MASK |
			    GDK_BUTTON_RELEASE_MASK |
			    GDK_ENTER_NOTIFY_MASK |
			    GDK_LEAVE_NOTIFY_MASK);

615
  attributes_mask = GDK_WA_X | GDK_WA_Y;
Elliot Lee's avatar
Elliot Lee committed
616

617 618 619 620 621 622
  widget->window = gtk_widget_get_parent_window (widget);
  gdk_window_ref (widget->window);
  
  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
623 624 625 626

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

627 628 629 630 631 632 633
static void
gtk_button_unrealize (GtkWidget *widget)
{
  GtkButton *button = GTK_BUTTON (widget);

  if (button->activate_timeout)
    gtk_button_finish_activate (button, FALSE);
634 635 636 637 638 639 640 641

  if (button->event_window)
    {
      gdk_window_set_user_data (button->event_window, NULL);
      gdk_window_destroy (button->event_window);
      button->event_window = NULL;
    }
  
642 643 644
  GTK_WIDGET_CLASS (parent_class)->unrealize (widget);
}

645 646 647 648 649 650 651
static void
gtk_button_map (GtkWidget *widget)
{
  GtkButton *button = GTK_BUTTON (widget);
  
  g_return_if_fail (GTK_IS_BUTTON (widget));

652 653
  GTK_WIDGET_CLASS (parent_class)->map (widget);

654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670
  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
671
static void
672
gtk_button_get_props (GtkButton *button,
673 674
		      GtkBorder *default_border,
		      GtkBorder *default_outside_border,
675
		      gboolean  *interior_focus)
Elliot Lee's avatar
Elliot Lee committed
676
{
677
  GtkWidget *widget =  GTK_WIDGET (button);
678 679 680 681 682 683 684 685 686 687 688 689 690 691
  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
692

693 694 695 696 697 698 699 700 701 702 703 704
  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
705

706 707 708 709 710 711 712 713 714
  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);
715
  GtkBorder default_border;
716
  gboolean interior_focus;
Elliot Lee's avatar
Elliot Lee committed
717

718
  gtk_button_get_props (button, &default_border, NULL, &interior_focus);
719
  
Elliot Lee's avatar
Elliot Lee committed
720
  requisition->width = (GTK_CONTAINER (widget)->border_width + CHILD_SPACING +
721
			GTK_WIDGET (widget)->style->xthickness) * 2;
Elliot Lee's avatar
Elliot Lee committed
722
  requisition->height = (GTK_CONTAINER (widget)->border_width + CHILD_SPACING +
723
			 GTK_WIDGET (widget)->style->ythickness) * 2;
Elliot Lee's avatar
Elliot Lee committed
724 725 726

  if (GTK_WIDGET_CAN_DEFAULT (widget))
    {
727 728
      requisition->width += default_border.left + default_border.right;
      requisition->height += default_border.top + default_border.bottom;
Elliot Lee's avatar
Elliot Lee committed
729 730
    }

731
  if (GTK_BIN (button)->child && GTK_WIDGET_VISIBLE (GTK_BIN (button)->child))
Elliot Lee's avatar
Elliot Lee committed
732
    {
733
      GtkRequisition child_requisition;
Elliot Lee's avatar
Elliot Lee committed
734

735 736 737 738
      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
739
    }
740 741 742 743 744 745

  if (interior_focus)
    {
      requisition->width += 2;
      requisition->height += 2;
    }
Elliot Lee's avatar
Elliot Lee committed
746 747 748 749 750 751
}

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

755 756 757
  gint border_width = GTK_CONTAINER (widget)->border_width;
  gint xthickness = GTK_WIDGET (widget)->style->xthickness;
  gint ythickness = GTK_WIDGET (widget)->style->ythickness;
758
  GtkBorder default_border;
Elliot Lee's avatar
Elliot Lee committed
759

760
  gtk_button_get_props (button, &default_border, NULL, NULL);
761
  
Elliot Lee's avatar
Elliot Lee committed
762 763 764
  widget->allocation = *allocation;

  if (GTK_WIDGET_REALIZED (widget))
765
    gdk_window_move_resize (button->event_window,
Elliot Lee's avatar
Elliot Lee committed
766 767 768 769 770
			    widget->allocation.x + border_width,
			    widget->allocation.y + border_width,
			    widget->allocation.width - border_width * 2,
			    widget->allocation.height - border_width * 2);

771
  if (GTK_BIN (button)->child && GTK_WIDGET_VISIBLE (GTK_BIN (button)->child))
Elliot Lee's avatar
Elliot Lee committed
772
    {
773 774
      child_allocation.x = widget->allocation.x + border_width + (CHILD_SPACING + xthickness);
      child_allocation.y = widget->allocation.y + border_width + (CHILD_SPACING + ythickness);
Elliot Lee's avatar
Elliot Lee committed
775

776
      child_allocation.width = MAX (1, (gint)widget->allocation.width - (CHILD_SPACING + xthickness) * 2 -
Owen Taylor's avatar
Owen Taylor committed
777
	                         border_width * 2);
778
      child_allocation.height = MAX (1, (gint)widget->allocation.height - (CHILD_SPACING + ythickness) * 2 -
Owen Taylor's avatar
Owen Taylor committed
779
	                          border_width * 2);
Elliot Lee's avatar
Elliot Lee committed
780 781 782

      if (GTK_WIDGET_CAN_DEFAULT (button))
	{
783 784 785 786
	  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
787 788
	}

789 790 791 792 793 794 795 796 797 798 799 800 801
      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;
	}

802
      gtk_widget_size_allocate (GTK_BIN (button)->child, &child_allocation);
Elliot Lee's avatar
Elliot Lee committed
803 804 805
    }
}

806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831
/*
 * +------------------------------------------------+
 * |                   BORDER                       |
 * |  +------------------------------------------+  |
 * |  |\\\\\\\\\\\\\\\\DEFAULT\\\\\\\\\\\\\\\\\  |  |
 * |  |\\+------------------------------------+  |  |
 * |  |\\| |           SPACING       3      | |  |  |
 * |  |\\| +--------------------------------+ |  |  |
 * |  |\\| |########## FOCUS ###############| |  |  |
 * |  |\\| |#+----------------------------+#| |  |  |
 * |  |\\| |#|         RELIEF            \|#| |  |  |
 * |  |\\| |#|  +-----------------------+\|#| |  |  |
 * |  |\\|1|#|  +     THE TEXT          +\|#|2|  |  |
 * |  |\\| |#|  +-----------------------+\|#| |  |  |
 * |  |\\| |#| \\\\\ ythickness \\\\\\\\\\|#| |  |  |
 * |  |\\| |#+----------------------------+#| |  |  |
 * |  |\\| |########### 1 ##################| |  |  |
 * |  |\\| +--------------------------------+ |  |  |
 * |  |\\| |        default spacing   4     | |  |  |
 * |  |\\+------------------------------------+  |  |
 * |  |\            ythickness                   |  |
 * |  +------------------------------------------+  |
 * |                border_width                    |
 * +------------------------------------------------+
 */

Elliot Lee's avatar
Elliot Lee committed
832 833 834 835 836 837 838 839
static void
gtk_button_paint (GtkWidget    *widget,
		  GdkRectangle *area)
{
  GtkButton *button;
  GtkShadowType shadow_type;
  gint width, height;
  gint x, y;
840
  gint border_width;
841 842
  GtkBorder default_border;
  GtkBorder default_outside_border;
843
  gboolean interior_focus;
844
   
Elliot Lee's avatar
Elliot Lee committed
845 846
  if (GTK_WIDGET_DRAWABLE (widget))
    {
847
      border_width = GTK_CONTAINER (widget)->border_width;
Elliot Lee's avatar
Elliot Lee committed
848
      button = GTK_BUTTON (widget);
849

850
      gtk_button_get_props (button, &default_border, &default_outside_border, &interior_focus);
851
	
852 853 854 855
      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;
856 857 858 859 860 861 862 863 864

      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);

865 866 867 868 869 870
	  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
871
	{
872 873 874 875
	  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
876
	}
877
       
878
      if (!interior_focus && GTK_WIDGET_HAS_FOCUS (widget))
Elliot Lee's avatar
Elliot Lee committed
879 880 881 882 883 884
	{
	  x += 1;
	  y += 1;
	  width -= 2;
	  height -= 2;
	}
885 886

      shadow_type = button->depressed ? GTK_SHADOW_IN : GTK_SHADOW_OUT;
Elliot Lee's avatar
Elliot Lee committed
887

888 889 890 891 892 893 894 895
      if ((button->relief != GTK_RELIEF_NONE) ||
	  ((GTK_WIDGET_STATE(widget) != GTK_STATE_NORMAL) &&
	   (GTK_WIDGET_STATE(widget) != GTK_STATE_INSENSITIVE)))
	gtk_paint_box (widget->style, widget->window,
		       GTK_WIDGET_STATE (widget),
		       shadow_type, area, widget, "button",
		       x, y, width, height);
       
Elliot Lee's avatar
Elliot Lee committed
896 897
      if (GTK_WIDGET_HAS_FOCUS (widget))
	{
898 899 900 901 902 903 904 905 906 907 908 909 910 911
	  if (interior_focus)
	    {
	      x += widget->style->xthickness + 1;
	      y += widget->style->ythickness + 1;
	      width -= 2 * (widget->style->xthickness + 1);
	      height -=  2 * (widget->style->xthickness + 1);
	    }
	  else
	    {
	      x -= 1;
	      y -= 1;
	      width += 2;
	      height += 2;
	    }
Elliot Lee's avatar
Elliot Lee committed
912

913 914 915
	  gtk_paint_focus (widget->style, widget->window,
			   area, widget, "button",
			   x, y, width - 1, height - 1);
Elliot Lee's avatar
Elliot Lee committed
916 917 918 919
	}
    }
}

920
static gboolean
Elliot Lee's avatar
Elliot Lee committed
921 922 923
gtk_button_expose (GtkWidget      *widget,
		   GdkEventExpose *event)
{
924
  GtkBin *bin;
Elliot Lee's avatar
Elliot Lee committed
925 926 927 928 929 930 931

  g_return_val_if_fail (widget != NULL, FALSE);
  g_return_val_if_fail (GTK_IS_BUTTON (widget), FALSE);
  g_return_val_if_fail (event != NULL, FALSE);

  if (GTK_WIDGET_DRAWABLE (widget))
    {
Owen Taylor's avatar
Owen Taylor committed
932
      bin = GTK_BIN (widget);
933
      
Elliot Lee's avatar
Elliot Lee committed
934
      gtk_button_paint (widget, &event->area);
935 936
      
      (* GTK_WIDGET_CLASS (parent_class)->expose_event) (widget, event);
Elliot Lee's avatar
Elliot Lee committed
937
    }
938
  
Elliot Lee's avatar
Elliot Lee committed
939 940 941
  return FALSE;
}

942
static gboolean
Elliot Lee's avatar
Elliot Lee committed
943 944 945 946 947 948 949 950 951 952 953 954 955 956 957 958 959
gtk_button_button_press (GtkWidget      *widget,
			 GdkEventButton *event)
{
  GtkButton *button;

  g_return_val_if_fail (widget != NULL, FALSE);
  g_return_val_if_fail (GTK_IS_BUTTON (widget), FALSE);
  g_return_val_if_fail (event != NULL, FALSE);

  if (event->type == GDK_BUTTON_PRESS)
    {
      button = GTK_BUTTON (widget);

      if (!GTK_WIDGET_HAS_FOCUS (widget))
	gtk_widget_grab_focus (widget);

      if (event->button == 1)
960
	gtk_button_pressed (button);
Elliot Lee's avatar
Elliot Lee committed
961 962 963 964 965
    }

  return TRUE;
}

966
static gboolean
Elliot Lee's avatar
Elliot Lee committed
967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984
gtk_button_button_release (GtkWidget      *widget,
			   GdkEventButton *event)
{
  GtkButton *button;

  g_return_val_if_fail (widget != NULL, FALSE);
  g_return_val_if_fail (GTK_IS_BUTTON (widget), FALSE);
  g_return_val_if_fail (event != NULL, FALSE);

  if (event->button == 1)
    {
      button = GTK_BUTTON (widget);
      gtk_button_released (button);
    }

  return TRUE;
}

985 986 987 988 989 990 991 992 993 994 995 996 997 998 999 1000 1001
static gboolean
gtk_button_key_release (GtkWidget   *widget,
			GdkEventKey *event)
{
  GtkButton *button = GTK_BUTTON (widget);

  if (button->activate_timeout)
    {
      gtk_button_finish_activate (button, TRUE);
      return TRUE;
    }
  else if (GTK_WIDGET_CLASS (parent_class)->key_release_event)
    return GTK_WIDGET_CLASS (parent_class)->key_release_event (widget, event);
  else
    return FALSE;
}

1002
static gboolean
Elliot Lee's avatar
Elliot Lee committed
1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025
gtk_button_enter_notify (GtkWidget        *widget,
			 GdkEventCrossing *event)
{
  GtkButton *button;
  GtkWidget *event_widget;

  g_return_val_if_fail (widget != NULL, FALSE);
  g_return_val_if_fail (GTK_IS_BUTTON (widget), FALSE);
  g_return_val_if_fail (event != NULL, FALSE);

  button = GTK_BUTTON (widget);
  event_widget = gtk_get_event_widget ((GdkEvent*) event);

  if ((event_widget == widget) &&
      (event->detail != GDK_NOTIFY_INFERIOR))
    {
      button->in_button = TRUE;
      gtk_button_enter (button);
    }

  return FALSE;
}

1026
static gboolean
Elliot Lee's avatar
Elliot Lee committed
1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052
gtk_button_leave_notify (GtkWidget        *widget,
			 GdkEventCrossing *event)
{
  GtkButton *button;
  GtkWidget *event_widget;

  g_return_val_if_fail (widget != NULL, FALSE);
  g_return_val_if_fail (GTK_IS_BUTTON (widget), FALSE);
  g_return_val_if_fail (event != NULL, FALSE);

  button = GTK_BUTTON (widget);
  event_widget = gtk_get_event_widget ((GdkEvent*) event);

  if ((event_widget == widget) &&
      (event->detail != GDK_NOTIFY_INFERIOR))
    {
      button->in_button = FALSE;
      gtk_button_leave (button);
    }

  return FALSE;
}

static void
gtk_real_button_pressed (GtkButton *button)
{
1053 1054 1055
  if (button->activate_timeout)
    return;
  
Elliot Lee's avatar
Elliot Lee committed
1056
  button->button_down = TRUE;
1057
  gtk_button_update_state (button);
Elliot Lee's avatar
Elliot Lee committed
1058 1059 1060 1061 1062 1063 1064 1065 1066
}

static void
gtk_real_button_released (GtkButton *button)
{
  if (button->button_down)
    {
      button->button_down = FALSE;

1067 1068
      if (button->activate_timeout)
	return;
1069
      
Elliot Lee's avatar
Elliot Lee committed
1070 1071 1072
      if (button->in_button)
	gtk_button_clicked (button);

1073
      gtk_button_update_state (button);
Elliot Lee's avatar
Elliot Lee committed
1074 1075
    }
}
1076 1077 1078 1079

static gboolean
button_activate_timeout (gpointer data)
{
1080 1081
  GDK_THREADS_ENTER ();
  
1082 1083
  gtk_button_finish_activate (data, TRUE);

1084 1085
  GDK_THREADS_LEAVE ();

1086 1087 1088 1089 1090 1091 1092 1093 1094 1095 1096 1097
  return FALSE;
}

static void
gtk_real_button_activate (GtkButton *button)
{
  GtkWidget *widget = GTK_WIDGET (button);
  
  g_return_if_fail (GTK_IS_BUTTON (button));

  if (GTK_WIDGET_REALIZED (button) && !button->activate_timeout)
    {
1098
      if (gdk_keyboard_grab (button->event_window, TRUE,