Add hints about the lifecycle of widgets. (#159503, Christian Persch)

2005-01-13  Matthias Clasen  <mclasen@redhat.com>

	* gtk/gtkuimanager.c (gtk_ui_manager_get_widget): Add hints about
	the lifecycle of widgets.  (#159503, Christian Persch)

diff --git a/ChangeLog b/ChangeLog
index 7159c395dbe456aa642d56c13f8bba4f5c8dd2a6..7672951b560e2741a636e7c1fc3a0260cf1543a0 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,8 @@
 2005-01-13  Matthias Clasen  <mclasen@redhat.com>
 
+       * gtk/gtkuimanager.c (gtk_ui_manager_get_widget): Add hints about 
+       the lifecycle of widgets.  (#159503, Christian Persch)
+
        * demos/gtk-demo/main.c (create_text): Use monospace for the 
        source code view.  (#163526, Theerud Lawtrakul)
 

diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10
index 7159c395dbe456aa642d56c13f8bba4f5c8dd2a6..7672951b560e2741a636e7c1fc3a0260cf1543a0 100644 (file)
--- a/ChangeLog.pre-2-10
+++ b/ChangeLog.pre-2-10
@@ -1,5 +1,8 @@
 2005-01-13  Matthias Clasen  <mclasen@redhat.com>
 
+       * gtk/gtkuimanager.c (gtk_ui_manager_get_widget): Add hints about 
+       the lifecycle of widgets.  (#159503, Christian Persch)
+
        * demos/gtk-demo/main.c (create_text): Use monospace for the 
        source code view.  (#163526, Theerud Lawtrakul)
 

diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8
index 7159c395dbe456aa642d56c13f8bba4f5c8dd2a6..7672951b560e2741a636e7c1fc3a0260cf1543a0 100644 (file)
--- a/ChangeLog.pre-2-8
+++ b/ChangeLog.pre-2-8
@@ -1,5 +1,8 @@
 2005-01-13  Matthias Clasen  <mclasen@redhat.com>
 
+       * gtk/gtkuimanager.c (gtk_ui_manager_get_widget): Add hints about 
+       the lifecycle of widgets.  (#159503, Christian Persch)
+
        * demos/gtk-demo/main.c (create_text): Use monospace for the 
        source code view.  (#163526, Theerud Lawtrakul)
 

diff --git a/gtk/gtkuimanager.c b/gtk/gtkuimanager.c
index e507a75e00f8cb9279caf836d6b5e9c367112d46..439cfc8ec32ce6a97191cbf32f340375949f75cd 100644 (file)
--- a/gtk/gtkuimanager.c
+++ b/gtk/gtkuimanager.c
@@ -736,6 +736,11 @@ gtk_ui_manager_get_accel_group (GtkUIManager *self)
  *
  * Note that the widget found by following a path that ends in a <menu>
  * element is the menuitem to which the menu is attached, not the menu itself.
+ *
+ * Also note that the widgets constructed by a ui manager are not tied to 
+ * the lifecycle of the ui manager. If you add the widgets returned by this 
+ * function to some container or explicitly ref them, they will survive the
+ * destruction of the ui manager.
  * 
  * Return value: the widget found by following the path, or %NULL if no widget
  *   was found.