Flash CS3 Documentation

ActionScript 2.0 Language Reference > ActionScript classes > TextField > _rotation (TextField._rotation property)

_rotation (TextField._rotation property)

The rotation of the text field, in degrees, from its original orientation. Values from 0 to 180 represent clockwise rotation; values from 0 to -180 represent counterclockwise rotation. Values outside this range are added to or subtracted from 360 to obtain a value within the range. For example, the statement my_txt._rotation = 450 is the same as my_txt._rotation = 90.

Rotation values are not supported for text fields that use device fonts. You must use embedded fonts to use _rotation with a text field.

Availability: ActionScript 1.0; Flash Player 6

Example

In this example, you need to create a dynamic text field called my_txt, and then use the following ActionScript to embed fonts and rotate the text field. The reference to my font refers to a Font symbol in the library, with linkage set to my font.

var my_fmt:TextFormat = new TextFormat();
my_fmt.font = "my font";

this.createTextField("my_txt", this.getNextHighestDepth(), 10, 10, 160, 120);
my_txt.wordWrap = true;
my_txt.embedFonts = true;
my_txt.text = "Hello world";
my_txt.setTextFormat(my_fmt);
my_txt._rotation = 45;

Apply additional formatting for the text field using the TextFormat class.

The MovieClip.getNextHighestDepth() method used in this example requires Flash Player 7 or later. If your SWF file includes a version 2 component, use the version 2 components' DepthManager class instead of the MovieClip.getNextHighestDepth() method.

See also

_rotation (Button._rotation property), _rotation (MovieClip._rotation property), TextFormat

Flash CS3