The TEXT object allows the user to put a line of text on the page in a specified area. This object must always specify a VALUE property with a string that can contain one or more of the following metavariables.
| Metavariable | Description |
|---|---|
| &USERNAME | Prints the user’s name. |
| &CURDATE | Prints the current date. |
| &CURTIME | Prints the current time. |
| &PRINTDATE | Prints the date for which the object is printed. |
| &PAGENUM | Prints the page number. |
| &TIMEZONE | Prints the current time zone. |
| && | Prints an ampersand (&). |
The OPTIONS property, if present, requires the following parameters.
| Parameter | Description |
|---|---|
| HCENTER | LEFT | RIGHT | Specifies the horizontal justification. |
| VCENTER | NONE | Specifies the vertical justification. |
| ELLIPSIS | NONE | Adds an ellipsis to the end of a string if the entire string does not fit within the described rectangle. Multiline text prints if there is room in the rectangle, but using VCENTER on a multiline text block can produce unpredictable results. |