Flash CS3 Documentation

Using ActionScript 3.0 Components > Using the UI Components > Using the ScrollPane

Using the ScrollPane

You can use the ScrollPane component to display content that is too large for the area into which it is loaded. For example, if you have a large image and only a small space for it in an application, you could load it into a ScrollPane. The ScrollPane can accept movie clips, JPEG, PNG, GIF, and SWF files.

Components such as the ScrollPane and the UILoader have complete events that allow you to determine when content has finished loading. If you want to set properties on the content of a ScrollPane or UILoader component, listen for the complete event and set the property in the event handler. For example, the following code creates a listener for the Event.COMPLETE event and an event handler that sets the alpha property of the ScrollPane's content to .5:

function spComplete(event:Event):void{
  aSp.content.alpha = .5;
}
aSp.addEventListener(Event.COMPLETE, spComplete);

If you specify a location when loading content to the ScrollPane, you must specify the location (X and Y coordinates) as 0, 0. For example, the following code loads the ScrollPane properly because the box is drawn at location 0, 0:

var box:MovieClip = new MovieClip();
box.graphics.beginFill(0xFF0000, 1);
box.graphics.drawRect(0, 0, 150, 300);
box.graphics.endFill();
aSp.source = box;    //load ScrollPane

For more information, see the ScrollPane class in the ActionScript 3.0 Language and Components Reference.

Related topics

• User interaction with the ScrollPane
• ScrollPane parameters
• Creating an application with the ScrollPane

Flash CS3