gtktoolbutton.c 39 KB
Newer Older
1 2
/* gtktoolbutton.c
 *
3
 * Copyright (C) 2002 Anders Carlsson <andersca@gnome.org>
4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22
 * Copyright (C) 2002 James Henstridge <james@daa.com.au>
 * Copyright (C) 2003 Soeren Sandmann <sandmann@daimi.au.dk>
 *
 * 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
 * License along with this library; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
 */

23
#include "config.h"
24 25 26 27 28 29 30
#include "gtktoolbutton.h"
#include "gtkbutton.h"
#include "gtkiconfactory.h"
#include "gtkimage.h"
#include "gtkimagemenuitem.h"
#include "gtklabel.h"
#include "gtkstock.h"
Matthias Clasen's avatar
Matthias Clasen committed
31
#include "gtkbox.h"
32
#include "gtkintl.h"
33
#include "gtktoolbar.h"
34
#include "gtkactivatable.h"
35
#include "gtkprivate.h"
36 37 38

#include <string.h>

39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69

/**
 * SECTION:gtktoolbutton
 * @Short_description: A GtkToolItem subclass that displays buttons
 * @Title: GtkToolButton
 * @See_also: #GtkToolbar, #GtkMenuToolButton, #GtkToggleToolButton,
 *   #GtkRadioToolButton, #GtkSeparatorToolItem
 *
 * #GtkToolButton<!-- -->s are #GtkToolItems containing buttons.
 *
 * Use gtk_tool_button_new() to create a new #GtkToolButton. Use
 * gtk_tool_button_new_with_stock() to create a #GtkToolButton
 * containing a stock item.
 *
 * The label of a #GtkToolButton is determined by the properties
 * #GtkToolButton:label-widget, #GtkToolButton:label, and
 * #GtkToolButton:stock-id. If #GtkToolButton:label-widget is
 * non-%NULL, then that widget is used as the label. Otherwise, if
 * #GtkToolButton:label is non-%NULL, that string is used as the label.
 * Otherwise, if #GtkToolButton:stock-id is non-%NULL, the label is
 * determined by the stock item. Otherwise, the button does not have a label.
 *
 * The icon of a #GtkToolButton is determined by the properties
 * #GtkToolButton:icon-widget and #GtkToolButton:stock-id. If
 * #GtkToolButton:icon-widget is non-%NULL, then
 * that widget is used as the icon. Otherwise, if #GtkToolButton:stock-id is
 * non-%NULL, the icon is determined by the stock item. Otherwise,
 * the button does not have a icon.
 */


70 71 72 73 74 75 76 77 78 79 80 81 82
#define MENU_ID "gtk-tool-button-menu-id"

enum {
  CLICKED,
  LAST_SIGNAL
};

enum {
  PROP_0,
  PROP_LABEL,
  PROP_USE_UNDERLINE,
  PROP_LABEL_WIDGET,
  PROP_STOCK_ID,
83
  PROP_ICON_NAME,
84
  PROP_ICON_WIDGET
85 86 87 88 89 90 91 92 93 94 95 96 97
};

static void gtk_tool_button_init          (GtkToolButton      *button,
					   GtkToolButtonClass *klass);
static void gtk_tool_button_class_init    (GtkToolButtonClass *klass);
static void gtk_tool_button_set_property  (GObject            *object,
					   guint               prop_id,
					   const GValue       *value,
					   GParamSpec         *pspec);
static void gtk_tool_button_get_property  (GObject            *object,
					   guint               prop_id,
					   GValue             *value,
					   GParamSpec         *pspec);
98 99
static void gtk_tool_button_property_notify (GObject          *object,
					     GParamSpec       *pspec);
100 101 102 103 104 105
static void gtk_tool_button_finalize      (GObject            *object);

static void gtk_tool_button_toolbar_reconfigured (GtkToolItem *tool_item);
static gboolean   gtk_tool_button_create_menu_proxy (GtkToolItem     *item);
static void       button_clicked                    (GtkWidget       *widget,
						     GtkToolButton   *button);
106
static void gtk_tool_button_style_updated  (GtkWidget          *widget);
107 108 109

static void gtk_tool_button_construct_contents (GtkToolItem *tool_item);

110
static void gtk_tool_button_activatable_interface_init (GtkActivatableIface  *iface);
111
static void gtk_tool_button_update                     (GtkActivatable       *activatable,
112 113
							GtkAction            *action,
							const gchar          *property_name);
114
static void gtk_tool_button_sync_action_properties     (GtkActivatable       *activatable,
115 116
							GtkAction            *action);

Matthias Clasen's avatar
Matthias Clasen committed
117

118 119 120 121 122
struct _GtkToolButtonPrivate
{
  GtkWidget *button;

  gchar *stock_id;
123
  gchar *icon_name;
124 125 126
  gchar *label_text;
  GtkWidget *label_widget;
  GtkWidget *icon_widget;
127 128 129

  GtkSizeGroup *text_size_group;

130
  guint use_underline : 1;
131
  guint contents_invalid : 1;
132 133
};

134 135 136 137 138
static GObjectClass        *parent_class = NULL;
static GtkActivatableIface *parent_activatable_iface;
static guint                toolbutton_signals[LAST_SIGNAL] = { 0 };


139 140 141
GType
gtk_tool_button_get_type (void)
{
Michael Natterer's avatar
Michael Natterer committed
142
  static GType type = 0;
143
  
144
  if (!type)
145
    {
146
      const GInterfaceInfo activatable_info =
147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163
      {
        (GInterfaceInitFunc) gtk_tool_button_activatable_interface_init,
        (GInterfaceFinalizeFunc) NULL,
        NULL
      };

      type = g_type_register_static_simple (GTK_TYPE_TOOL_ITEM,
					    I_("GtkToolButton"),
					    sizeof (GtkToolButtonClass),
					    (GClassInitFunc) gtk_tool_button_class_init,
					    sizeof (GtkToolButton),
					    (GInstanceInitFunc) gtk_tool_button_init,
					    0);

      g_type_add_interface_static (type, GTK_TYPE_ACTIVATABLE,
                                   &activatable_info);
    }
164 165 166 167 168 169 170
  return type;
}

