SetBoxTop

Navigation:  »No topics above this level«

SetBoxTop

Return to chapter overview

void = SetBoxTop(nQuarkUnits)

 

Use the SetBoxTop macro function to specify the top position of the textbox that contains the macro token.

 

The top position of a textbox is related to the Y value which appears in the Measurements Palette of QuarkXPress as shown below.

 

 

The function expects Quark internal units, whereby:

 

a point is defined as 65536 units

therefore an inch is 4718592 units

and a millimeter is approximately 185771 units

 

The value of the position you supply to this function must include the offset from the pasteboard to the top of the page. This means all values must be increased by 1/2 inch, so if you wish to set the box top to 5 inches then you need to pass in 5.5 inches (ie. to 25952256 in Quark units).

 

IMPORTANT:

 

This function only changes the top position of the box; the bottom position of the box remains unchanged. This means that a call to this function changes the height of the box. Therefore any call to SetBoxHeight should always occur after calls to SetBoxTop.

Calls to textbox resizing macro functions take effect immediately, before executions passes to the next line of the macro. Therefore it is essential that you place the calls in the proper order so that you are not telling Quark to set the bottom of a box above its top, or the right side of a box to the left of its left position.

 

Textbox resizing functions only work on textboxes whose angle is a multiple of 90 degrees (0­°, 90°, 180°, or 270°), and functions which specify an absolute value for one or more of the top-left-bottom-right sides of a textbox, such as the present function, should not be used if the textbox angle is different from zero, unless you really know what you are doing.


Topic 179900 updated on 07-Aug-17.
Topic URL: https://www.qppstudio.net/webhelp/index.html?boxtop.htm