PNewStorySized

Creates new empty text block and sizes it to the specified coordinates (same as drag-clicking the text tool).

Command constructor

PNewStorySized(long xLeftTop, long yLeftTop, long xRightBottom, long yRightBottom);

long xLeftTop;
x-coordinate of left edge of text block in twips
long yLeftTop;
y-coordinate of top edge of text block in twips
long xRightBottom;
x-coordinate of right edge of text block in twips
long yRightBottom;
y-coordinate of bottom edge of text block (value ignored, but must be a valid value; see notes)

Insertion point. Following this command, the insertion point is active and positioned at the top of the text block.

yRightBottom a placeholder. When sizing the new text block, PageMaker ignores the value of yRightBottom (a text block does not have a vertical dimension until it contains text). When you enter or paste text, PageMaker expands the text block down as far as necessary to accommodate the text, stopping when it reaches the bottom of the page, the bottom of the pasteboard (if the text block is contained entirely on the pasteboard), or a graphic with column-break text wrap applied.

Column guides and Snap To options ignored. Unlike the PNewStory command, PNewStorySized ignores column guides and sizes the text block to the specified coordinates. Also, the command is not sensitive to the setting of the Snap to Guides and Snap to Ruler options. PageMaker sizes the text block to the locations you specify, regardless of any guides or rulers.

Off pasteboard. If the coordinates are off the pasteboard, PageMaker sizes the text block to the pasteboard edge.

Exceptions. PNewStorySized throws a CQ_INVALID_ARGS exception for any of the following conditions:

You did not enter coordinates in order, from the top left to bottom right. Left coordinates must be greater than right coordinates, and top coordinates must be greater than bottom coordinates. (Remember: In the PageMaker coordinate system, values increase as you move down from the zero point.)
The width of the text block exceeds the maximum PageMaker column width (21 inches, 533.4 millimeters, or 126 picas).
The height of the text block exceeds the maximum PageMaker column depth (22.6 inches, 574 millimeters, or 135p7.2 picas)

Example. The following example creates a new (empty) text block and pastes the contents of the Clipboard into the text block.

PGetConvertStr x("1i"); PNewStorySized(x, x, 5 * x, 5 * x); PPaste();

PNewStorySized

Command constructor

See also