static void
gtk_tool_button_class_init (GtkToolButtonClass *klass)
{
  GObjectClass *object_class;
171
  GtkWidgetClass *widget_class;
172 173 174 175 176
  GtkToolItemClass *tool_item_class;
  
  parent_class = g_type_class_peek_parent (klass);
  
  object_class = (GObjectClass *)klass;
177
  widget_class = (GtkWidgetClass *)klass;
178 179 180 181
  tool_item_class = (GtkToolItemClass *)klass;
  
  object_class->set_property = gtk_tool_button_set_property;
  object_class->get_property = gtk_tool_button_get_property;
182
  object_class->notify = gtk_tool_button_property_notify;
183 184
  object_class->finalize = gtk_tool_button_finalize;

185
  widget_class->style_updated = gtk_tool_button_style_updated;
186

187 188 189 190 191
  tool_item_class->create_menu_proxy = gtk_tool_button_create_menu_proxy;
  tool_item_class->toolbar_reconfigured = gtk_tool_button_toolbar_reconfigured;
  
  klass->button_type = GTK_TYPE_BUTTON;

192 193 194 195 196
  /* Properties are interpreted like this:
   *
   *          - if the tool button has an icon_widget, then that widget
   *            will be used as the icon. Otherwise, if the tool button
   *            has a stock id, the corresponding stock icon will be
197 198 199
   *            used. Otherwise, if the tool button has an icon name,
   *            the corresponding icon from the theme will be used.
   *            Otherwise, the tool button will not have an icon.
200 201 202 203 204
   *
   *          - if the tool button has a label_widget then that widget
   *            will be used as the label. Otherwise, if the tool button
   *            has a label text, that text will be used as label. Otherwise,
   *            if the toolbutton has a stock id, the corresponding text
205 206 207
   *            will be used as label. Otherwise, if the tool button has
   *            an icon name, the corresponding icon name from the theme will
   *            be used. Otherwise, the toolbutton will have an empty label.
208 209 210 211 212 213 214 215 216 217 218 219
   *
   *	      - The use_underline property only has an effect when the label
   *            on the toolbutton comes from the label property (ie. not from
   *            label_widget or from stock_id).
   *
   *            In that case, if use_underline is set,
   *
   *			- underscores are removed from the label text before
   *                      the label is shown on the toolbutton unless the
   *                      underscore is followed by another underscore
   *
   *			- an underscore indicates that the next character when
220 221
   *                      used in the overflow menu should be used as a
   *                      mnemonic.
222 223
   *
   *		In short: use_underline = TRUE means that the label text has
224 225
   *            the form "_Open" and the toolbar should take appropriate
   *            action.
226 227
   */

228 229 230
  g_object_class_install_property (object_class,
				   PROP_LABEL,
				   g_param_spec_string ("label",
231 232
							P_("Label"),
							P_("Text to show in the item."),
233
							NULL,
234
							GTK_PARAM_READWRITE));
235 236
  g_object_class_install_property (object_class,
				   PROP_USE_UNDERLINE,
237
				   g_param_spec_boolean ("use-underline",
238 239
							 P_("Use underline"),
							 P_("If set, an underline in the label property indicates that the next character should be used for the mnemonic accelerator key in the overflow menu"),
240
							 FALSE,
241
							 GTK_PARAM_READWRITE));
242 243
  g_object_class_install_property (object_class,
				   PROP_LABEL_WIDGET,
244
				   g_param_spec_object ("label-widget",
245 246
							P_("Label widget"),
							P_("Widget to use as the item label"),
247
							GTK_TYPE_WIDGET,
248
							GTK_PARAM_READWRITE));
249 250
  g_object_class_install_property (object_class,
				   PROP_STOCK_ID,
251
				   g_param_spec_string ("stock-id",
252 253
							P_("Stock Id"),
							P_("The stock icon displayed on the item"),
254
							NULL,
255
							GTK_PARAM_READWRITE));
256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272

  /**
   * GtkToolButton:icon-name:
   * 
   * The name of the themed icon displayed on the item.
   * This property only has an effect if not overridden by "label", 
   * "icon_widget" or "stock_id" properties.
   *
   * Since: 2.8 
   */
  g_object_class_install_property (object_class,
				   PROP_ICON_NAME,
				   g_param_spec_string ("icon-name",
							P_("Icon name"),
							P_("The name of the themed icon displayed on the item"),
							NULL,
							GTK_PARAM_READWRITE));
273 274
  g_object_class_install_property (object_class,
				   PROP_ICON_WIDGET,
275
				   g_param_spec_object ("icon-widget",
276 277
							P_("Icon widget"),
							P_("Icon widget to display in the item"),
278
							GTK_TYPE_WIDGET,
279
							GTK_PARAM_READWRITE));
280

281
  /**
282
   * GtkButton:icon-spacing:
283 284 285 286 287 288 289 290 291 292 293
   * 
   * Spacing in pixels between the icon and label.
   * 
   * Since: 2.10
   */
  gtk_widget_class_install_style_property (widget_class,
					   g_param_spec_int ("icon-spacing",
							     P_("Icon spacing"),
							     P_("Spacing in pixels between the icon and label"),
							     0,
							     G_MAXINT,
294
							     3,
295 296
							     GTK_PARAM_READWRITE));

297 298 299 300 301 302 303
/**
 * GtkToolButton::clicked:
 * @toolbutton: the object that emitted the signal
 *
 * This signal is emitted when the tool button is clicked with the mouse
 * or activated with the keyboard.
 **/
304
  toolbutton_signals[CLICKED] =
305
    g_signal_new (I_("clicked"),
306
		  G_OBJECT_CLASS_TYPE (klass),
307
		  G_SIGNAL_RUN_FIRST | G_SIGNAL_ACTION,
308 309 310 311
		  G_STRUCT_OFFSET (GtkToolButtonClass, clicked),
		  NULL, NULL,
		  g_cclosure_marshal_VOID__VOID,
		  G_TYPE_NONE, 0);
312 313
  
  g_type_class_add_private (object_class, sizeof (GtkToolButtonPrivate));
314 315 316 317 318 319 320
}

static void
gtk_tool_button_init (GtkToolButton      *button,
		      GtkToolButtonClass *klass)
{
  GtkToolItem *toolitem = GTK_TOOL_ITEM (button);
321 322 323

  button->priv = G_TYPE_INSTANCE_GET_PRIVATE (button,
                                              GTK_TYPE_TOOL_BUTTON,
324
                                              GtkToolButtonPrivate);
325

326 327
  button->priv->contents_invalid = TRUE;

328
  gtk_tool_item_set_homogeneous (toolitem, TRUE);
329 330

  /* create button */
331 332 333
  button->priv->button = g_object_new (klass->button_type, NULL);
  gtk_button_set_focus_on_click (GTK_BUTTON (button->priv->button), FALSE);
  g_signal_connect_object (button->priv->button, "clicked",
334 335
			   G_CALLBACK (button_clicked), button, 0);

336 337
  gtk_container_add (GTK_CONTAINER (button), button->priv->button);
  gtk_widget_show (button->priv->button);
338 339 340 341 342 343
}

