Flash CS3 Documentation

ActionScript 2.0 Components Language Reference > Media components > Media.autoSize

Media.autoSize

MediaDisplay, MediaPlayback.

Flash Player 7.

Flash MX Professional 2004.

myMedia.autoSize

Property; a Boolean value that determines the size of the media-viewing portion of the MediaDisplay or MediaPlayback component.

For the MediaDisplay component, the property behaves as follows:

If you set this property to true, Flash displays the media at its preferred size, regardless of the size of the component. This implies that, unless the MediaDisplay instance size is the same as the size of the media, the media either spills out of the instance boundaries or does not fill the instance.
If you set this property to false, Flash uses the instance size as much as possible, while honoring the aspect ratio. If both Media.autoSize and Media.aspectRatio are set to false, the exact size of the component is used.

For the MediaPlayback component, the property behaves as follows:

If you set this property to true, Flash displays the media at its preferred size unless the media playback area is smaller than the preferred size. If this is the case, Flash shrinks the media to fit inside the instance and respect the aspect ratio. If the preferred size is smaller than the media area of the instance, part of the media area goes unused.
If you set this property to false, Flash uses the instance size as much as possible, while honoring the aspect ratio. If both Media.autoSize and Media.aspectRatio are set to false, the media area of the component is filled. This area is defined as the area above the controls (in the default layout), minus a surrounding 8-pixel margin that makes up the edges of the component.

The default value is true.

The following example indicates that the control is not played back according to its media size:

myMedia.autoSize = false;