domObj.reparent

(Merge only) 

Make an object in the DOM have a new parent object.

Syntax

domObj.reparent(newParent, [xOffset, yOffset])

Returned Value

Nothing.

Parameters

newParent defines the object which will be the new parent object for domObj. This should be a Page, Container, Pane, or Group. (As of 3.1.001.15) it's also acceptable for newParent to be zero. That indicates that domObj is to simply be removed from the document DOM. 

(As of 3.2.001.01)

xOffset is the optional new _left for the object once it has its new parent. Defaults to zero.

yOffset is the optional new _top for the object once it has its new parent. Defaults to zero.

Usage

Very rare and unusual. This has been used to move objects into different Groups or Panes. Generally, it has been used in some form of "columnarizing". Given the built-in facilities of Layout in multiple columns, the usage of this function has dropped. It has been used to move objects off of one page and onto another one. This essentially allowed pages to be merged after pagination had been completed. Clearly, special circumstances were involved. Note that you could easily supply 0 for xOffset and yOffset and after the fact set ._absLeft etc. as desired.