|
|
|
|
|
|
|
|
|
version 6.0
DR Draw text (area; startH; startV; endH; endV; text{; frame{; expansion}}) 
Longint
| Parameter | Type | Description | |
| area | Longint | | 4D Draw area |
| startH | Number | | Horizontal position of start |
| startV | Number | | Vertical position of start |
| endH | Number | | Horizontal position of end |
| endV | Number | | Vertical position of end |
| text | Text | | Text of new text object |
| frame | Integer | | 0=Variable |
| 1=Fixed | |||
| expansion | Integer | | 0=Down |
| 1=Up | |||
| Function result | Longint |  | Object ID |
Description
The command DR Draw text creates a new text object in area and returns the ID of the object.
The new object is positioned according to startH, startV, endH, and endV and filled with text. All four coordinates are expressed in base units from the current origin. Use the DR Scale to base function to convert from scale units to base units.
text must be at least one character in length, otherwise the object is not created. The font, size, style, and justification of the new text object is determined by the current default text attributes. See the DR SET TEXT ATTRIBUTES command.
The optional frame parameter controls whether the text object has a fixed size.
• If frame equals 0 or is not specified, the height of the object is variable and is determined by the amount of text and the width of the text object.
• If frame equals 1, the height of the object is fixed and any text that does not fit within the text object is truncated.
• If frame is omitted, expansion must also be omitted.
expansion describes the direction in which text will flow within the object when it wraps to the next line.
• If expansion equals 0, the text object expands down the page to accommodate a new line of text.
• If expansion equals 1, the text object expands up the page when a line of text is added.
frame and expansion are especially useful when working with text objects that contain references. Since references can insert any amount of text, having control over the size and flow direction of text objects during printing is very useful.
See Also
DR GET TEXT ATTRIBUTES, DR SET TEXT ATTRIBUTES.
|
|
|
|
|
|
|
|
|