
TextField.scroll Property
This is the Title of the Book, eMatter Edition
Copyright © 2007 O’Reilly & Associates, Inc. All rights reserved.
864
|
ActionScript Language Reference
TextField.scroll Property
the current top line displayed in a text field
Flash 6; corresponds to the scroll property in Flash 4 and Flash 5
read/write
theField.scroll
Description
The integer scroll property represents the number (index) of the line currently displayed
as the first line in a field’s viewable region. When the text in a text field spans more lines
than can be accommodated by the physical viewable region of the field, extra lines of text
are hidden but are still part of the text field. The top line is number 1, and line numbers
increase for every line in the text field, including those that exceed the viewable boundaries
of the field, as shown in Figure R-6.
Setting the value of
scroll scrolls the text field, making the supplied line number the top
line in the field’s viewable region. For example, if we set the
scroll property of the text
field shown in Figure R-6 to 3, the text field displays:
or
thoughts
in
Example
In combination, the scroll and maxscroll properties can be used to create scroll buttons
for a text field. This example scrolls text down one line for each click of a button:
scrollButton.onPress = function () {
if (theField_txt.scroll < theField_txt.maxscroll) {
theField_txt.scroll++;
}
};
And here’s how we ...