suzanne.soy/racket
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source 
Closes PR 13108
This commit is contained in:
Matthew Flatt 2012-09-13 14:10:45 -06:00
parent ade2d7a4a4
commit ff35e7c95b
1 changed files with 11 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
collects/scribblings/gui/win-overview.scrbl
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 A @tech{container} arranges its children based on these four
properties of each @tech{containee}. A @tech{containee}'s parent properties of each @tech{containee}. A @tech{containee}'s parent
container is specified when the @tech{containee} is created, and the container is specified when the @tech{containee} is created. A window
parent cannot be changed. However, a @tech{containee} can be @tech{containee} can be @tech{hidden} or @tech{deleted} within its
@tech{hidden} or @tech{deleted} within its parent, as described in parent, and its parent can be changed by @tech{reparent}ing.
@secref["containers"].
The @deftech{graphical minimum size} of a particular containee, as The @deftech{graphical minimum size} of a particular containee, as
reported by @method[area<%> get-graphical-min-size], depends on the 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. size and stretchability are the same as for its containee aspect.
A containee's parent container is specified when the containee is 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 window can be @tech{hidden} or @tech{deleted} within its parent
container (but a non-window containee cannot be @tech{hidden} or container, and its parent can be changed by @tech{reparent}ing
@tech{deleted}): (but a non-window containee cannot be @tech{hidden},
@tech{deleted}, or @tech{reparent}ed):
@itemize[ @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 delete-child] or @method[area-container<%> add-child] method (which
calls the child's @method[window<%> show] method).} 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 When a child is created, it is initially shown and non-deleted. A