diff --git a/collects/scribblings/gui/win-overview.scrbl b/collects/scribblings/gui/win-overview.scrbl index 8d5670eedd..a3585dd348 100644 --- a/collects/scribblings/gui/win-overview.scrbl +++ b/collects/scribblings/gui/win-overview.scrbl @@ -458,10 +458,9 @@ Each @tech{containee}, or child, has the following properties: A @tech{container} arranges its children based on these four properties of each @tech{containee}. A @tech{containee}'s parent - container is specified when the @tech{containee} is created, and the - parent cannot be changed. However, a @tech{containee} can be - @tech{hidden} or @tech{deleted} within its parent, as described in - @secref["containers"]. + container is specified when the @tech{containee} is created. A window + @tech{containee} can be @tech{hidden} or @tech{deleted} within its + parent, and its parent can be changed by @tech{reparent}ing. The @deftech{graphical minimum size} of a particular containee, as reported by @method[area<%> get-graphical-min-size], depends on the @@ -535,10 +534,11 @@ These properties are factored into the container's calculation of its size and stretchability are the same as for its containee aspect. A containee's parent container is specified when the containee is - created, and the parent cannot be changed. However, a containee + created. A containee window can be @tech{hidden} or @tech{deleted} within its parent - container (but a non-window containee cannot be @tech{hidden} or - @tech{deleted}): + container, and its parent can be changed by @tech{reparent}ing + (but a non-window containee cannot be @tech{hidden}, + @tech{deleted}, or @tech{reparent}ed): @itemize[ @@ -553,6 +553,10 @@ A containee's parent container is specified when the containee is delete-child] or @method[area-container<%> add-child] method (which calls the child's @method[window<%> show] method).} + @item{To @deftech{reparent} a window containee, use the + @method[subwindow<%> reparent] method. The window retains its + @tech{hidden} or @tech{deleted} status within its new parent.} + ] When a child is created, it is initially shown and non-deleted. A