static void
gtk_tool_button_construct_contents (GtkToolItem *tool_item)
{
  GtkToolButton *button = GTK_TOOL_BUTTON (tool_item);
Javier Jardón's avatar
Javier Jardón committed
344
  GtkWidget *child;
345 346 347 348 349 350 351
  GtkWidget *label = NULL;
  GtkWidget *icon = NULL;
  GtkToolbarStyle style;
  gboolean need_label = FALSE;
  gboolean need_icon = FALSE;
  GtkIconSize icon_size;
  GtkWidget *box = NULL;
352
  guint icon_spacing;
353 354
  GtkOrientation text_orientation = GTK_ORIENTATION_HORIZONTAL;
  GtkSizeGroup *size_group = NULL;
355
  GtkWidget *parent;
356

357 358
  button->priv->contents_invalid = FALSE;

359 360 361
  gtk_widget_style_get (GTK_WIDGET (tool_item), 
			"icon-spacing", &icon_spacing,
			NULL);
362

363
  if (button->priv->icon_widget)
364
    {
365 366 367 368 369 370
      parent = gtk_widget_get_parent (button->priv->icon_widget);
      if (parent)
        {
          gtk_container_remove (GTK_CONTAINER (parent),
                                button->priv->icon_widget);
        }
371 372
    }

373
  if (button->priv->label_widget)
374
    {
375 376 377 378 379 380
      parent = gtk_widget_get_parent (button->priv->label_widget);
      if (parent)
        {
          gtk_container_remove (GTK_CONTAINER (parent),
                                button->priv->label_widget);
        }
381 382
    }

Javier Jardón's avatar
Javier Jardón committed
383 384
  child = gtk_bin_get_child (GTK_BIN (button->priv->button));
  if (child)
385
    {
386 387 388
      /* Note: we are not destroying the label_widget or icon_widget
       * here because they were removed from their containers above
       */
Javier Jardón's avatar
Javier Jardón committed
389
      gtk_widget_destroy (child);
390 391 392 393 394 395
    }

  style = gtk_tool_item_get_toolbar_style (GTK_TOOL_ITEM (button));
  
  if (style != GTK_TOOLBAR_TEXT)
    need_icon = TRUE;
396 397 398 399 400 401

  if (style != GTK_TOOLBAR_ICONS && style != GTK_TOOLBAR_BOTH_HORIZ)
    need_label = TRUE;

  if (style == GTK_TOOLBAR_BOTH_HORIZ &&
      (gtk_tool_item_get_is_important (GTK_TOOL_ITEM (button)) ||
402 403
       gtk_tool_item_get_orientation (GTK_TOOL_ITEM (button)) == GTK_ORIENTATION_VERTICAL ||
       gtk_tool_item_get_text_orientation (GTK_TOOL_ITEM (button)) == GTK_ORIENTATION_VERTICAL))
404 405 406
    {
      need_label = TRUE;
    }
407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422
  
  if (style == GTK_TOOLBAR_ICONS && button->priv->icon_widget == NULL &&
      button->priv->stock_id == NULL && button->priv->icon_name == NULL)
    {
      need_label = TRUE;
      need_icon = FALSE;
      style = GTK_TOOLBAR_TEXT;
    }

  if (style == GTK_TOOLBAR_TEXT && button->priv->label_widget == NULL &&
      button->priv->stock_id == NULL && button->priv->label_text == NULL)
    {
      need_label = FALSE;
      need_icon = TRUE;
      style = GTK_TOOLBAR_ICONS;
    }
423

424 425
  if (need_label)
    {
426
      if (button->priv->label_widget)
427
	{
428
	  label = button->priv->label_widget;
429 430 431 432
	}
      else
	{
	  GtkStockItem stock_item;
433
	  gboolean elide;
434 435
	  gchar *label_text;

436
	  if (button->priv->label_text)
437
	    {
438 439
	      label_text = button->priv->label_text;
	      elide = button->priv->use_underline;
440
	    }
441
	  else if (button->priv->stock_id && gtk_stock_lookup (button->priv->stock_id, &stock_item))
442 443 444 445
	    {
	      label_text = stock_item.label;
	      elide = TRUE;
	    }
446
	  else
447 448 449 450
	    {
	      label_text = "";
	      elide = FALSE;
	    }
451 452

	  if (elide)
453
	    label_text = _gtk_toolbar_elide_underscores (label_text);
454 455 456 457 458 459 460 461 462
	  else
	    label_text = g_strdup (label_text);

	  label = gtk_label_new (label_text);

	  g_free (label_text);
	  
	  gtk_widget_show (label);
	}
463

464
      if (GTK_IS_LABEL (label))
465
        {
466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486
          gtk_label_set_ellipsize (GTK_LABEL (label),
			           gtk_tool_item_get_ellipsize_mode (GTK_TOOL_ITEM (button)));
          text_orientation = gtk_tool_item_get_text_orientation (GTK_TOOL_ITEM (button));
          if (text_orientation == GTK_ORIENTATION_HORIZONTAL)
	    {
              gtk_label_set_angle (GTK_LABEL (label), 0);
              gtk_misc_set_alignment (GTK_MISC (label),
                                      gtk_tool_item_get_text_alignment (GTK_TOOL_ITEM (button)),
                                      0.5);
            }
          else
            {
              gtk_label_set_ellipsize (GTK_LABEL (label), PANGO_ELLIPSIZE_NONE);
	      if (gtk_widget_get_direction (GTK_WIDGET (tool_item)) == GTK_TEXT_DIR_RTL)
	        gtk_label_set_angle (GTK_LABEL (label), -90);
	      else
	        gtk_label_set_angle (GTK_LABEL (label), 90);
              gtk_misc_set_alignment (GTK_MISC (label),
                                      0.5,
                                      1 - gtk_tool_item_get_text_alignment (GTK_TOOL_ITEM (button)));
            }
487
        }
488 489 490 491 492
    }

  icon_size = gtk_tool_item_get_icon_size (GTK_TOOL_ITEM (button));
  if (need_icon)
    {
493
      if (button->priv->icon_widget)
494
	{
495
	  icon = button->priv->icon_widget;
496 497 498
	  
	  if (GTK_IS_IMAGE (icon))
	    {
499
	      g_object_set (button->priv->icon_widget,
500 501
			    "icon-size", icon_size,
			    NULL);
502 503
	    }
	}
504 505
      else if (button->priv->stock_id && 
	       gtk_icon_factory_lookup_default (button->priv->stock_id))
506
	{
507
	  icon = gtk_image_new_from_stock (button->priv->stock_id, icon_size);
508 509
	  gtk_widget_show (icon);
	}
510 511 512 513 514
      else if (button->priv->icon_name)
	{
	  icon = gtk_image_new_from_icon_name (button->priv->icon_name, icon_size);
	  gtk_widget_show (icon);
	}
515

516
      if (GTK_IS_MISC (icon) && text_orientation == GTK_ORIENTATION_HORIZONTAL)
517 518 519
	gtk_misc_set_alignment (GTK_MISC (icon),
				1.0 - gtk_tool_item_get_text_alignment (GTK_TOOL_ITEM (button)),
				0.5);
520
      else if (GTK_IS_MISC (icon))
521 522 523 524 525 526 527 528 529 530
	gtk_misc_set_alignment (GTK_MISC (icon),
				0.5,
				gtk_tool_item_get_text_alignment (GTK_TOOL_ITEM (button)));

      if (icon)
	{
	  size_group = gtk_tool_item_get_text_size_group (GTK_TOOL_ITEM (button));
	  if (size_group != NULL)
	    gtk_size_group_add_widget (size_group, icon);
	}
531 532 533 534 535 536
    }

  switch (style)
    {
    case GTK_TOOLBAR_ICONS:
      if (icon)
537
	gtk_container_add (GTK_CONTAINER (button->priv->button), icon);
538 539 540
      break;

    case GTK_TOOLBAR_BOTH:
541
      if (text_orientation == GTK_ORIENTATION_HORIZONTAL)
542
	box = gtk_box_new (GTK_ORIENTATION_VERTICAL, icon_spacing);
543
      else
544
	box = gtk_box_new (GTK_ORIENTATION_HORIZONTAL, icon_spacing);
545 546
      if (icon)
	gtk_box_pack_start (GTK_BOX (box), icon, TRUE, TRUE, 0);
547
      gtk_box_pack_end (GTK_BOX (box), label, FALSE, TRUE, 0);
548
      gtk_container_add (GTK_CONTAINER (button->priv->button), box);
549 550 551
      break;

    case GTK_TOOLBAR_BOTH_HORIZ:
552 553
      if (text_orientation == GTK_ORIENTATION_HORIZONTAL)
	{
554
	  box = gtk_box_new (GTK_ORIENTATION_HORIZONTAL, icon_spacing);
555 556 557 558 559 560 561
	  if (icon)
	    gtk_box_pack_start (GTK_BOX (box), icon, label? FALSE : TRUE, TRUE, 0);
	  if (label)
	    gtk_box_pack_end (GTK_BOX (box), label, TRUE, TRUE, 0);
	}
      else
	{
562
	  box = gtk_box_new (GTK_ORIENTATION_VERTICAL, icon_spacing);
563 564 565 566 567
	  if (icon)
	    gtk_box_pack_end (GTK_BOX (box), icon, label ? FALSE : TRUE, TRUE, 0);
	  if (label)
	    gtk_box_pack_start (GTK_BOX (box), label, TRUE, TRUE, 0);
	}
568
      gtk_container_add (GTK_CONTAINER (button->priv->button), box);
569 570 571
      break;

    case GTK_TOOLBAR_TEXT:
572
      gtk_container_add (GTK_CONTAINER (button->priv->button), label);
573 574 575 576 577 578
      break;
    }

  if (box)
    gtk_widget_show (box);

579
  gtk_button_set_relief (GTK_BUTTON (button->priv->button),
580 581
			 gtk_tool_item_get_relief_style (GTK_TOOL_ITEM (button)));

582 583
  gtk_tool_item_rebuild_menu (tool_item);
  
584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608
  gtk_widget_queue_resize (GTK_WIDGET (button));
}

