User Guide

898 Chapter 2: ActionScript Language Reference

TextField.mouseWheelEnabled

Availability

Flash Player 7.

Usage

my_txt.mouseWheelEnabled:Boolean

Description

Property; a Boolean value that indicates whether Flash Player should automatically scroll

multiline text fields when the mouse pointer clicks a text field and the user rolls the mouse wheel.

By default, this value is

true. This property is useful if you want to prevent mouse wheel scrolling

of text fields, or implement your own text field scrolling.

Example

The following example creates two text fields. The scrollable_txt field has the

mouseWheelEnabled property set to true, so scrollable_txt scrolls when you click the field

and roll the mouse wheel. The

nonscrollable_txt field does not scroll if you click the field and

roll the mouse wheel.

var font_array:Array = TextField.getFontList().sort();

this.createTextField("scrollable_txt", this.getNextHighestDepth(), 10, 10,

240, 320);

scrollable_txt.border = true;

scrollable_txt.wordWrap = true;

scrollable_txt.multiline = true;

scrollable_txt.text = font_array.join("\n");

this.createTextField("nonscrollable_txt", this.getNextHighestDepth(), 260, 10,

240, 320);

nonscrollable_txt.border = true;

nonscrollable_txt.wordWrap = true;

nonscrollable_txt.multiline = true;

nonscrollable_txt.mouseWheelEnabled = false;

nonscrollable_txt.text = font_array.join("\n");