Move page item into a rectangle

Question

Hello guys,
the indesign client allows it to move a page item into a rectangle by copy it and pase with the option "paste into selection". How this behavior can be achieved by scripting on the indesign server?
Thanks for the answers!

Answer 1

That turned out to be a bit harder than I thought as first ...
It seems you cannot simply do
  rectangles[0].add (someOtherObject);
or
  someOtherObject.move (rectangles[0]);
With the regular version of CS4, you can easily copy the manual approach:
app.cut();
app.documents[0].rectangles[0].select();
app.pasteInto();
-- but does that even work on ID Server? (I would guess not.)
The hard way is to add an instance of your original object to the correct type of the rectangle's properties array, copy all properties of the original object into the new one, then delete the original object.
For instance, if you want to 'move' a text frame into a rectangle, do something like
origTf = textFrames[0];
myTf = rectangles[0].textFrames.add();
myTf.geometricBounds = orgTf.geometricBounds;
myTf.strokeWidth = orgTf.strokeWidth;
myTf.fillColor = orgTf.fillColor;
... for all possible properties of a text frame. For an image, do the same but with Image properties. For a graphic line, do the same but with GraphicLine properties ... (It sounds like a totally insane way of working, but remember that internally InDesign itself can access all lists of properties 'immediately'.)
You cannot use a PageItem this way ... because you can't "add" a page item!
Dave Saunders shows how it works with a very basic text frame: Easily Add Captions to Graphic Frames