static void
gtk_tool_button_set_property (GObject         *object,
			      guint            prop_id,
			      const GValue    *value,
			      GParamSpec      *pspec)
{
  GtkToolButton *button = GTK_TOOL_BUTTON (object);
  
  switch (prop_id)
    {
    case PROP_LABEL:
      gtk_tool_button_set_label (button, g_value_get_string (value));
      break;
    case PROP_USE_UNDERLINE:
      gtk_tool_button_set_use_underline (button, g_value_get_boolean (value));
      break;
    case PROP_LABEL_WIDGET:
      gtk_tool_button_set_label_widget (button, g_value_get_object (value));
      break;
    case PROP_STOCK_ID:
      gtk_tool_button_set_stock_id (button, g_value_get_string (value));
      break;
609 610 611
    case PROP_ICON_NAME:
      gtk_tool_button_set_icon_name (button, g_value_get_string (value));
      break;
612 613 614 615 616
    case PROP_ICON_WIDGET:
      gtk_tool_button_set_icon_widget (button, g_value_get_object (value));
      break;
    default:
      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
617
      break;
618 619 620
    }
}

621 622 623 624
static void
gtk_tool_button_property_notify (GObject          *object,
				 GParamSpec       *pspec)
{
625 626
  GtkToolButton *button = GTK_TOOL_BUTTON (object);

627 628
  if (button->priv->contents_invalid ||
      strcmp ("is-important", pspec->name) == 0)
629
    gtk_tool_button_construct_contents (GTK_TOOL_ITEM (object));
630 631 632

  if (parent_class->notify)
    parent_class->notify (object, pspec);
633 634
}

635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654
static void
gtk_tool_button_get_property (GObject         *object,
			      guint            prop_id,
			      GValue          *value,
			      GParamSpec      *pspec)
{
  GtkToolButton *button = GTK_TOOL_BUTTON (object);

  switch (prop_id)
    {
    case PROP_LABEL:
      g_value_set_string (value, gtk_tool_button_get_label (button));
      break;
    case PROP_LABEL_WIDGET:
      g_value_set_object (value, gtk_tool_button_get_label_widget (button));
      break;
    case PROP_USE_UNDERLINE:
      g_value_set_boolean (value, gtk_tool_button_get_use_underline (button));
      break;
    case PROP_STOCK_ID:
655
      g_value_set_string (value, button->priv->stock_id);
656
      break;
657 658 659
    case PROP_ICON_NAME:
      g_value_set_string (value, button->priv->icon_name);
      break;
660
    case PROP_ICON_WIDGET:
661
      g_value_set_object (value, button->priv->icon_widget);
662 663 664
      break;
    default:
      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
665
      break;
666 667 668 669 670 671 672 673
    }
}

