While the name sounds devious that's exactly what this function does.
It takes the list of children from the this and clears the internal list. The calling function is now in charge of the ref's on the children it has taken. A lot of responsibility involved in taking children.
| this |
The |
|
A List of pointers to Menuitem objects. |