2 * Copyright (C) 2000 Red Hat, Inc.
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Library 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 * Library General Public License for more details.
14 * You should have received a copy of the GNU Library 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.
24 #include "prop-editor.h"
30 GObject *alive_object;
35 disconnect_func (gpointer data)
37 DisconnectData *dd = data;
39 g_signal_handler_disconnect (dd->instance, dd->id);
43 signal_removed (gpointer data,
46 DisconnectData *dd = data;
48 g_object_steal_data (dd->alive_object, "alive-object-data");
53 g_object_connect_property (GObject *object,
54 const gchar *prop_name,
57 GObject *alive_object)
60 gchar *with_detail = g_strconcat ("notify::", prop_name, NULL);
63 dd = g_new (DisconnectData, 1);
65 closure = g_cclosure_new (func, data, NULL);
67 g_closure_add_invalidate_notifier (closure, dd, signal_removed);
69 dd->id = g_signal_connect_closure (object, with_detail,
72 dd->instance = object;
73 dd->alive_object = alive_object;
75 g_object_set_data_full (G_OBJECT (alive_object),
91 free_object_property (ObjectProperty *p)
98 connect_controller (GObject *controller,
101 const gchar *prop_name,
106 p = g_new (ObjectProperty, 1);
108 p->prop = g_strdup (prop_name);
110 p->modified_id = g_signal_connect_data (controller, signal, func, p,
111 (GClosureNotify)free_object_property,
113 g_object_set_data (controller, "object-property", p);
117 block_controller (GObject *controller)
119 ObjectProperty *p = g_object_get_data (controller, "object-property");
122 g_signal_handler_block (controller, p->modified_id);
126 unblock_controller (GObject *controller)
128 ObjectProperty *p = g_object_get_data (controller, "object-property");
131 g_signal_handler_unblock (controller, p->modified_id);
135 int_modified (GtkAdjustment *adj, gpointer data)
137 ObjectProperty *p = data;
139 g_object_set (p->obj, p->prop, (int) adj->value, NULL);
143 int_changed (GObject *object, GParamSpec *pspec, gpointer data)
145 GtkAdjustment *adj = GTK_ADJUSTMENT (data);
148 g_value_init (&val, G_TYPE_INT);
149 g_object_get_property (object, pspec->name, &val);
151 if (g_value_get_int (&val) != (int)adj->value)
153 block_controller (G_OBJECT (adj));
154 gtk_adjustment_set_value (adj, g_value_get_int (&val));
155 unblock_controller (G_OBJECT (adj));
158 g_value_unset (&val);
162 uint_modified (GtkAdjustment *adj, gpointer data)
164 ObjectProperty *p = data;
166 g_object_set (p->obj, p->prop, (guint) adj->value, NULL);
170 uint_changed (GObject *object, GParamSpec *pspec, gpointer data)
172 GtkAdjustment *adj = GTK_ADJUSTMENT (data);
175 g_value_init (&val, G_TYPE_UINT);
176 g_object_get_property (object, pspec->name, &val);
178 if (g_value_get_uint (&val) != (guint)adj->value)
180 block_controller (G_OBJECT (adj));
181 gtk_adjustment_set_value (adj, g_value_get_uint (&val));
182 unblock_controller (G_OBJECT (adj));
185 g_value_unset (&val);
189 float_modified (GtkAdjustment *adj, gpointer data)
191 ObjectProperty *p = data;
193 g_object_set (p->obj, p->prop, (float) adj->value, NULL);
197 float_changed (GObject *object, GParamSpec *pspec, gpointer data)
199 GtkAdjustment *adj = GTK_ADJUSTMENT (data);
202 g_value_init (&val, G_TYPE_FLOAT);
203 g_object_get_property (object, pspec->name, &val);
205 if (g_value_get_float (&val) != (float) adj->value)
207 block_controller (G_OBJECT (adj));
208 gtk_adjustment_set_value (adj, g_value_get_float (&val));
209 unblock_controller (G_OBJECT (adj));
212 g_value_unset (&val);
216 double_modified (GtkAdjustment *adj, gpointer data)
218 ObjectProperty *p = data;
220 g_object_set (p->obj, p->prop, (double) adj->value, NULL);
224 double_changed (GObject *object, GParamSpec *pspec, gpointer data)
226 GtkAdjustment *adj = GTK_ADJUSTMENT (data);
229 g_value_init (&val, G_TYPE_DOUBLE);
230 g_object_get_property (object, pspec->name, &val);
232 if (g_value_get_double (&val) != adj->value)
234 block_controller (G_OBJECT (adj));
235 gtk_adjustment_set_value (adj, g_value_get_double (&val));
236 unblock_controller (G_OBJECT (adj));
239 g_value_unset (&val);
243 string_modified (GtkEntry *entry, gpointer data)
245 ObjectProperty *p = data;
248 text = gtk_entry_get_text (entry);
250 g_object_set (p->obj, p->prop, text, NULL);
254 string_changed (GObject *object, GParamSpec *pspec, gpointer data)
256 GtkEntry *entry = GTK_ENTRY (data);
261 g_value_init (&val, G_TYPE_STRING);
262 g_object_get_property (object, pspec->name, &val);
264 str = g_value_get_string (&val);
267 text = gtk_entry_get_text (entry);
269 if (strcmp (str, text) != 0)
271 block_controller (G_OBJECT (entry));
272 gtk_entry_set_text (entry, str);
273 unblock_controller (G_OBJECT (entry));
276 g_value_unset (&val);
280 bool_modified (GtkToggleButton *tb, gpointer data)
282 ObjectProperty *p = data;
284 g_object_set (p->obj, p->prop, (int) tb->active, NULL);
288 bool_changed (GObject *object, GParamSpec *pspec, gpointer data)
290 GtkToggleButton *tb = GTK_TOGGLE_BUTTON (data);
293 g_value_init (&val, G_TYPE_BOOLEAN);
294 g_object_get_property (object, pspec->name, &val);
296 if (g_value_get_boolean (&val) != tb->active)
298 block_controller (G_OBJECT (tb));
299 gtk_toggle_button_set_active (tb, g_value_get_boolean (&val));
300 unblock_controller (G_OBJECT (tb));
303 gtk_label_set_text (GTK_LABEL (GTK_BIN (tb)->child), g_value_get_boolean (&val) ?
306 g_value_unset (&val);
311 enum_modified (GtkOptionMenu *om, gpointer data)
313 ObjectProperty *p = data;
318 spec = g_object_class_find_property (G_OBJECT_GET_CLASS (p->obj),
321 eclass = G_ENUM_CLASS (g_type_class_peek (spec->value_type));
323 i = gtk_option_menu_get_history (om);
325 g_object_set (p->obj, p->prop, eclass->values[i].value, NULL);
329 enum_changed (GObject *object, GParamSpec *pspec, gpointer data)
331 GtkOptionMenu *om = GTK_OPTION_MENU (data);
336 eclass = G_ENUM_CLASS (g_type_class_peek (pspec->value_type));
338 g_value_init (&val, pspec->value_type);
339 g_object_get_property (object, pspec->name, &val);
342 while (i < eclass->n_values)
344 if (eclass->values[i].value == g_value_get_enum (&val))
349 if (gtk_option_menu_get_history (om) != i)
351 block_controller (G_OBJECT (om));
352 gtk_option_menu_set_history (om, i);
353 unblock_controller (G_OBJECT (om));
356 g_value_unset (&val);
361 unichar_get_value (GtkEntry *entry)
363 const gchar *text = gtk_entry_get_text (entry);
366 return g_utf8_get_char (text);
372 unichar_modified (GtkEntry *entry, gpointer data)
374 ObjectProperty *p = data;
375 gunichar val = unichar_get_value (entry);
377 g_object_set (p->obj, p->prop, val, NULL);
381 unichar_changed (GObject *object, GParamSpec *pspec, gpointer data)
383 GtkEntry *entry = GTK_ENTRY (data);
385 gunichar old_val = unichar_get_value (entry);
389 g_object_get (object, pspec->name, &new_val, NULL);
391 if (new_val != old_val)
396 len = g_unichar_to_utf8 (new_val, buf);
400 block_controller (G_OBJECT (entry));
401 gtk_entry_set_text (entry, buf);
402 unblock_controller (G_OBJECT (entry));
407 pointer_changed (GObject *object, GParamSpec *pspec, gpointer data)
409 GtkLabel *label = GTK_LABEL (data);
413 g_object_get (object, pspec->name, &ptr, NULL);
415 str = g_strdup_printf ("Pointer: %p", ptr);
416 gtk_label_set_text (label, str);
421 object_changed (GObject *object, GParamSpec *pspec, gpointer data)
423 GtkLabel *label = GTK_LABEL (data);
428 g_object_get (object, pspec->name, &obj, NULL);
431 name = g_type_name (G_TYPE_FROM_INSTANCE (obj));
434 str = g_strdup_printf ("Object: %p (%s)", obj, name);
436 gtk_label_set_text (label, str);
441 model_destroy (gpointer data)
443 g_object_steal_data (data, "model-object");
444 gtk_widget_destroy (data);
448 window_destroy (gpointer data)
450 g_object_steal_data (data, "prop-editor-win");
454 property_widget (GObject *object, GParamSpec *spec, gboolean can_modify)
456 GtkWidget *prop_edit;
460 switch (G_PARAM_SPEC_TYPE (spec))
462 case G_TYPE_PARAM_INT:
463 adj = GTK_ADJUSTMENT (gtk_adjustment_new (G_PARAM_SPEC_INT (spec)->default_value,
464 G_PARAM_SPEC_INT (spec)->minimum,
465 G_PARAM_SPEC_INT (spec)->maximum,
467 MAX ((G_PARAM_SPEC_INT (spec)->maximum -
468 G_PARAM_SPEC_INT (spec)->minimum) / 10, 1),
471 prop_edit = gtk_spin_button_new (adj, 1.0, 0);
473 g_object_connect_property (object, spec->name,
474 GTK_SIGNAL_FUNC (int_changed),
475 adj, G_OBJECT (adj));
478 connect_controller (G_OBJECT (adj), "value_changed",
479 object, spec->name, (GtkSignalFunc) int_modified);
482 case G_TYPE_PARAM_UINT:
483 adj = GTK_ADJUSTMENT (
484 gtk_adjustment_new (G_PARAM_SPEC_UINT (spec)->default_value,
485 G_PARAM_SPEC_UINT (spec)->minimum,
486 G_PARAM_SPEC_UINT (spec)->maximum,
488 MAX ((G_PARAM_SPEC_UINT (spec)->maximum -
489 G_PARAM_SPEC_UINT (spec)->minimum) / 10, 1),
492 prop_edit = gtk_spin_button_new (adj, 1.0, 0);
494 g_object_connect_property (object, spec->name,
495 GTK_SIGNAL_FUNC (uint_changed),
496 adj, G_OBJECT (adj));
499 connect_controller (G_OBJECT (adj), "value_changed",
500 object, spec->name, (GtkSignalFunc) uint_modified);
503 case G_TYPE_PARAM_FLOAT:
504 adj = GTK_ADJUSTMENT (gtk_adjustment_new (G_PARAM_SPEC_FLOAT (spec)->default_value,
505 G_PARAM_SPEC_FLOAT (spec)->minimum,
506 G_PARAM_SPEC_FLOAT (spec)->maximum,
508 MAX ((G_PARAM_SPEC_FLOAT (spec)->maximum -
509 G_PARAM_SPEC_FLOAT (spec)->minimum) / 10, 0.1),
512 prop_edit = gtk_spin_button_new (adj, 0.1, 2);
514 g_object_connect_property (object, spec->name,
515 GTK_SIGNAL_FUNC (float_changed),
516 adj, G_OBJECT (adj));
519 connect_controller (G_OBJECT (adj), "value_changed",
520 object, spec->name, (GtkSignalFunc) float_modified);
523 case G_TYPE_PARAM_DOUBLE:
524 adj = GTK_ADJUSTMENT (gtk_adjustment_new (G_PARAM_SPEC_DOUBLE (spec)->default_value,
525 G_PARAM_SPEC_DOUBLE (spec)->minimum,
526 G_PARAM_SPEC_DOUBLE (spec)->maximum,
528 MAX ((G_PARAM_SPEC_DOUBLE (spec)->maximum -
529 G_PARAM_SPEC_DOUBLE (spec)->minimum) / 10, 0.1),
532 prop_edit = gtk_spin_button_new (adj, 0.1, 2);
534 g_object_connect_property (object, spec->name,
535 GTK_SIGNAL_FUNC (double_changed),
536 adj, G_OBJECT (adj));
539 connect_controller (G_OBJECT (adj), "value_changed",
540 object, spec->name, (GtkSignalFunc) double_modified);
543 case G_TYPE_PARAM_STRING:
544 prop_edit = gtk_entry_new ();
546 g_object_connect_property (object, spec->name,
547 GTK_SIGNAL_FUNC (string_changed),
548 prop_edit, G_OBJECT (prop_edit));
551 connect_controller (G_OBJECT (prop_edit), "changed",
552 object, spec->name, (GtkSignalFunc) string_modified);
555 case G_TYPE_PARAM_BOOLEAN:
556 prop_edit = gtk_toggle_button_new_with_label ("");
558 g_object_connect_property (object, spec->name,
559 GTK_SIGNAL_FUNC (bool_changed),
560 prop_edit, G_OBJECT (prop_edit));
563 connect_controller (G_OBJECT (prop_edit), "toggled",
564 object, spec->name, (GtkSignalFunc) bool_modified);
567 case G_TYPE_PARAM_ENUM:
573 prop_edit = gtk_option_menu_new ();
575 menu = gtk_menu_new ();
577 eclass = G_ENUM_CLASS (g_type_class_ref (spec->value_type));
580 while (j < eclass->n_values)
584 mi = gtk_menu_item_new_with_label (eclass->values[j].value_name);
586 gtk_widget_show (mi);
588 gtk_menu_shell_append (GTK_MENU_SHELL (menu), mi);
593 g_type_class_unref (eclass);
595 gtk_option_menu_set_menu (GTK_OPTION_MENU (prop_edit), menu);
597 g_object_connect_property (object, spec->name,
598 GTK_SIGNAL_FUNC (enum_changed),
599 prop_edit, G_OBJECT (prop_edit));
602 connect_controller (G_OBJECT (prop_edit), "changed",
603 object, spec->name, (GtkSignalFunc) enum_modified);
607 case G_TYPE_PARAM_UNICHAR:
608 prop_edit = gtk_entry_new ();
609 gtk_entry_set_max_length (GTK_ENTRY (prop_edit), 1);
611 g_object_connect_property (object, spec->name,
612 GTK_SIGNAL_FUNC (unichar_changed),
613 prop_edit, G_OBJECT (prop_edit));
616 connect_controller (G_OBJECT (prop_edit), "changed",
617 object, spec->name, (GtkSignalFunc) unichar_modified);
620 case G_TYPE_PARAM_POINTER:
621 prop_edit = gtk_label_new ("");
623 g_object_connect_property (object, spec->name,
624 GTK_SIGNAL_FUNC (pointer_changed),
625 prop_edit, G_OBJECT (prop_edit));
628 case G_TYPE_PARAM_OBJECT:
629 prop_edit = gtk_label_new ("");
631 g_object_connect_property (object, spec->name,
632 GTK_SIGNAL_FUNC (object_changed),
633 prop_edit, G_OBJECT (prop_edit));
638 msg = g_strdup_printf ("uneditable property type: %s",
639 g_type_name (G_PARAM_SPEC_TYPE (spec)));
640 prop_edit = gtk_label_new (msg);
642 gtk_misc_set_alignment (GTK_MISC (prop_edit), 0.0, 0.5);
649 properties_from_type (GObject *object,
653 GtkWidget *prop_edit;
663 class = G_OBJECT_CLASS (g_type_class_peek (type));
664 specs = g_object_class_list_properties (class, &n_specs);
669 table = gtk_table_new (n_specs, 2, FALSE);
670 gtk_table_set_col_spacing (GTK_TABLE (table), 0, 10);
671 gtk_table_set_row_spacings (GTK_TABLE (table), 3);
676 GParamSpec *spec = specs[i];
681 can_modify = ((spec->flags & G_PARAM_WRITABLE) != 0 &&
682 (spec->flags & G_PARAM_CONSTRUCT_ONLY) == 0);
684 if ((spec->flags & G_PARAM_READABLE) == 0)
686 /* can't display unreadable properties */
691 if (spec->owner_type != type)
693 /* we're only interested in params of type */
698 label = gtk_label_new (g_param_get_nick (spec));
699 gtk_misc_set_alignment (GTK_MISC (label), 0.0, 0.5);
700 gtk_table_attach_defaults (GTK_TABLE (table), label, 0, 1, i, i + 1);
702 prop_edit = property_widget (object, spec, can_modify);
703 gtk_table_attach_defaults (GTK_TABLE (table), prop_edit, 1, 2, i, i + 1);
708 gtk_widget_set_sensitive (prop_edit, FALSE);
710 if (g_param_get_blurb (spec))
711 gtk_tooltips_set_tip (tips, prop_edit, g_param_get_blurb (spec), NULL);
713 /* set initial value */
714 g_object_notify (object, spec->name);
721 vbox = gtk_vbox_new (FALSE, 0);
722 gtk_box_pack_start (GTK_BOX (vbox), table, FALSE, FALSE, 0);
724 sw = gtk_scrolled_window_new (NULL, NULL);
725 gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (sw),
726 GTK_POLICY_NEVER, GTK_POLICY_AUTOMATIC);
728 gtk_scrolled_window_add_with_viewport (GTK_SCROLLED_WINDOW (sw), vbox);
736 /* Pass zero for type if you want all properties */
738 create_prop_editor (GObject *object, GType type)
743 GtkWidget *properties;
747 if ((win = g_object_get_data (G_OBJECT (object), "prop-editor-win")))
749 gtk_window_present (GTK_WINDOW (win));
753 win = gtk_window_new (GTK_WINDOW_TOPLEVEL);
755 tips = gtk_tooltips_new ();
756 gtk_signal_connect_object (GTK_OBJECT (win), "destroy",
757 GTK_SIGNAL_FUNC (gtk_object_destroy), GTK_OBJECT (tips));
759 /* hold a weak ref to the object we're editing */
760 g_object_set_data_full (G_OBJECT (object), "prop-editor-win", win, model_destroy);
761 g_object_set_data_full (G_OBJECT (win), "model-object", object, window_destroy);
765 notebook = gtk_notebook_new ();
766 gtk_notebook_set_tab_pos (GTK_NOTEBOOK (notebook), GTK_POS_LEFT);
768 gtk_container_add (GTK_CONTAINER (win), notebook);
770 type = G_TYPE_FROM_INSTANCE (object);
772 title = g_strdup_printf ("Properties of %s widget", g_type_name (type));
773 gtk_window_set_title (GTK_WINDOW (win), title);
778 properties = properties_from_type (object, type, tips);
781 label = gtk_label_new (g_type_name (type));
782 gtk_notebook_append_page (GTK_NOTEBOOK (notebook),
786 type = g_type_parent (type);
791 properties = properties_from_type (object, type, tips);
792 gtk_container_add (GTK_CONTAINER (win), properties);
793 title = g_strdup_printf ("Properties of %s", g_type_name (type));
794 gtk_window_set_title (GTK_WINDOW (win), title);
797 gtk_window_set_default_size (GTK_WINDOW (win), -1, 400);
799 gtk_widget_show_all (win);