static void
gtk_tool_button_finalize (GObject *object)
{
  GtkToolButton *button = GTK_TOOL_BUTTON (object);

674 675 676
  g_free (button->priv->stock_id);
  g_free (button->priv->icon_name);
  g_free (button->priv->label_text);
677 678

  if (button->priv->label_widget)
679
    g_object_unref (button->priv->label_widget);
680 681

  if (button->priv->icon_widget)
682
    g_object_unref (button->priv->icon_widget);
683
  
684 685 686
  parent_class->finalize (object);
}

687 688 689 690 691 692 693 694 695 696 697
static GtkWidget *
clone_image_menu_size (GtkImage *image, GtkSettings *settings)
{
  GtkImageType storage_type = gtk_image_get_storage_type (image);

  if (storage_type == GTK_IMAGE_STOCK)
    {
      gchar *stock_id;
      gtk_image_get_stock (image, &stock_id, NULL);
      return gtk_image_new_from_stock (stock_id, GTK_ICON_SIZE_MENU);
    }
698 699 700 701 702 703
  else if (storage_type == GTK_IMAGE_ICON_NAME)
    {
      const gchar *icon_name;
      gtk_image_get_icon_name (image, &icon_name, NULL);
      return gtk_image_new_from_icon_name (icon_name, GTK_ICON_SIZE_MENU);
    }
704 705 706 707 708 709
  else if (storage_type == GTK_IMAGE_ICON_SET)
    {
      GtkIconSet *icon_set;
      gtk_image_get_icon_set (image, &icon_set, NULL);
      return gtk_image_new_from_icon_set (icon_set, GTK_ICON_SIZE_MENU);
    }
710 711 712 713 714 715
  else if (storage_type == GTK_IMAGE_GICON)
    {
      GIcon *icon;
      gtk_image_get_gicon (image, &icon, NULL);
      return gtk_image_new_from_gicon (icon, GTK_ICON_SIZE_MENU);
    }
716 717 718 719 720 721 722 723 724
  else if (storage_type == GTK_IMAGE_PIXBUF)
    {
      gint width, height;
      
      if (settings &&
	  gtk_icon_size_lookup_for_settings (settings, GTK_ICON_SIZE_MENU,
					     &width, &height))
	{
	  GdkPixbuf *src_pixbuf, *dest_pixbuf;
725
	  GtkWidget *cloned_image;
726 727 728 729 730

	  src_pixbuf = gtk_image_get_pixbuf (image);
	  dest_pixbuf = gdk_pixbuf_scale_simple (src_pixbuf, width, height,
						 GDK_INTERP_BILINEAR);

731
	  cloned_image = gtk_image_new_from_pixbuf (dest_pixbuf);
Matthias Clasen's avatar
Matthias Clasen committed
732 733
	  g_object_unref (dest_pixbuf);

734
	  return cloned_image;
735 736 737 738 739 740
	}
    }

  return NULL;
}
      
741 742 743 744 745 746 747 748
static gboolean
gtk_tool_button_create_menu_proxy (GtkToolItem *item)
{
  GtkToolButton *button = GTK_TOOL_BUTTON (item);
  GtkWidget *menu_item;
  GtkWidget *menu_image = NULL;
  GtkStockItem stock_item;
  gboolean use_mnemonic = TRUE;
749
  const char *label;
750

751 752 753
  if (_gtk_tool_item_create_menu_proxy (item))
    return TRUE;
 
754
  if (GTK_IS_LABEL (button->priv->label_widget))
755
    {
756 757
      label = gtk_label_get_label (GTK_LABEL (button->priv->label_widget));
      use_mnemonic = gtk_label_get_use_underline (GTK_LABEL (button->priv->label_widget));
758
    }
759
  else if (button->priv->label_text)
760
    {
761 762
      label = button->priv->label_text;
      use_mnemonic = button->priv->use_underline;
763
    }
764
  else if (button->priv->stock_id && gtk_stock_lookup (button->priv->stock_id, &stock_item))
765 766 767 768 769 770 771
    {
      label = stock_item.label;
    }
  else
    {
      label = "";
    }
772 773 774 775 776 777
  
  if (use_mnemonic)
    menu_item = gtk_image_menu_item_new_with_mnemonic (label);
  else
    menu_item = gtk_image_menu_item_new_with_label (label);

778
  if (GTK_IS_IMAGE (button->priv->icon_widget))
779
    {
780
      menu_image = clone_image_menu_size (GTK_IMAGE (button->priv->icon_widget),
781
					  gtk_widget_get_settings (GTK_WIDGET (button)));
782
    }
783
  else if (button->priv->stock_id)
784
    {
785
      menu_image = gtk_image_new_from_stock (button->priv->stock_id, GTK_ICON_SIZE_MENU);
786 787 788 789 790 791 792 793
    }

  if (menu_image)
    gtk_image_menu_item_set_image (GTK_IMAGE_MENU_ITEM (menu_item), menu_image);

  g_signal_connect_closure_by_id (menu_item,
				  g_signal_lookup ("activate", G_OBJECT_TYPE (menu_item)), 0,
				  g_cclosure_new_object_swap (G_CALLBACK (gtk_button_clicked),
794
							      G_OBJECT (GTK_TOOL_BUTTON (button)->priv->button)),
795 796 797 798 799 800 801 802 803 804 805
				  FALSE);

  gtk_tool_item_set_proxy_menu_item (GTK_TOOL_ITEM (button), MENU_ID, menu_item);
  
  return TRUE;
}

static void
button_clicked (GtkWidget     *widget,
		GtkToolButton *button)
{
806 807 808 809 810 811 812
  GtkAction *action;

  action = gtk_activatable_get_related_action (GTK_ACTIVATABLE (button));
  
  if (action)
    gtk_action_activate (action);

813 814 815 816 817 818 819 820 821
  g_signal_emit_by_name (button, "clicked");
}

static void
gtk_tool_button_toolbar_reconfigured (GtkToolItem *tool_item)
{
  gtk_tool_button_construct_contents (tool_item);
}

