racket/gui: fix docs on reparenting (which is now possible)

Closes PR 13108
This commit is contained in:
Matthew Flatt 2012-09-13 14:10:45 -06:00
parent ade2d7a4a4
commit ff35e7c95b

View File

@ -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