CreateColumns Object Command

Draws text frames on a range of pages with one or more columns in them.

createcolumns [DEFAULT | MARGINS inside top outside bottom] [COLUMNS number] [GUTTER space] [link] [ROTATE angle | SKEW slantangle twistangle | SLANT angle | TWIST angle] [ABOUT pointx pointy | ABOUTCENTER] [constraint] [printable] [stack] [IDLIST stem] [PAGE number | WINDOW name] [TO number]

DEFAULT Creates frames matching the page guides. Default.

MARGINS/d The coordinates of the frames to create.

COLUMNS/i The number of columns in the frame. Default=1.

GUTTER/d The space between columns. Default=0.

link/k Specifies whether the frames are linked. Options: LINKED|UNLINKED.

ROTATE/d The rotation angle. Default=0.

SKEW/d The slant and twist angle. Default=0.

SLANT/d The slant angle. Default=0.

TWIST/d The twist angle. Default=0.

ABOUT/d The rotation point.

ABOUTCENTER Rotates around its center. Default.

constraint/k The aspect ratio constraint toggle. Options: CONSTRAIN|FREE (default).

printable/k The print object toggle. Options: PRINT (default)|NOPRINT.

stack/k The stack position. Options: INFRONT (default)|INBACK.

IDLIST/a Returns the object IDs for the new frames.

PAGE/s The page number. Default=current.

WINDOW/s The window name. Default=current.

TO/i The number of the last page in the range. Default=same as PAGE.

Results:

The identification number (handle) of the last text frame created is returned to RESULT.

IDLIST stem
count Number of frames created.
0 The object id of the first frame.
1 The object id of the second frame.
etc.

Notes:

Use the drawcolumn command to draw a single column on one page and to draw a fixed size column. Use the createcolumns command to draw columns on more than one page, and to draw columns relative to the page size.

Examples:
ARexx:

CreateColumns  Command Definition  url:PGScmd/createcolumns
  created:2006-03-30 10:07:13   last updated:2006-08-18 11:18:39
  Copyright © 1985-2024 GrasshopperLLC. All Rights Reserved.