ArborX


update

Longname: update   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 pageoffset end-of pb (n/a) after-page text-flags resize select setcols

Summary
Will instruct 3B2 to update the current frame as the last action of an inline frame creation command sequence within the <?frame> command.
Example extract

This sample when placed inline and formatted will select a frame, change its colour and update it from the current page onwards.

 <?frame select "simple_1"> 1
 <?frame raw bcolour red> 2
 <?frame update "simple_1" pb> 3

Syntax (7.67a)
frame_name:s Name of the frame of which to update.
pb:L The optional literal keyword 'pb' will instruct the 'update' frame keyword to update from the current page, if it is not specified the changes will only be applied from the following page.
rf-now:L Reformat now. This is the default. Restarts the page immediately without processing any more PIs. (added in version 8.13q).
rf-auto:L Reformat auto. Restart the page after all start-of-line style information is collected. (added in version 8.13q).
rf-none:L No reformat. Does not trigger any reformat. Exercise caution with this option. The reformat must be done eventually in order for the changes to take effect so it is assumed that a future frame update will trigger the reformat. (added in version 8.13q).

To change an existing frame’s attributes , e.g colour, rotation etc, in-line, use these following two commands shown. Between select and update, specify the new attributes using <?frame raw ....> commands.

 <?frame select "fname"> .... <?frame update "fname" pb>

To change size or position use the resize commands.


Document created on 07-Apr-2003, last reviewed on 06-Sep-2005 (revision 001)