ArborX

setcols

Longname: setcols   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 update ttmaptab (n/a) select

Summary
 Clears columns from a frame before an update 'frame raw column' action as part of an inline frame update command sequence within the <?frame> command.
Example extract

This sample when placed inline and formatted will modify a frames columns.

 <?frame select "fname"> 1
 <?frame setcols> 2
 <?frame raw column 5,20> 3
 <?frame raw column 25,40> 4
 <?frame update "fname pb"> 5
4
Select the frame to be updated.
6
Clear the existing columns.
8
Define the new columns.
10
Update the frame with immediate effect.

Syntax (7.67a)
setcols Ø

For example, say you have the following command sequence to select and update a frame inline.
  1
 <?frame select "fname"> 2
 <?frame raw column 25.4,102.5> 3
 <?frame raw column 107.5,184.6> 4
 <?frame update "fname"> 5

Then you must do a <?frame setcols> before <?frame raw columns....> to 'clear' the old columns first - otherwise the new columns will be added onto any existing ones.

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