822 823 824 825 826 827
static void 
gtk_tool_button_update_icon_spacing (GtkToolButton *button)
{
  GtkWidget *box;
  guint spacing;

Javier Jardón's avatar
Javier Jardón committed
828
  box = gtk_bin_get_child (GTK_BIN (button->priv->button));
829 830 831 832 833 834 835 836 837
  if (GTK_IS_BOX (box))
    {
      gtk_widget_style_get (GTK_WIDGET (button), 
			    "icon-spacing", &spacing,
			    NULL);
      gtk_box_set_spacing (GTK_BOX (box), spacing);      
    }
}

838
static void
839
gtk_tool_button_style_updated (GtkWidget *widget)
840
{
841 842
  GTK_WIDGET_CLASS (parent_class)->style_updated (widget);

843
  gtk_tool_button_update_icon_spacing (GTK_TOOL_BUTTON (widget));
844 845
}

846 847 848 849
static void 
gtk_tool_button_activatable_interface_init (GtkActivatableIface  *iface)
{
  parent_activatable_iface = g_type_interface_peek_parent (iface);
850 851
  iface->update = gtk_tool_button_update;
  iface->sync_action_properties = gtk_tool_button_sync_action_properties;
852 853 854
}

static void
855 856 857
gtk_tool_button_update (GtkActivatable *activatable,
			GtkAction      *action,
			const gchar    *property_name)
858 859 860 861 862 863 864 865 866 867 868 869
{
  GtkToolButton *button;
  GtkWidget *image;

  parent_activatable_iface->update (activatable, action, property_name);

  if (!gtk_activatable_get_use_action_appearance (activatable))
    return;

  button = GTK_TOOL_BUTTON (activatable);
  
  if (strcmp (property_name, "short-label") == 0)
870
    gtk_tool_button_set_label (button, gtk_action_get_short_label (action));
871
  else if (strcmp (property_name, "stock-id") == 0)
872
    gtk_tool_button_set_stock_id (button, gtk_action_get_stock_id (action));
873 874 875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894
  else if (strcmp (property_name, "gicon") == 0)
    {
      const gchar *stock_id = gtk_action_get_stock_id (action);
      GIcon *icon = gtk_action_get_gicon (action);
      GtkIconSize icon_size = GTK_ICON_SIZE_BUTTON;

      if ((stock_id && gtk_icon_factory_lookup_default (stock_id)) || !icon)
	image = NULL;
      else 
	{   
	  image = gtk_tool_button_get_icon_widget (button);
	  icon_size = gtk_tool_item_get_icon_size (GTK_TOOL_ITEM (button));

	  if (!image)
	    image = gtk_image_new ();
	}

      gtk_tool_button_set_icon_widget (button, image);
      gtk_image_set_from_gicon (GTK_IMAGE (image), icon, icon_size);

    }
  else if (strcmp (property_name, "icon-name") == 0)
895
    gtk_tool_button_set_icon_name (button, gtk_action_get_icon_name (action));
896 897 898
}

static void
899 900
gtk_tool_button_sync_action_properties (GtkActivatable *activatable,
				        GtkAction      *action)
901 902 903
{
  GtkToolButton *button;
  GIcon         *icon;
904
  const gchar   *stock_id;
905

906
  parent_activatable_iface->sync_action_properties (activatable, action);
907 908 909 910 911 912 913 914

  if (!action)
    return;

  if (!gtk_activatable_get_use_action_appearance (activatable))
    return;

  button = GTK_TOOL_BUTTON (activatable);
915 916 917
  stock_id = gtk_action_get_stock_id (action);

  gtk_tool_button_set_label (button, gtk_action_get_short_label (action));
918
  gtk_tool_button_set_use_underline (button, TRUE);
919 920 921 922 923
  gtk_tool_button_set_stock_id (button, stock_id);
  gtk_tool_button_set_icon_name (button, gtk_action_get_icon_name (action));

  if (stock_id && gtk_icon_factory_lookup_default (stock_id))
      gtk_tool_button_set_icon_widget (button, NULL);
924 925 926 927 928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943
  else if ((icon = gtk_action_get_gicon (action)) != NULL)
    {
      GtkIconSize icon_size = gtk_tool_item_get_icon_size (GTK_TOOL_ITEM (button));
      GtkWidget  *image = gtk_tool_button_get_icon_widget (button);
      
      if (!image)
	{
	  image = gtk_image_new ();
	  gtk_widget_show (image);
	  gtk_tool_button_set_icon_widget (button, image);
	}

      gtk_image_set_from_gicon (GTK_IMAGE (image), icon, icon_size);
    }
  else if (gtk_action_get_icon_name (action))
    gtk_tool_button_set_icon_name (button, gtk_action_get_icon_name (action));
  else
    gtk_tool_button_set_label (button, gtk_action_get_short_label (action));
}

944 945 946 947 948 949 950 951 952 953 954 955 956 957
/**
 * gtk_tool_button_new_from_stock:
 * @stock_id: the name of the stock item 
 *
 * Creates a new #GtkToolButton containing the image and text from a
 * stock item. Some stock ids have preprocessor macros like #GTK_STOCK_OK
 * and #GTK_STOCK_APPLY.
 *
 * It is an error if @stock_id is not a name of a stock item.
 * 
 * Return value: A new #GtkToolButton
 * 
 * Since: 2.4
 **/
958 959 960 961 962 963 964 965
GtkToolItem *
gtk_tool_button_new_from_stock (const gchar *stock_id)
{
  GtkToolButton *button;

  g_return_val_if_fail (stock_id != NULL, NULL);
    
  button = g_object_new (GTK_TYPE_TOOL_BUTTON,
966
			 "stock-id", stock_id,
967 968 969 970 971
			 NULL);

  return GTK_TOOL_ITEM (button);
}

972 973
/**
 * gtk_tool_button_new:
974
 * @label: (allow-none): a string that will be used as label, or %NULL
975
 * @icon_widget: (allow-none): a widget that will be used as the button contents, or %NULL
976
 *
977
 * Creates a new %GtkToolButton using @icon_widget as contents and @label as
978
 * label.
979
 *
980 981 982 983
 * Return value: A new #GtkToolButton
 * 
 * Since: 2.4
 **/
984
GtkToolItem *
985 986
gtk_tool_button_new (GtkWidget	 *icon_widget,
		     const gchar *label)
987 988
{
  GtkToolButton *button;
989

990
  g_return_val_if_fail (icon_widget == NULL || GTK_IS_WIDGET (icon_widget), NULL);
991

992
  button = g_object_new (GTK_TYPE_TOOL_BUTTON,
993 994
                         "label", label,
                         "icon-widget", icon_widget,
995 996 997 998 999
			 NULL);

  return GTK_TOOL_ITEM (button);  
}

