Textbox size and number of elementsΒΆ

width = integer

The actual screen width of the textbox, in pixels or characters, depending on the positioning system in use. See Pixel and character positioning.

If this property is not specified or is set to 0, Sculptor assigns a width suitable to accommodate the linked field. The size of an alphanumeric field is determined by the number of bytes in the field, the size of a numeric field by the number of characters in its format.

If a proportional font is being used to display textbox data, then Sculptor applies a formula based on the linked field size, and on the maximum and average width of characters in the data font, when calculating the default width.

If the data in the linked field is wider than the textbox, the visible part of the field scrolls horizontally during input. The LEFT and RIGHT ARROW keys can be used to move hidden characters into view, and the HOME and END keys to move to the beginning or end of the data in the field.

At run time, this property only returns a value if a width has been assigned. If the width = property is absent it always returns 0. The read-only property row_width can be used to retrieve the textbox width at run time, whether or not a width has been assigned.

See also: Textbox linked field, Textbox data font; Field formats

height = integer

The height of the textbox, in pixels or rows, according to the positioning system in use. This property is only assigned if the textbox is a free format type, with word wrap.

Default: 1

rows = integer

The number of vertical elements. Assigning a value greater than 1 results in a multi-row textbox. For example, setting integer to 5 would result in five identical textboxes in a vertical column, with the label positioned above. The default is 0. Setting rows to 1 has no effect except to mark the box as multi-row, causing the label to be moved from the left of the textbox to the top.

Note the difference between a multi-row textbox, where each row must be entered individually, and a free format textbox where text can flow from one line to the next.

A textbox with a rows clause specified should be linked to a subscripted field. The number of elements in the field may exceed the number of rows.

Default: 0

row_width

A read-only property returning the actual width of the textbox. The width is an integer value, in pixels or characters according to the positioning type being used.

row_height

A read-only property returning the height of one row in pixels or characters according to the positioning type being used. Under character positioning this property will always be 1. See Pixel and character positioning.


RELATED TOPICS

Textboxes

Multi-row textboxes

Free format textboxes