ActionScript for Flash MX: The Definitive Guide, Second Edition

TextField.hscroll Property

This is the Title of the Book, eMatter Edition

Copyright © 2007 O’Reilly & Associates, Inc. All rights reserved.

Alphabetical Language Reference

|

843

See Also

TextField.autoSize, TextField.textHeight, TextField._width, TextField._yscale, the

TextFormat class

TextField.hscroll Property

a text field’s horizontal scroll position, in pixels

Flash 6

read/write

theField.hscroll

Description

When a field’s text is wider or higher than can be accommodated by the physical viewable

region of its bounding box, excess text is hidden from view. To bring the text into view, we

can scroll the field horizontally or vertically using the

hscroll and scroll properties. The

integer

hscroll property specifies the number of pixels a field’s text is scrolled to the left.

The default, 0, indicates that the text is not scrolled horizontally (the first character in the

field is flush with the left border of the field’s bounding box). If a field’s text can be fully

displayed without any horizontal cutoff,

hscroll remains at 0 and cannot be set. But if a

field’s text cannot be fully displayed horizontally in the allotted space, setting

hscroll to a

positive integer offsets the text by the specified number of pixels to the left, up to the

maximum set by

maxhscroll. When more than one line is displayed in a field, all lines are

moved simultaneously. Scrolling caused by user input is reflected by

hscroll. Note ...