Adobe Extending Flash Professional CS4 - Manual (Page 464)

442 EXTENDING FLASH CS4 PROFESSIONAL
Text object
Parameters
attrName A string that specifies the name of the TextAttrs object property to be returned. For a list of possible values
for attrName , see the Property summary for the TextAttrs object .
startIndex An integer that is the index of first character. This parameter is optional.
endIndex An integer that specifies the end of the range of text, which starts with startIndex and goes up to, but does
not include, endIndex. This parameter is optional.
Returns
The value of the attribute specified in the attrName parameter.
Description
Method; retrieves the attribute specified by the attrName parameter for the text identified by the optional startIndex
and endIndex parameters. If the attribute is not consistent for the specified range, Flash returns
undefined . If you omit
the optional parameters startIndex and endIndex, the method uses the entire text range. If you specify only startIndex,
the range used is a single character at that position. If you specify both startIndex and endIndex, the range starts from
startIndex and goes up to, but does not include, endIndex.
Example
The following example gets the font size of the currently selected text field and shows it:
var TheTextSize = fl.getDocumentDOM().selection[0].getTextAttr("size");
fl.trace(TheTextSize);
The following example gets the text fill color of the selected text field:
var TheFill = fl.getDocumentDOM().selection[0].getTextAttr("fillColor");
fl.trace(TheFill);
The following example gets the size of the third character:
var Char3 = fl.getDocumentDOM().selection[0].getTextAttr("size", 2);
fl.trace(Char3);
The following example gets the color of the selected text field from the third through the eighth character:
fl.getDocumentDOM().selection[0].getTextAttr("fillColor", 2, 8);
text.getTextString()
Availability
Flash MX 2004.
Usage
text.getTextString([startIndex [, endIndex]])
Parameters
startIndex An integer that specifies the index (zero-based) of the first character. This parameter is optional.
endIndex An integer that specifies the end of the range of text, which starts from startIndex and goes up to, but does
not include, endIndex. This parameter is optional.