1 /* GTK - The GIMP Toolkit
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 * Boston, MA 02111-1307, USA.
21 * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
22 * file for a list of people on the GTK+ Team. See the ChangeLog
23 * files for a list of changes. These files are distributed with
24 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
28 #include "gtkaccellabel.h"
29 #include "gtkmarshalers.h"
30 #include "gtkradiomenuitem.h"
31 #include "gtkactivatable.h"
32 #include "gtkprivate.h"
37 * SECTION:gtkradiomenuitem
38 * @Short_description: A choice from multiple check menu items
39 * @Title: GtkRadioMenuItem
40 * @See_also: #GtkMenuItem, #GtkCheckMenuItem
42 * A radio menu item is a check menu item that belongs to a group. At each
43 * instant exactly one of the radio menu items from a group is selected.
45 * The group list does not need to be freed, as each #GtkRadioMenuItem will
46 * remove itself and its list item when it is destroyed.
48 * The correct way to create a group of radio menu items is approximatively
52 * <title>How to create a group of radio menu items.</title>
54 * GSList *group = NULL;
58 * for (i = 0; i < 5; i++)
60 * item = gtk_radio_menu_item_new_with_label (group, "This is an example");
61 * group = gtk_radio_menu_item_get_group (GTK_RADIO_MENU_ITEM (item));
63 * gtk_check_menu_item_set_active (GTK_CHECK_MENU_ITEM (item), TRUE);
70 struct _GtkRadioMenuItemPrivate
81 static void gtk_radio_menu_item_destroy (GtkWidget *widget);
82 static void gtk_radio_menu_item_activate (GtkMenuItem *menu_item);
83 static void gtk_radio_menu_item_set_property (GObject *object,
87 static void gtk_radio_menu_item_get_property (GObject *object,
92 static guint group_changed_signal = 0;
94 G_DEFINE_TYPE (GtkRadioMenuItem, gtk_radio_menu_item, GTK_TYPE_CHECK_MENU_ITEM)
97 * gtk_radio_menu_item_new:
98 * @group: the group to which the radio menu item is to be attached
100 * Creates a new #GtkRadioMenuItem.
102 * Returns: a new #GtkRadioMenuItem
105 gtk_radio_menu_item_new (GSList *group)
107 GtkRadioMenuItem *radio_menu_item;
109 radio_menu_item = g_object_new (GTK_TYPE_RADIO_MENU_ITEM, NULL);
111 gtk_radio_menu_item_set_group (radio_menu_item, group);
113 return GTK_WIDGET (radio_menu_item);
117 gtk_radio_menu_item_set_property (GObject *object,
122 GtkRadioMenuItem *radio_menu_item;
124 radio_menu_item = GTK_RADIO_MENU_ITEM (object);
131 if (G_VALUE_HOLDS_OBJECT (value))
132 slist = gtk_radio_menu_item_get_group ((GtkRadioMenuItem*) g_value_get_object (value));
135 gtk_radio_menu_item_set_group (radio_menu_item, slist);
138 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
144 gtk_radio_menu_item_get_property (GObject *object,
152 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
158 * gtk_radio_menu_item_set_group:
159 * @radio_menu_item: a #GtkRadioMenuItem.
160 * @group: the new group.
162 * Sets the group of a radio menu item, or changes it.
165 gtk_radio_menu_item_set_group (GtkRadioMenuItem *radio_menu_item,
168 GtkRadioMenuItemPrivate *priv;
169 GtkWidget *old_group_singleton = NULL;
170 GtkWidget *new_group_singleton = NULL;
172 g_return_if_fail (GTK_IS_RADIO_MENU_ITEM (radio_menu_item));
173 g_return_if_fail (!g_slist_find (group, radio_menu_item));
175 priv = radio_menu_item->priv;
181 priv->group = g_slist_remove (priv->group, radio_menu_item);
183 if (priv->group && !priv->group->next)
184 old_group_singleton = g_object_ref (priv->group->data);
186 for (slist = priv->group; slist; slist = slist->next)
188 GtkRadioMenuItem *tmp_item;
190 tmp_item = slist->data;
192 tmp_item->priv->group = priv->group;
196 if (group && !group->next)
197 new_group_singleton = g_object_ref (group->data);
199 priv->group = g_slist_prepend (group, radio_menu_item);
205 for (slist = group; slist; slist = slist->next)
207 GtkRadioMenuItem *tmp_item;
209 tmp_item = slist->data;
211 tmp_item->priv->group = priv->group;
216 _gtk_check_menu_item_set_active (GTK_CHECK_MENU_ITEM (radio_menu_item), TRUE);
217 /* gtk_widget_set_state (GTK_WIDGET (radio_menu_item), GTK_STATE_ACTIVE);
221 g_object_ref (radio_menu_item);
223 g_object_notify (G_OBJECT (radio_menu_item), "group");
224 g_signal_emit (radio_menu_item, group_changed_signal, 0);
225 if (old_group_singleton)
227 g_signal_emit (old_group_singleton, group_changed_signal, 0);
228 g_object_unref (old_group_singleton);
230 if (new_group_singleton)
232 g_signal_emit (new_group_singleton, group_changed_signal, 0);
233 g_object_unref (new_group_singleton);
236 g_object_unref (radio_menu_item);
241 * gtk_radio_menu_item_new_with_label:
242 * @group: (element-type GtkRadioMenuItem) (transfer full):
243 * @label: the text for the label
245 * Creates a new #GtkRadioMenuItem whose child is a simple #GtkLabel.
247 * Returns: (transfer none): A new #GtkRadioMenuItem
250 gtk_radio_menu_item_new_with_label (GSList *group,
253 GtkWidget *radio_menu_item;
254 GtkWidget *accel_label;
256 radio_menu_item = gtk_radio_menu_item_new (group);
257 accel_label = gtk_accel_label_new (label);
258 gtk_widget_set_halign (accel_label, GTK_ALIGN_START);
259 gtk_widget_set_valign (accel_label, GTK_ALIGN_CENTER);
260 gtk_container_add (GTK_CONTAINER (radio_menu_item), accel_label);
261 gtk_accel_label_set_accel_widget (GTK_ACCEL_LABEL (accel_label), radio_menu_item);
262 gtk_widget_show (accel_label);
264 return radio_menu_item;
269 * gtk_radio_menu_item_new_with_mnemonic:
270 * @group: group the radio menu item is inside
271 * @label: the text of the button, with an underscore in front of the
273 * @returns: a new #GtkRadioMenuItem
275 * Creates a new #GtkRadioMenuItem containing a label. The label
276 * will be created using gtk_label_new_with_mnemonic(), so underscores
277 * in @label indicate the mnemonic for the menu item.
280 gtk_radio_menu_item_new_with_mnemonic (GSList *group,
283 GtkWidget *radio_menu_item;
284 GtkWidget *accel_label;
286 radio_menu_item = gtk_radio_menu_item_new (group);
287 accel_label = g_object_new (GTK_TYPE_ACCEL_LABEL, NULL);
288 gtk_label_set_text_with_mnemonic (GTK_LABEL (accel_label), label);
289 gtk_widget_set_halign (accel_label, GTK_ALIGN_START);
290 gtk_widget_set_valign (accel_label, GTK_ALIGN_CENTER);
292 gtk_container_add (GTK_CONTAINER (radio_menu_item), accel_label);
293 gtk_accel_label_set_accel_widget (GTK_ACCEL_LABEL (accel_label), radio_menu_item);
294 gtk_widget_show (accel_label);
296 return radio_menu_item;
300 * gtk_radio_menu_item_new_from_widget:
301 * @group: An existing #GtkRadioMenuItem
303 * Creates a new #GtkRadioMenuItem adding it to the same group as @group.
305 * Return value: (transfer none): The new #GtkRadioMenuItem
310 gtk_radio_menu_item_new_from_widget (GtkRadioMenuItem *group)
314 g_return_val_if_fail (GTK_IS_RADIO_MENU_ITEM (group), NULL);
317 list = gtk_radio_menu_item_get_group (group);
319 return gtk_radio_menu_item_new (list);
323 * gtk_radio_menu_item_new_with_mnemonic_from_widget:
324 * @group: An existing #GtkRadioMenuItem
325 * @label: the text of the button, with an underscore in front of the
328 * Creates a new GtkRadioMenuItem containing a label. The label will be
329 * created using gtk_label_new_with_mnemonic(), so underscores in label
330 * indicate the mnemonic for the menu item.
332 * The new #GtkRadioMenuItem is added to the same group as @group.
334 * Return value: (transfer none): The new #GtkRadioMenuItem
339 gtk_radio_menu_item_new_with_mnemonic_from_widget (GtkRadioMenuItem *group,
344 g_return_val_if_fail (GTK_IS_RADIO_MENU_ITEM (group), NULL);
347 list = gtk_radio_menu_item_get_group (group);
349 return gtk_radio_menu_item_new_with_mnemonic (list, label);
353 * gtk_radio_menu_item_new_with_label_from_widget:
354 * @group: an existing #GtkRadioMenuItem
355 * @label: the text for the label
357 * Creates a new GtkRadioMenuItem whose child is a simple GtkLabel.
358 * The new #GtkRadioMenuItem is added to the same group as @group.
360 * Return value: (transfer none): The new #GtkRadioMenuItem
365 gtk_radio_menu_item_new_with_label_from_widget (GtkRadioMenuItem *group,
370 g_return_val_if_fail (GTK_IS_RADIO_MENU_ITEM (group), NULL);
373 list = gtk_radio_menu_item_get_group (group);
375 return gtk_radio_menu_item_new_with_label (list, label);
379 * gtk_radio_menu_item_get_group:
380 * @radio_menu_item: a #GtkRadioMenuItem
382 * Returns the group to which the radio menu item belongs, as a #GList of
383 * #GtkRadioMenuItem. The list belongs to GTK+ and should not be freed.
385 * Returns: (element-type GtkRadioMenuItem) (transfer none): the group
386 * of @radio_menu_item
389 gtk_radio_menu_item_get_group (GtkRadioMenuItem *radio_menu_item)
391 g_return_val_if_fail (GTK_IS_RADIO_MENU_ITEM (radio_menu_item), NULL);
393 return radio_menu_item->priv->group;
398 gtk_radio_menu_item_class_init (GtkRadioMenuItemClass *klass)
400 GObjectClass *gobject_class;
401 GtkWidgetClass *widget_class;
402 GtkMenuItemClass *menu_item_class;
404 gobject_class = G_OBJECT_CLASS (klass);
405 widget_class = GTK_WIDGET_CLASS (klass);
406 menu_item_class = GTK_MENU_ITEM_CLASS (klass);
408 gobject_class->set_property = gtk_radio_menu_item_set_property;
409 gobject_class->get_property = gtk_radio_menu_item_get_property;
411 widget_class->destroy = gtk_radio_menu_item_destroy;
413 menu_item_class->activate = gtk_radio_menu_item_activate;
416 * GtkRadioMenuItem:group:
418 * The radio menu item whose group this widget belongs to.
422 g_object_class_install_property (gobject_class,
424 g_param_spec_object ("group",
426 P_("The radio menu item whose group this widget belongs to."),
427 GTK_TYPE_RADIO_MENU_ITEM,
428 GTK_PARAM_WRITABLE));
431 * GtkStyle::group-changed:
432 * @style: the object which received the signal
434 * Emitted when the group of radio menu items that a radio menu item belongs
435 * to changes. This is emitted when a radio menu item switches from
436 * being alone to being part of a group of 2 or more menu items, or
437 * vice-versa, and when a button is moved from one group of 2 or
438 * more menu items ton a different one, but not when the composition
439 * of the group that a menu item belongs to changes.
443 group_changed_signal = g_signal_new (I_("group-changed"),
444 G_OBJECT_CLASS_TYPE (gobject_class),
446 G_STRUCT_OFFSET (GtkRadioMenuItemClass, group_changed),
448 _gtk_marshal_VOID__VOID,
451 g_type_class_add_private (klass, sizeof (GtkRadioMenuItemPrivate));
455 gtk_radio_menu_item_init (GtkRadioMenuItem *radio_menu_item)
457 GtkRadioMenuItemPrivate *priv;
459 radio_menu_item->priv = G_TYPE_INSTANCE_GET_PRIVATE (radio_menu_item,
460 GTK_TYPE_RADIO_MENU_ITEM,
461 GtkRadioMenuItemPrivate);
462 priv = radio_menu_item->priv;
464 priv->group = g_slist_prepend (NULL, radio_menu_item);
465 gtk_check_menu_item_set_draw_as_radio (GTK_CHECK_MENU_ITEM (radio_menu_item), TRUE);
469 gtk_radio_menu_item_destroy (GtkWidget *widget)
471 GtkRadioMenuItem *radio_menu_item = GTK_RADIO_MENU_ITEM (widget);
472 GtkRadioMenuItemPrivate *priv = radio_menu_item->priv;
473 GtkWidget *old_group_singleton = NULL;
474 GtkRadioMenuItem *tmp_menu_item;
476 gboolean was_in_group;
478 was_in_group = priv->group && priv->group->next;
480 priv->group = g_slist_remove (priv->group, radio_menu_item);
481 if (priv->group && !priv->group->next)
482 old_group_singleton = priv->group->data;
484 tmp_list = priv->group;
488 tmp_menu_item = tmp_list->data;
489 tmp_list = tmp_list->next;
491 tmp_menu_item->priv->group = priv->group;
494 /* this radio menu item is no longer in the group */
497 if (old_group_singleton)
498 g_signal_emit (old_group_singleton, group_changed_signal, 0);
500 g_signal_emit (radio_menu_item, group_changed_signal, 0);
502 GTK_WIDGET_CLASS (gtk_radio_menu_item_parent_class)->destroy (widget);
506 gtk_radio_menu_item_activate (GtkMenuItem *menu_item)
508 GtkRadioMenuItem *radio_menu_item = GTK_RADIO_MENU_ITEM (menu_item);
509 GtkRadioMenuItemPrivate *priv = radio_menu_item->priv;
510 GtkCheckMenuItem *check_menu_item = GTK_CHECK_MENU_ITEM (menu_item);
511 GtkCheckMenuItem *tmp_menu_item;
517 action = gtk_activatable_get_related_action (GTK_ACTIVATABLE (menu_item));
518 if (action && gtk_menu_item_get_submenu (menu_item) == NULL)
519 gtk_action_activate (action);
523 active = gtk_check_menu_item_get_active (check_menu_item);
526 tmp_menu_item = NULL;
527 tmp_list = priv->group;
531 tmp_menu_item = tmp_list->data;
532 tmp_list = tmp_list->next;
534 if (gtk_check_menu_item_get_active (tmp_menu_item) &&
535 tmp_menu_item != check_menu_item)
538 tmp_menu_item = NULL;
544 _gtk_check_menu_item_set_active (check_menu_item, !active);
550 _gtk_check_menu_item_set_active (check_menu_item, !active);
552 tmp_list = priv->group;
555 tmp_menu_item = tmp_list->data;
556 tmp_list = tmp_list->next;
558 if (gtk_check_menu_item_get_active (tmp_menu_item) &&
559 tmp_menu_item != check_menu_item)
561 gtk_menu_item_activate (GTK_MENU_ITEM (tmp_menu_item));
569 gtk_check_menu_item_toggled (check_menu_item);
572 gtk_widget_queue_draw (GTK_WIDGET (radio_menu_item));