widget_push_composite_child

[Jeffrey Barish <jeff_barish earthlink net>]

I asked this question on the pygtk mailing list, but got no response.  As
the scope is not limited to PyGTK, I am hoping that someone here knows the
answer.

-------------------------------------------------------------------------
I understand that I can add composite children to a widget by creating them
between widget_push_composite_child and widget_pop_composite_child calls.

gtk.widget_push_composite_child()
widget1 = gtk.Widget1()
widget2 = gtk.Widget2()
gtk.widget_pop_composite_child()
widget1.set_parent(main_widget)
widget2.set_parent(main_widget)

Aside from the difference between foreach and forall, is this code otherwise
equivalent to

widget1 = gtk.Widget1()
widget2 = gtk.Widget2()
main_widget.add(widget1)
main_widget.add(widget2)

I ask this question because I am trying to understand exactly what is meant
by "composite children".

The documentation also uses the term "internal children".  Are they the same
as composite children?

Also, the Container class has a method get_children() which returns a list
of all non-internal children.  What is the method for obtaining a list of
internal children?
-- 
Jeffrey Barish