1000 1001 1002
/**
 * gtk_tool_button_set_label:
 * @button: a #GtkToolButton
1003 1004
 * @label: (allow-none): a string that will be used as label, or %NULL.
 *
1005 1006 1007 1008 1009 1010 1011 1012
 * Sets @label as the label used for the tool button. The "label" property
 * only has an effect if not overridden by a non-%NULL "label_widget" property.
 * If both the "label_widget" and "label" properties are %NULL, the label
 * is determined by the "stock_id" property. If the "stock_id" property is also
 * %NULL, @button will not have a label.
 * 
 * Since: 2.4
 **/
1013 1014 1015 1016 1017
void
gtk_tool_button_set_label (GtkToolButton *button,
			   const gchar   *label)
{
  gchar *old_label;
1018 1019
  gchar *elided_label;
  AtkObject *accessible;
1020 1021 1022
  
  g_return_if_fail (GTK_IS_TOOL_BUTTON (button));

1023
  old_label = button->priv->label_text;
1024

1025
  button->priv->label_text = g_strdup (label);
1026
  button->priv->contents_invalid = TRUE;     
1027

1028 1029 1030 1031 1032 1033 1034
  if (label)
    {
      elided_label = _gtk_toolbar_elide_underscores (label);
      accessible = gtk_widget_get_accessible (GTK_WIDGET (button->priv->button));
      atk_object_set_name (accessible, elided_label);
      g_free (elided_label);
    }
1035

1036 1037 1038
  g_free (old_label);
 
  g_object_notify (G_OBJECT (button), "label");
1039 1040
}

1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052
/**
 * gtk_tool_button_get_label:
 * @button: a #GtkToolButton
 * 
 * Returns the label used by the tool button, or %NULL if the tool button
 * doesn't have a label. or uses a the label from a stock item. The returned
 * string is owned by GTK+, and must not be modified or freed.
 * 
 * Return value: The label, or %NULL
 * 
 * Since: 2.4
 **/
1053
const gchar *
1054 1055 1056 1057
gtk_tool_button_get_label (GtkToolButton *button)
{
  g_return_val_if_fail (GTK_IS_TOOL_BUTTON (button), NULL);

1058
  return button->priv->label_text;
1059 1060
}

1061 1062 1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073 1074 1075 1076
/**
 * gtk_tool_button_set_use_underline:
 * @button: a #GtkToolButton
 * @use_underline: whether the button label has the form "_Open"
 *
 * If set, an underline in the label property indicates that the next character
 * should be used for the mnemonic accelerator key in the overflow menu. For
 * example, if the label property is "_Open" and @use_underline is %TRUE,
 * the label on the tool button will be "Open" and the item on the overflow
 * menu will have an underlined 'O'.
 * 
 * Labels shown on tool buttons never have mnemonics on them; this property
 * only affects the menu item on the overflow menu.
 * 
 * Since: 2.4
 **/
1077 1078 1079 1080 1081 1082 1083 1084
void
gtk_tool_button_set_use_underline (GtkToolButton *button,
				   gboolean       use_underline)
{
  g_return_if_fail (GTK_IS_TOOL_BUTTON (button));

  use_underline = use_underline != FALSE;

1085
  if (use_underline != button->priv->use_underline)
1086
    {
1087
      button->priv->use_underline = use_underline;
1088
      button->priv->contents_invalid = TRUE;
1089

1090
      g_object_notify (G_OBJECT (button), "use-underline");
1091 1092 1093
    }
}

1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105
/**
 * gtk_tool_button_get_use_underline:
 * @button: a #GtkToolButton
 * 
 * Returns whether underscores in the label property are used as mnemonics
 * on menu items on the overflow menu. See gtk_tool_button_set_use_underline().
 * 
 * Return value: %TRUE if underscores in the label property are used as
 * mnemonics on menu items on the overflow menu.
 * 
 * Since: 2.4
 **/
1106 1107 1108 1109 1110
gboolean
gtk_tool_button_get_use_underline (GtkToolButton *button)
{
  g_return_val_if_fail (GTK_IS_TOOL_BUTTON (button), FALSE);

1111
  return button->priv->use_underline;
1112 1113
}

1114 1115 1116
/**
 * gtk_tool_button_set_stock_id:
 * @button: a #GtkToolButton
1117 1118
 * @stock_id: (allow-none): a name of a stock item, or %NULL
 *
1119 1120 1121 1122 1123 1124
 * Sets the name of the stock item. See gtk_tool_button_new_from_stock().
 * The stock_id property only has an effect if not
 * overridden by non-%NULL "label" and "icon_widget" properties.
 * 
 * Since: 2.4
 **/
1125 1126 1127 1128 1129 1130 1131 1132
void
gtk_tool_button_set_stock_id (GtkToolButton *button,
			      const gchar   *stock_id)
{
  gchar *old_stock_id;
  
  g_return_if_fail (GTK_IS_TOOL_BUTTON (button));

1133
  old_stock_id = button->priv->stock_id;
1134

1135
  button->priv->stock_id = g_strdup (stock_id);
1136
  button->priv->contents_invalid = TRUE;
1137 1138

  g_free (old_stock_id);
1139 1140
  
  g_object_notify (G_OBJECT (button), "stock-id");
1141 1142
}

1143 1144 1145 1146 1147 1148 1149 1150 1151 1152 1153
/**
 * gtk_tool_button_get_stock_id:
 * @button: a #GtkToolButton
 * 
 * Returns the name of the stock item. See gtk_tool_button_set_stock_id().
 * The returned string is owned by GTK+ and must not be freed or modifed.
 * 
 * Return value: the name of the stock item for @button.
 * 
 * Since: 2.4
 **/
1154
const gchar *
1155 1156 1157 1158
gtk_tool_button_get_stock_id (GtkToolButton *button)
{
  g_return_val_if_fail (GTK_IS_TOOL_BUTTON (button), NULL);

1159
  return button->priv->stock_id;
1160 1161
}

1162 1163 1164
/**
 * gtk_tool_button_set_icon_name
 * @button: a #GtkToolButton
1165 1166
 * @icon_name: (allow-none): the name of the themed icon
 *
1167 1168 1169 1170 1171 1172 1173 1174 1175 1176 1177 1178 1179 1180 1181 1182 1183 1184 1185
 * Sets the icon for the tool button from a named themed icon.
 * See the docs for #GtkIconTheme for more details.
 * The "icon_name" property only has an effect if not
 * overridden by non-%NULL "label", "icon_widget" and "stock_id"
 * properties.
 * 
 * Since: 2.8
 **/
