Flash CS3 Documentation

Learning ActionScript 2.0 in Adobe Flash > Working with Text and Strings > Using HTML-formatted text > About supported HTML tags > Image tag

Image tag

The <img> tag lets you embed external image files (JPEG, GIF, PNG), SWF files, and movie clips inside text fields and TextArea component instances. Text automatically flows around images you embed in text fields or components. To use this tag, you must set your dynamic or input text field to be multiline and to wrap text.

To create a multiline text field with word wrapping, do one of the following:

• In the Flash authoring environment, select a text field on the Stage and then, in the Property inspector, select Multiline from the Text Type menu.
• For a text field created at runtime with createTextField (MovieClip.createTextField method), set the new text field instance's multiline (TextField.multiline property) and multiline (TextField.multiline property) properties to true.

The <img> tag has one required attribute, src, which specifies the path to an image file, a SWF file, or the linkage identifier of a movie clip symbol in the library. All other attributes are optional.

The <img> tag supports the following attributes:

• src  Specifies the URL to an image or SWF file, or the linkage identifier for a movie clip symbol in the library. This attribute is required; all other attributes are optional. External files (JPEG, GIF, PNG, and SWF files) do not show until they are downloaded completely.
• id Specifies the name for the movie clip instance (created by Flash Player) that contains the embedded image file, SWF file, or movie clip. This is useful if you want to control the embedded content with ActionScript.
• width The width of the image, SWF file, or movie clip being inserted, in pixels.
• height The height of the image, SWF file, or movie clip being inserted, in pixels.
• align Specifies the horizontal alignment of the embedded image within the text field. Valid values are left and right. The default value is left.
• hspace Specifies the amount of horizontal space that surrounds the image where no text appears. The default value is 8.
• vspace Specifies the amount of vertical space that surrounds the image where no text appears. The default value is 8. 

For more information and examples of using the <img> tag, see About embedding images, SWF files, and movie clips in text fields.

Flash CS3