ArborX


insert

Longname: insert   Open the Documentation Legend
Released: 7.67a 
Created: 7.67a 
See also: <?page> <?frame> add-layer append apply clear create current insert name raw rel-offset remove-layer resize

Summary
Inserts a new page as part of an inline page creation command sequence. Used within the <?page> command.
Example extract

This example adds a new frame to the current page.

 <?page current> 1
 <?frame clear> 1 2
 <?frame raw frame 0,0,50,50> 3
 <?frame add-to-page> 4

Syntax (7.67a)
insert  abs-pos:L?  rel-offset:L?
Ø: Default without parameter keywords the <?page insert?> will insert the new page immediately following the page containing the command.
abs-pos:L Followed by a valid numerical value will insert the page an absolute position in the current page. (See also abs-pos).
rel-offset:L Followed by a valid numerical value will insert the page at a position relative to the document. (See also rel-offset).

For example, <?page insert rel-offset 2> if the command is on page 2, the new page will be inserted as page 4. For example, <?page insert abs-pos 3> the new page will be page 3. The syntax <?page insert rel-offset 0> means the same as <?page insert> and will insert the new page immediately after the page containing the command. It is not possible to insert a new page as the first page of the document, unless this is done from the pre-format stream.


Document created on 05-Apr-2003 (revision 001)