Packagespark.utils
Classpublic class TextFlowUtil
InheritanceTextFlowUtil Inheritance Object

Language Version : ActionScript 3.0
Product Version : Flex 4
Runtime Versions : Flash Player 10, AIR 1.5

TextFlowUtil is a utility class which provides methods for importing a TextFlow from, and exporting a TextFlow to, the markup language used by the Text Layout Framework.



Public Methods
 MethodDefined By
  
export(textFlow:TextFlow):XML
[static] Exports a TextFlow into the markup language used by the Text Layout Framework, in the form of XML.
TextFlowUtil
  
importFromString(markup:String, whiteSpaceCollapse:String = collapse):TextFlow
[static] Creates a TextFlow by importing (i.e., parsing) a String containing the markup language used by the Text Layout Framework.
TextFlowUtil
  
importFromXML(markup:XML, whiteSpaceCollapse:String = collapse):TextFlow
[static] Creates a TextFlow by importing (parsing) XML that contains the markup language used by the Text Layout Framework.
TextFlowUtil
Method Detail
export()method
public static function export(textFlow:TextFlow):XML

Language Version : ActionScript 3.0
Product Version : Flex 4
Runtime Versions : Flash Player 10, AIR 1.5

Exports a TextFlow into the markup language used by the Text Layout Framework, in the form of XML.

The root tag of the exported XML will be

      <TextFlow xmlns="http://ns.adobe.com/textLayout/2008" ...>
      

Parameters

textFlow:TextFlow — The TextFlow to be exported in Text Layout Framework markup language.

Returns
XML — XML containing Text Layout Framework markup language.
importFromString()method 
public static function importFromString(markup:String, whiteSpaceCollapse:String = collapse):TextFlow

Language Version : ActionScript 3.0
Product Version : Flex 4
Runtime Versions : Flash Player 10, AIR 1.5

Creates a TextFlow by importing (i.e., parsing) a String containing the markup language used by the Text Layout Framework.

An example of a markup string is

      "<TextFlow xmlns='http://ns.adobe.com/textLayout/2008'>
      

Hello, World!

</TextFlow>"

However, you can use terser markup such as

"Hello, World!"
. It will get wrapped with a TextFlow tag in the proper namespace, and span and paragraph tags will get automatically inserted where needed to comply with the structure of a TextFlow.

If you specify the TextFlow tag yourself, it must be in the correct XML namespace for runtime Text Layout Framework markup, which is "http://ns.adobe.com/textLayout/2008".

Incorrect markup will cause this method to throw various exceptions. The error message will contain information about why it could not be parsed.

Parameters

markup:String — The markup String to be imported.
 
whiteSpaceCollapse:String (default = collapse) — A String indicating whether the whitespace in the markup should be collapsed or preserved. The possible values are WhiteSpaceCollapse.COLLAPSE and WhiteSpaceCollapse.PRESERVE in the flashx.textLayout.formats.WhiteSpaceCollapse class. The default value is WhiteSpaceCollapse.COLLAPSE.

Returns
TextFlow — A new TextFlow instance created from the markup.
importFromXML()method 
public static function importFromXML(markup:XML, whiteSpaceCollapse:String = collapse):TextFlow

Language Version : ActionScript 3.0
Product Version : Flex 4
Runtime Versions : Flash Player 10, AIR 1.5

Creates a TextFlow by importing (parsing) XML that contains the markup language used by the Text Layout Framework.

An example of markup XML is

      <TextFlow xmlns='http://ns.adobe.com/textLayout/2008'>
        

Hello, World!

</TextFlow>

You can also use terser markup such as the following:

      "Hello, <span fontWeight='bold'>World!</span>"
      
The parser wraps the markup with a <TextFlow> tag in the proper namespace. The parser also inserts <span> and <paragraph> tags where needed to comply with the structure of a TextFlow object.

If you specify the TextFlow tag yourself, it must be in the correct XML namespace for runtime Text Layout Framework markup, which is "http://ns.adobe.com/textLayout/2008".

Incorrect markup causes this method to throw various exceptions. The error message contains information about why it could not be parsed.

Parameters

markup:XML — The markup XML to be imported.
 
whiteSpaceCollapse:String (default = collapse) — A String indicating whether the whitespace in the markup should be collapsed or preserved. The possible values are WhiteSpaceCollapse.COLLAPSE and WhiteSpaceCollapse.PRESERVE in the flashx.textLayout.formats.WhiteSpaceCollapse class. The default value is WhiteSpaceCollapse.COLLAPSE.

Returns
TextFlow — A new TextFlow instance created from the markup.