MACROMEDIA FLASH 8-ACTIONSCRIPT 2.0 LANGUAGE Reference page 1264

This method works correctly only with fonts that include character metric information; by
default, Flash does not include this information for static text fields. Therefore, text that is
selected might not appear to be selected onscreen. To ensure that all selected text appears to be
selected, you can force the Flash authoring tool to include the character metric information
for a font. To do this, in the library, include the font used by the static text field, and in
Linkage options for the font, select Export for ActionScript.
Availability: ActionScript 1.0; Flash Player 7 - The SWF file must be published for Flash
Player 6 or later, and must be played in Flash Player 7 or later.
Parameters
- The position of the first character to select. Valid values for are
start:Number start 0
through . If is a negative value, is used.
TextSnapshot.getCount() - 1 start 0
- An integer that is 1+ the index of the last character to be examined. Valid values
end:Number
for are through . The character indexed by the
end 0 TextSnapshot.getCount() end
parameter is not included in the extracted string. If you omit this parameter,
is used. If the value of is less than or equal to the value of
TextSnapshot.getCount() end
, is used.
start start + 1
- A Boolean value that specifies whether the text should be selected ( )
select:Boolean true
or not ( ).
false
Example
The following example illustrates how to use this method. To use this code, place a static text
field that contains the text "TextSnapshot Example" on the Stage. In the library, include the
font used by the static text field, and in Linkage options for the font, select Export for
ActionScript. Add the following ActionScript to Frame 1 of the Timssseline:
var my_snap:TextSnapshot = this.getTextSnapshot();
var count:Number = my_snap.getCount();
my_snap.setSelected(0, 4, true);
my_snap.setSelected(1, 2, false);
var theText:String = my_snap.getSelectedText(false);
trace(theText); // Text
See also
getCount (TextSnapshot.getCount method)
1264 ActionScript classes