void
gtk_tool_button_set_icon_name (GtkToolButton *button,
			       const gchar   *icon_name)
{
  gchar *old_icon_name;

  g_return_if_fail (GTK_IS_TOOL_BUTTON (button));

  old_icon_name = button->priv->icon_name;

  button->priv->icon_name = g_strdup (icon_name);
1186
  button->priv->contents_invalid = TRUE; 
1187 1188

  g_free (old_icon_name);
1189 1190

  g_object_notify (G_OBJECT (button), "icon-name");
1191 1192 1193 1194 1195 1196 1197 1198 1199 1200 1201 1202 1203 1204
}

/**
 * gtk_tool_button_get_icon_name
 * @button: a #GtkToolButton
 * 
 * Returns the name of the themed icon for the tool button,
 * see gtk_tool_button_set_icon_name().
 *
 * Returns: the icon name or %NULL if the tool button has
 * no themed icon
 * 
 * Since: 2.8
 **/
1205
const gchar*
1206 1207 1208 1209 1210 1211 1212
gtk_tool_button_get_icon_name (GtkToolButton *button)
{
  g_return_val_if_fail (GTK_IS_TOOL_BUTTON (button), NULL);

  return button->priv->icon_name;
}

1213 1214 1215
/**
 * gtk_tool_button_set_icon_widget:
 * @button: a #GtkToolButton
1216 1217
 * @icon_widget: (allow-none): the widget used as icon, or %NULL
 *
1218 1219 1220 1221 1222 1223
 * Sets @icon as the widget used as icon on @button. If @icon_widget is
 * %NULL the icon is determined by the "stock_id" property. If the
 * "stock_id" property is also %NULL, @button will not have an icon.
 * 
 * Since: 2.4
 **/
1224 1225
void
gtk_tool_button_set_icon_widget (GtkToolButton *button,
1226
				 GtkWidget     *icon_widget)
1227 1228
{
  g_return_if_fail (GTK_IS_TOOL_BUTTON (button));
1229
  g_return_if_fail (icon_widget == NULL || GTK_IS_WIDGET (icon_widget));
1230

1231
  if (icon_widget != button->priv->icon_widget)
1232
    {
1233
      if (button->priv->icon_widget)
1234
	{
1235 1236 1237 1238 1239 1240
          GtkWidget *parent;

          parent = gtk_widget_get_parent (button->priv->icon_widget);
	  if (parent)
            gtk_container_remove (GTK_CONTAINER (parent),
                                  button->priv->icon_widget);
1241

1242
	  g_object_unref (button->priv->icon_widget);
1243 1244
	}
      
1245
      if (icon_widget)
1246
	g_object_ref_sink (icon_widget);
1247

1248
      button->priv->icon_widget = icon_widget;
1249
      button->priv->contents_invalid = TRUE;
1250
      
1251
      g_object_notify (G_OBJECT (button), "icon-widget");
1252 1253 1254
    }
}

1255 1256 1257
/**
 * gtk_tool_button_set_label_widget:
 * @button: a #GtkToolButton
1258 1259
 * @label_widget: (allow-none): the widget used as label, or %NULL
 *
1260 1261 1262 1263 1264 1265 1266 1267
 * Sets @label_widget as the widget that will be used as the label
 * for @button. If @label_widget is %NULL the "label" property is used
 * as label. If "label" is also %NULL, the label in the stock item
 * determined by the "stock_id" property is used as label. If
 * "stock_id" is also %NULL, @button does not have a label.
 * 
 * Since: 2.4
 **/
1268 1269 1270 1271 1272 1273 1274
void
gtk_tool_button_set_label_widget (GtkToolButton *button,
				  GtkWidget     *label_widget)
{
  g_return_if_fail (GTK_IS_TOOL_BUTTON (button));
  g_return_if_fail (label_widget == NULL || GTK_IS_WIDGET (label_widget));

1275
  if (label_widget != button->priv->label_widget)
1276
    {
1277
      if (button->priv->label_widget)
1278
	{
1279 1280 1281 1282 1283 1284 1285
          GtkWidget *parent;

          parent = gtk_widget_get_parent (button->priv->label_widget);
          if (parent)
            gtk_container_remove (GTK_CONTAINER (parent),
                                  button->priv->label_widget);

1286 1287 1288
	  g_object_unref (button->priv->label_widget);
	}
      
1289
      if (label_widget)
1290
	g_object_ref_sink (label_widget);
1291

1292
      button->priv->label_widget = label_widget;
1293
      button->priv->contents_invalid = TRUE;
1294
      
1295
      g_object_notify (G_OBJECT (button), "label-widget");
1296 1297 1298
    }
}

1299 1300 1301
/**
 * gtk_tool_button_get_label_widget:
 * @button: a #GtkToolButton
1302 1303 1304 1305 1306 1307 1308
 *
 * Returns the widget used as label on @button.
 * See gtk_tool_button_set_label_widget().
 *
 * Return value: (transfer none): The widget used as label
 *     on @button, or %NULL.
 *
1309 1310
 * Since: 2.4
 **/
1311 1312 1313 1314 1315
GtkWidget *
gtk_tool_button_get_label_widget (GtkToolButton *button)
{
  g_return_val_if_fail (GTK_IS_TOOL_BUTTON (button), NULL);

1316
  return button->priv->label_widget;
1317 1318
}

1319 1320 1321
/**
 * gtk_tool_button_get_icon_widget:
 * @button: a #GtkToolButton
1322 1323 1324 1325 1326 1327 1328
 *
 * Return the widget used as icon widget on @button.
 * See gtk_tool_button_set_icon_widget().
 *
 * Return value: (transfer none): The widget used as icon
 *     on @button, or %NULL.
 *
1329 1330
 * Since: 2.4
 **/
1331 1332 1333
GtkWidget *
gtk_tool_button_get_icon_widget (GtkToolButton *button)
{
1334
  g_return_val_if_fail (GTK_IS_TOOL_BUTTON (button), NULL);
1335

1336 1337 1338 1339 1340 1341 1342 1343 1344
  return button->priv->icon_widget;
}

GtkWidget *
_gtk_tool_button_get_button (GtkToolButton *button)
{
  g_return_val_if_fail (GTK_IS_TOOL_BUTTON (button), NULL);

  return button->priv->button;
1345
}