User Guide

TextField.scroll 915
TextField.scroll
Availability
Flash Player 6.
Usage
my_txt.scroll
Description
Property; defines the vertical position of text in a text field. The scroll property is useful for
directing users to a specific paragraph in a long passage, or creating scrolling text fields. This
property can be retrieved and modified.
The units of horizontal scrolling are pixels, while the units of vertical scrolling are lines.
Horizontal scrolling is measured in pixels because most fonts you typically use are proportionally
spaced; meaning, the characters can have different widths. Flash performs vertical scrolling by line
because users usually want to see a line of text in its entirety, as opposed to seeing a partial line.
Even if there are multiple fonts on a line, the height of the line adjusts to fit the largest font in use.
For more information on scrolling text, see “Creating scrolling text” in Using Flash.
Example
The following example sets the maximum value for the scrolling text field my_txt. Create two
buttons,
scrollUp_btn and scrollDown_btn, to scroll the text field. Add the following
ActionScript to your FLA or AS file.
this.createTextField("scroll_txt", this.getNextHighestDepth(), 10, 10, 160,
20);
this.createTextField("my_txt", this.getNextHighestDepth(), 10, 30, 320, 240);
my_txt.multiline = true;
my_txt.wordWrap = true;
for (var i = 0; i<10; i++) {
my_txt.text += "Lorem ipsum dolor sit amet, consectetuer adipiscing elit,
sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat
volutpat.";
}
scrollUp_btn.onRelease = function() {
my_txt.scroll--;
scroll_txt.text = my_txt.scroll+" of "+my_txt.maxscroll;
};
scrollDown_btn.onRelease = function() {
my_txt.scroll++;
scroll_txt.text = my_txt.scroll+" of "+my_txt.maxscroll;
};
See also
TextField.hscroll, TextField.maxscroll