ArborX

pageoffset

Longname: pageoffset   Open the Documentation Legend
Released: 7.67a 
Created: 7.67a 
See also: <?page> <?frame> clear default width height kill add-to-page raw position size text text-margins page-kill event end-of pb (n/a) after-page text-flags ttmapret ttmaprety ttignmsp ttignssp ttignesp ttignsp resize update ttmaptab (n/a) select setcols

Summary
 This keyword will offset the start of a new frame by the designated number of pages as part of an inline frame creation command sequence within the <?frame> command and in conjunction with the end-of keyword.
Example extract

This sample when placed inline and formatted will create a frame of 80 x 30mm positioned at 50mm down 70mm accross with the frame name "Simple_1".

 <?frame clear> 1
 <?frame size 80mm, 30mm> 2
 <?frame position 50mm, 70mm> 3
 <?frame raw name "Simple_1"> 4
 <?frame event end-of "simple_2" pageoffset 1> 5
 <?frame add-to-page> 6
4
Always clear any preexisting frame properties that may be in memory, otherwise they could get applied to the frame that you are creating.
6
The size of your frame.
8
The position of your frame.
10
Give the frame a name. This is because frames are always referred to by name if they require modification (the frame number is never used). This is also useful because of the way auto frames are handled internally - the name is required to uniquely identify a frame. This is particularly important for the autocopy feature, and for killing frames.
12
Start the frame 1 page after frame "simple_2" is finished.
14
Always add to page (this actually adds the frame to the page).

Syntax (7.67a)
pageoffset offset_page_number:n
offset_page_number:n The number of pages to offset before the new frame is started.

The keyword pageoffset follows the frame name of the end-of keyword and is the number of pages on from where the ’event’ occurs, where the new frame will start. By default, a frame will start on the same page, which is the same as specifying pageoffset 0, or omitting it altogether.

e.g <?frame event end-of "A" pageoffset 2>

Frame A would typically finish because of a <?frame kill "fname"> command or its pagelife coming to an end. See tfpagelife and Technote 0063; Auto Copy and Frame Page Life; 7.68a.

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