User Guide

964 Chapter 2: ActionScript Language Reference
TextSnapshot object
Availability
Authoring: Flash MX 2004.
Playback: SWF files published for Flash Player 6 or later, playing in Flash Player 7 or later.
Description
TextSnapshot objects let you work with static text in a movie clip. You can use them, for example,
to lay out text with greater precision than that allowed by dynamic text, but still access the text in
a read-only way.
You don’t use a constructor to create a TextSnapshot object; it is returned by
MovieClip.getTextSnapshot().
Method summary for the TextSnapshot object
Method Description
TextSnapshot.findText()
Returns the position of the first occurrence of specified text.
TextSnapshot.getCount()
Returns the number of characters.
TextSnapshot.getSelected()
Specifies whether any of the text in the specified range has
been selected by TextSnapshot.setSelected().
TextSnapshot.getSelectedText()
Returns a string that contains all the characters specified by
TextSnapshot.setSelected().
TextSnapshot.getText()
Returns a string containing the characters in the specified
range.
TextSnapshot.hitTestTextNearPos()
Lets you determine which character within the object is on or
near specified coordinates.
TextSnapshot.setSelectColor()
Specifies the color to use when highlighting characters that
have been selected with the TextSnapshot.setSelected()
command.
TextSnapshot.setSelected()
Specifies a range of characters to be selected or deselected.
CHAPTER 2
ActionScript Language Reference