User Guide

856 Media components (Flash Professional only)
Media.autoSize
Applies to
MediaDisplay, MediaPlayback.
Availability
Flash Player 7.
Edition
Flash MX Professional 2004.
Usage
myMedia.autoSize
Description
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.