| Package | flashx.textLayout.formats |
| Interface | public interface ITextLayoutFormat |
| Implementors | ContainerController, FlowElement, TextLayoutFormat |
| Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
| Property | Defined By | ||
|---|---|---|---|
| alignmentBaseline : * [read-only]
Specifies the baseline to which the dominant baseline aligns. | ITextLayoutFormat | ||
| backgroundAlpha : * [read-only]
Alpha (transparency) value for the background (adopts default value if undefined during cascade). | ITextLayoutFormat | ||
| backgroundColor : * [read-only]
Background color of the text (adopts default value if undefined during cascade). | ITextLayoutFormat | ||
| baselineShift : * [read-only]
Amount to shift the baseline from the dominantBaseline value. | ITextLayoutFormat | ||
| blockProgression : * [read-only]
Specifies a vertical or horizontal progression of line placement. | ITextLayoutFormat | ||
| breakOpportunity : * [read-only]
Controls where lines are allowed to break when breaking wrapping text into multiple lines. | ITextLayoutFormat | ||
| cffHinting : * [read-only]
The type of CFF hinting used for this text. | ITextLayoutFormat | ||
| clearFloats : * [read-only]
Controls how text wraps around a float. | ITextLayoutFormat | ||
| color : * [read-only]
Color of the text. | ITextLayoutFormat | ||
| columnCount : * [read-only]
Number of text columns (adopts default value if undefined during cascade). | ITextLayoutFormat | ||
| columnGap : * [read-only]
Specifies the amount of gutter space, in pixels, to leave between the columns (adopts default value if undefined during cascade). | ITextLayoutFormat | ||
| columnWidth : * [read-only]
Column width in pixels (adopts default value if undefined during cascade). | ITextLayoutFormat | ||
| digitCase : * [read-only]
The type of digit case used for this text. | ITextLayoutFormat | ||
| digitWidth : * [read-only]
Type of digit width used for this text. | ITextLayoutFormat | ||
| direction : * [read-only]
Specifies the default bidirectional embedding level of the text in the text block. | ITextLayoutFormat | ||
| dominantBaseline : * [read-only]
Specifies which element baseline snaps to the alignmentBaseline to determine the vertical position of the element on the line. | ITextLayoutFormat | ||
| firstBaselineOffset : * [read-only]
Specifies the baseline position of the first line in the container. | ITextLayoutFormat | ||
| fontFamily : * [read-only]
The name of the font to use, or a comma-separated list of font names. | ITextLayoutFormat | ||
| fontLookup : * [read-only]
Font lookup to use. | ITextLayoutFormat | ||
| fontSize : * [read-only]
The size of the text in pixels. | ITextLayoutFormat | ||
| fontStyle : * [read-only]
Style of text. | ITextLayoutFormat | ||
| fontWeight : * [read-only]
Weight of text. | ITextLayoutFormat | ||
| justificationRule : * [read-only]
Rule used to justify text in a paragraph. | ITextLayoutFormat | ||
| justificationStyle : * [read-only]
The style used for justification of the paragraph. | ITextLayoutFormat | ||
| kerning : * [read-only]
Kerning adjusts the pixels between certain character pairs to improve readability. | ITextLayoutFormat | ||
| leadingModel : * [read-only]
Specifies the leading model, which is a combination of leading basis and leading direction. | ITextLayoutFormat | ||
| ligatureLevel : * [read-only]
Controls which of the ligatures that are defined in the font may be used in the text. | ITextLayoutFormat | ||
| lineBreak : * [read-only]
Controls word wrapping within the container (adopts default value if undefined during cascade). | ITextLayoutFormat | ||
| lineHeight : * [read-only]
Leading controls for the text. | ITextLayoutFormat | ||
| lineThrough : * [read-only]
If true, applies strikethrough, a line drawn through the middle of the text. | ITextLayoutFormat | ||
| linkActiveFormat : * [read-only]
Defines the formatting attributes used for links in normal state. | ITextLayoutFormat | ||
| linkHoverFormat : * [read-only]
Defines the formatting attributes used for links in hover state, when the mouse is within the bounds (rolling over) a link. | ITextLayoutFormat | ||
| linkNormalFormat : * [read-only]
Defines the formatting attributes used for links in normal state. | ITextLayoutFormat | ||
| listAutoPadding : * [read-only]
This specifies an auto indent for the start edge of lists when the padding value of the list on that side is auto. | ITextLayoutFormat | ||
| listMarkerFormat : * [read-only]
Defines the formatting attributes list markers. | ITextLayoutFormat | ||
| listStylePosition : * [read-only]
Legal values are ListStylePosition.INSIDE, ListStylePosition.OUTSIDE, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. | ITextLayoutFormat | ||
| listStyleType : * [read-only]
Legal values are ListStyleType.UPPER_ALPHA, ListStyleType.LOWER_ALPHA, ListStyleType.UPPER_ROMAN, ListStyleType.LOWER_ROMAN, ListStyleType.NONE, ListStyleType.DISC, ListStyleType.CIRCLE, ListStyleType.SQUARE, ListStyleType.BOX, ListStyleType.CHECK, ListStyleType.DIAMOND, ListStyleType.HYPHEN, ListStyleType.ARABIC_INDIC, ListStyleType.BENGALI, ListStyleType.DECIMAL, ListStyleType.DECIMAL_LEADING_ZERO, ListStyleType.DEVANAGARI, ListStyleType.GUJARATI, ListStyleType.GURMUKHI, ListStyleType.KANNADA, ListStyleType.PERSIAN, ListStyleType.THAI, ListStyleType.URDU, ListStyleType.CJK_EARTHLY_BRANCH, ListStyleType.CJK_HEAVENLY_STEM, ListStyleType.HANGUL, ListStyleType.HANGUL_CONSTANT, ListStyleType.HIRAGANA, ListStyleType.HIRAGANA_IROHA, ListStyleType.KATAKANA, ListStyleType.KATAKANA_IROHA, ListStyleType.LOWER_ALPHA, ListStyleType.LOWER_GREEK, ListStyleType.LOWER_LATIN, ListStyleType.UPPER_ALPHA, ListStyleType.UPPER_GREEK, ListStyleType.UPPER_LATIN, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. | ITextLayoutFormat | ||
| locale : * [read-only]
The locale of the text. | ITextLayoutFormat | ||
| paddingBottom : * [read-only]
Bottom inset in pixels. | ITextLayoutFormat | ||
| paddingLeft : * [read-only]
Left inset in pixels. | ITextLayoutFormat | ||
| paddingRight : * [read-only]
Right inset in pixels. | ITextLayoutFormat | ||
| paddingTop : * [read-only]
Top inset in pixels. | ITextLayoutFormat | ||
| paragraphEndIndent : * [read-only]
A Number that specifies, in pixels, the amount to indent the paragraph's end edge. | ITextLayoutFormat | ||
| paragraphSpaceAfter : * [read-only]
A Number that specifies the amount of space, in pixels, to leave after the paragraph. | ITextLayoutFormat | ||
| paragraphSpaceBefore : * [read-only]
A Number that specifies the amount of space, in pixels, to leave before the paragraph. | ITextLayoutFormat | ||
| paragraphStartIndent : * [read-only]
A Number that specifies, in pixels, the amount to indent the paragraph's start edge. | ITextLayoutFormat | ||
| renderingMode : * [read-only]
The rendering mode used for this text. | ITextLayoutFormat | ||
| styleName : * [read-only]
Assigns an identifying class to the element, making it possible to set a style for the element by referencing the styleName. | ITextLayoutFormat | ||
| tabStops : * [read-only]
Specifies the tab stops associated with the paragraph. | ITextLayoutFormat | ||
| textAlign : * [read-only]
Alignment of lines in the paragraph relative to the container. | ITextLayoutFormat | ||
| textAlignLast : * [read-only]
Alignment of the last (or only) line in the paragraph relative to the container in justified text. | ITextLayoutFormat | ||
| textAlpha : * [read-only]
Alpha (transparency) value for the text. | ITextLayoutFormat | ||
| textDecoration : * [read-only]
Decoration on text. | ITextLayoutFormat | ||
| textIndent : * [read-only]
A Number that specifies, in pixels, the amount to indent the first line of the paragraph. | ITextLayoutFormat | ||
| textJustify : * [read-only]
Specifies options for justifying text. | ITextLayoutFormat | ||
| textRotation : * [read-only]
Determines the number of degrees to rotate this text. | ITextLayoutFormat | ||
| trackingLeft : * [read-only]
Number in pixels (or percent of fontSize, like 120%) indicating the amount of tracking (manual kerning) to be applied to the left of each character. | ITextLayoutFormat | ||
| trackingRight : * [read-only]
Number in pixels (or percent of fontSize, like 120%) indicating the amount of tracking (manual kerning) to be applied to the right of each character. | ITextLayoutFormat | ||
| typographicCase : * [read-only]
The type of typographic case used for this text. | ITextLayoutFormat | ||
| verticalAlign : * [read-only]
Vertical alignment or justification (adopts default value if undefined during cascade). | ITextLayoutFormat | ||
| whiteSpaceCollapse : * [read-only]
Collapses or preserves whitespace when importing text into a TextFlow. | ITextLayoutFormat | ||
| wordSpacing : * [read-only]
Specifies the optimum, minimum, and maximum spacing (as a multiplier of the width of a normal space) between words to use during justification. | ITextLayoutFormat | ||
| Method | Defined By | ||
|---|---|---|---|
Return the value of the style specified by the styleProp parameter
which specifies the style name. | ITextLayoutFormat | ||
alignmentBaseline | property |
alignmentBaseline:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Specifies the baseline to which the dominant baseline aligns. For example, if you set dominantBaseline to ASCENT, setting alignmentBaseline to DESCENT aligns the top of the text with the DESCENT baseline, or below the line. The largest element in the line generally determines the baselines.
Legal values are TextBaseline.ROMAN, TextBaseline.ASCENT, TextBaseline.DESCENT, TextBaseline.IDEOGRAPHIC_TOP, TextBaseline.IDEOGRAPHIC_CENTER, TextBaseline.IDEOGRAPHIC_BOTTOM, TextBaseline.USE_DOMINANT_BASELINE, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of TextBaseline.USE_DOMINANT_BASELINE.
Implementation
public function get alignmentBaseline():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
Example ( How to use this example )
alignmentBaseline to three different values -
USE_DOMINANT_BASELINE, DESCENT, and IDEOGRAPHIC_CENTER - for three spans in a paragraph
that has dominantBaseline set to ASCENT.
package flashx.textLayout.formats.examples {
import flash.display.Sprite;
import flash.text.engine.TextBaseline;
import flashx.textLayout.container.ContainerController;
import flashx.textLayout.elements.ParagraphElement;
import flashx.textLayout.elements.SpanElement;
import flashx.textLayout.elements.TextFlow;
import flashx.textLayout.formats.TextAlign;
public class TextLayoutFormat_alignmentBaselineExample extends Sprite
{
public function TextLayoutFormat_alignmentBaselineExample()
{
// create text flow with dominantBaseline of ASCENT and 3 spans
var textFlow:TextFlow = new TextFlow();
var paragraph:ParagraphElement = new ParagraphElement();
paragraph.fontFamily = "Helvetica";
paragraph.fontSize = 20;
paragraph.dominantBaseline = TextBaseline.ASCENT
var spanOne:SpanElement = new SpanElement();
var spanTwo:SpanElement = new SpanElement();
var spanThree:SpanElement = new SpanElement();
spanOne.text = "Hello, World ";
spanTwo.text = "Hello, World ";
spanThree.text = "Hello, World";
// add spans to paragraph and specify alignment baseline for each
paragraph.addChild(spanOne);
spanOne.alignmentBaseline = TextBaseline.USE_DOMINANT_BASELINE;
paragraph.addChild(spanTwo);
spanTwo.alignmentBaseline = TextBaseline.DESCENT;
paragraph.addChild(spanThree);
spanThree.alignmentBaseline = TextBaseline.IDEOGRAPHIC_CENTER;
// add paragraph to TextFlow and set container position
textFlow.addChild(paragraph);
this.x = 50;
this.y = 100;
// update controller to display on stage
textFlow.flowComposer.addController(new ContainerController(this,400,300));
textFlow.flowComposer.updateAllControllers();
}
}
}
backgroundAlpha | property |
backgroundAlpha:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Alpha (transparency) value for the background (adopts default value if undefined during cascade). A value of 0 is fully transparent, and a value of 1 is fully opaque. Display objects with alpha set to 0 are active, even though they are invisible.
Legal values are numbers from 0 to 1 and FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will have a value of 1.
Implementation
public function get backgroundAlpha():*Throws
RangeError — when set value is not within range for this property
|
backgroundColor | property |
backgroundColor:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Background color of the text (adopts default value if undefined during cascade). Can be either the constant value BackgroundColor.TRANSPARENT, or a hexadecimal value that specifies the three 8-bit RGB (red, green, blue) values; for example, 0xFF0000 is red and 0x00FF00 is green.
Legal values as a string are BackgroundColor.TRANSPARENT, FormatValue.INHERIT and uints from 0x0 to 0xffffffff.
Default value is undefined indicating not set.
If undefined during the cascade this property will have a value of BackgroundColor.TRANSPARENT.
Implementation
public function get backgroundColor():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
baselineShift | property |
baselineShift:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Amount to shift the baseline from the dominantBaseline value. Units are in pixels, or a percentage of fontSize (in which case, enter a string value, like 140%). Positive values shift the line up for horizontal text (right for vertical) and negative values shift it down for horizontal (left for vertical).
Legal values are BaselineShift.SUPERSCRIPT, BaselineShift.SUBSCRIPT, FormatValue.INHERIT.
Legal values as a number are from -1000 to 1000.
Legal values as a percent are numbers from -1000 to 1000.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of 0.0.
Implementation
public function get baselineShift():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
blockProgression | property |
blockProgression:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Specifies a vertical or horizontal progression of line placement.
Lines are either placed top-to-bottom (BlockProgression.TB, used for horizontal text) or right-to-left (BlockProgression.RL, used for vertical text).
Legal values are BlockProgression.RL, BlockProgression.TB, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of BlockProgression.TB.
Implementation
public function get blockProgression():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
breakOpportunity | property |
breakOpportunity:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Controls where lines are allowed to break when breaking wrapping text into multiple lines. Set to BreakOpportunity.AUTO to break text normally. Set to BreakOpportunity.NONE to not break the text unless the text would overrun the measure and there are no other places to break the line. Set to BreakOpportunity.ANY to allow the line to break anywhere, rather than just between words. Set to BreakOpportunity.ALL to have each typographic cluster put on a separate line (useful for text on a path).
Legal values are BreakOpportunity.ALL, BreakOpportunity.ANY, BreakOpportunity.AUTO, BreakOpportunity.NONE, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of BreakOpportunity.AUTO.
Implementation
public function get breakOpportunity():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
cffHinting | property |
cffHinting:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
The type of CFF hinting used for this text. CFF hinting determines whether the Flash runtime forces strong horizontal stems to fit to a sub pixel grid or not. This property applies only if the renderingMode property is set to RenderingMode.CFF, and the font is embedded (fontLookup property is set to FontLookup.EMBEDDED_CFF). At small screen sizes, hinting produces a clear, legible text for human readers.
Legal values are CFFHinting.NONE, CFFHinting.HORIZONTAL_STEM, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of CFFHinting.HORIZONTAL_STEM.
Implementation
public function get cffHinting():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
clearFloats | property |
clearFloats:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Controls how text wraps around a float. A value of none will allow the text to wrap most closely around a float. A value of left will cause the text to skip over any portion of the container that has a left float, and a value of right will cause the text to skip over any portion of the container that has a right float. A value of both will cause the text to skip over any floats.
Legal values are ClearFloats.START, ClearFloats.END, ClearFloats.LEFT, ClearFloats.RIGHT, ClearFloats.BOTH, ClearFloats.NONE, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will have a value of ClearFloats.NONE.
Implementation
public function get clearFloats():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
color | property |
color:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Color of the text. A hexadecimal number that specifies three 8-bit RGB (red, green, blue) values; for example, 0xFF0000 is red and 0x00FF00 is green.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of 0.
Implementation
public function get color():*Throws
RangeError — when set value is not within range for this property
|
columnCount | property |
columnCount:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Number of text columns (adopts default value if undefined during cascade).
The column number overrides the other column settings. Value is an integer, or FormatValue.AUTO if unspecified. If columnCount is not specified,columnWidth is used to create as many columns as can fit in the container.
Legal values as a string are FormatValue.AUTO, FormatValue.INHERIT and from ints from 1 to 50.
Default value is undefined indicating not set.
If undefined during the cascade this property will have a value of FormatValue.AUTO.
Implementation
public function get columnCount():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
columnGap | property |
columnGap:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Specifies the amount of gutter space, in pixels, to leave between the columns (adopts default value if undefined during cascade). Value is a Number
Legal values are numbers from 0 to 1000 and FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will have a value of 20.
Implementation
public function get columnGap():*Throws
RangeError — when set value is not within range for this property
|
columnWidth | property |
columnWidth:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Column width in pixels (adopts default value if undefined during cascade).
If you specify the width of the columns, but not the count, TextLayout will create as many columns of that width as possible, given the container width and columnGap settings. Any remainder space is left after the last column. Value is a Number.
Legal values as a string are FormatValue.AUTO, FormatValue.INHERIT and numbers from 0 to 8000.
Default value is undefined indicating not set.
If undefined during the cascade this property will have a value of FormatValue.AUTO.
Implementation
public function get columnWidth():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
digitCase | property |
digitCase:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
The type of digit case used for this text. Setting the value to DigitCase.OLD_STYLE approximates lowercase letterforms with varying ascenders and descenders. The figures are proportionally spaced. This style is only available in selected typefaces, most commonly in a supplemental or expert font. The DigitCase.LINING setting has all-cap height and is typically monospaced to line up in charts.
Legal values are DigitCase.DEFAULT, DigitCase.LINING, DigitCase.OLD_STYLE, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of DigitCase.DEFAULT.
Implementation
public function get digitCase():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
digitWidth | property |
digitWidth:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Type of digit width used for this text. This can be DigitWidth.PROPORTIONAL, which looks best for individual numbers, or DigitWidth.TABULAR, which works best for numbers in tables, charts, and vertical rows.
Legal values are DigitWidth.DEFAULT, DigitWidth.PROPORTIONAL, DigitWidth.TABULAR, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of DigitWidth.DEFAULT.
Implementation
public function get digitWidth():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
direction | property |
direction:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Specifies the default bidirectional embedding level of the text in the text block. Left-to-right reading order, as in Latin-style scripts, or right-to-left reading order, as in Arabic or Hebrew. This property also affects column direction when it is applied at the container level. Columns can be either left-to-right or right-to-left, just like text. Below are some examples:
Legal values are Direction.LTR, Direction.RTL, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of Direction.LTR.
Implementation
public function get direction():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
dominantBaseline | property |
dominantBaseline:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Specifies which element baseline snaps to the alignmentBaseline to determine the vertical position of the element on the line. A value of TextBaseline.AUTO selects the dominant baseline based on the locale property of the parent paragraph. For Japanese and Chinese, the selected baseline value is TextBaseline.IDEOGRAPHIC_CENTER; for all others it is TextBaseline.ROMAN. These baseline choices are determined by the choice of font and the font size.
Legal values are FormatValue.AUTO, TextBaseline.ROMAN, TextBaseline.ASCENT, TextBaseline.DESCENT, TextBaseline.IDEOGRAPHIC_TOP, TextBaseline.IDEOGRAPHIC_CENTER, TextBaseline.IDEOGRAPHIC_BOTTOM, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of FormatValue.AUTO.
Implementation
public function get dominantBaseline():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
firstBaselineOffset | property |
firstBaselineOffset:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Specifies the baseline position of the first line in the container. Which baseline this property refers to depends on the container-level locale. For Japanese and Chinese, it is TextBaseline.IDEOGRAPHIC_BOTTOM; for all others it is TextBaseline.ROMAN.
The offset from the top inset (or right inset if blockProgression is RL) of the container to the baseline of the first line can be either BaselineOffset.ASCENT, meaning equal to the ascent of the line, BaselineOffset.LINE_HEIGHT, meaning equal to the height of that first line, or any fixed-value number to specify an absolute distance. BaselineOffset.AUTO aligns the ascent of the line with the container top inset.
Legal values as a string are BaselineOffset.AUTO, BaselineOffset.ASCENT, BaselineOffset.LINE_HEIGHT, FormatValue.INHERIT and numbers from 0 to 1000.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of BaselineOffset.AUTO.
Implementation
public function get firstBaselineOffset():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
fontFamily | property |
fontFamily:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
The name of the font to use, or a comma-separated list of font names. The Flash runtime renders the element with the first available font in the list. For example Arial, Helvetica, _sans causes the player to search for Arial, then Helvetica if Arial is not found, then _sans if neither is found.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of Arial.
Implementation
public function get fontFamily():*Throws
RangeError — when set value is not within range for this property
|
fontLookup | property |
fontLookup:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Font lookup to use. Specifying FontLookup.DEVICE uses the fonts installed on the system that is running the SWF file. Device fonts result in a smaller movie size, but text is not always rendered the same across different systems and platforms. Specifying FontLookup.EMBEDDED_CFF uses font outlines embedded in the published SWF file. Embedded fonts increase the size of the SWF file (sometimes dramatically), but text is consistently displayed in the chosen font.
Legal values are FontLookup.DEVICE, FontLookup.EMBEDDED_CFF, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of FontLookup.DEVICE.
Implementation
public function get fontLookup():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
fontSize | property |
fontSize:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
The size of the text in pixels.
Legal values are numbers from 1 to 720 and FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of 12.
Implementation
public function get fontSize():*Throws
RangeError — when set value is not within range for this property
|
fontStyle | property |
fontStyle:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Style of text. May be FontPosture.NORMAL, for use in plain text, or FontPosture.ITALIC for italic. This property applies only to device fonts (fontLookup property is set to flash.text.engine.FontLookup.DEVICE).
Legal values are FontPosture.NORMAL, FontPosture.ITALIC, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of FontPosture.NORMAL.
Implementation
public function get fontStyle():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
fontWeight | property |
fontWeight:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Weight of text. May be FontWeight.NORMAL for use in plain text, or FontWeight.BOLD. Applies only to device fonts (fontLookup property is set to flash.text.engine.FontLookup.DEVICE).
Legal values are FontWeight.NORMAL, FontWeight.BOLD, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of FontWeight.NORMAL.
Implementation
public function get fontWeight():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
justificationRule | property |
justificationRule:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Rule used to justify text in a paragraph.
Default value is FormatValue.AUTO, which justifies text based on the paragraph's locale property. For all languages except Japanese and Chinese, FormatValue.AUTO becomes JustificationRule.SPACE, which adds extra space to the space characters. For Japanese and Chinese, FormatValue.AUTO becomes JustficationRule.EAST_ASIAN. In part, justification changes the spacing of punctuation. In Roman text the comma and Japanese periods take a full character's width but in East Asian text only half of a character's width. Also, in the East Asian text the spacing between sequential punctuation marks becomes tighter, obeying traditional East Asian typographic conventions. Note, too, in the example below the leading that is applied to the second line of the paragraphs. In the East Asian version, the last two lines push left. In the Roman version, the second and following lines push left.
Legal values are JustificationRule.EAST_ASIAN, JustificationRule.SPACE, FormatValue.AUTO, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of FormatValue.AUTO.
Implementation
public function get justificationRule():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
justificationStyle | property |
justificationStyle:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
The style used for justification of the paragraph. Used only in conjunction with a justificationRule setting of JustificationRule.EAST_ASIAN.
Default value of FormatValue.AUTO is resolved to JustificationStyle.PUSH_IN_KINSOKU for all locales. The constants defined by the JustificationStyle class specify options for handling kinsoku characters, which are Japanese characters that cannot appear at either the beginning or end of a line. If you want looser text, specify JustificationStyle.PUSH-OUT-ONLY. If you want behavior that is like what you get with the justificationRule of JustificationRule.SPACE, use JustificationStyle.PRIORITIZE-LEAST-ADJUSTMENT.
Legal values are JustificationStyle.PRIORITIZE_LEAST_ADJUSTMENT, JustificationStyle.PUSH_IN_KINSOKU, JustificationStyle.PUSH_OUT_ONLY, FormatValue.AUTO, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of FormatValue.AUTO.
Implementation
public function get justificationStyle():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
kerning | property |
kerning:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Kerning adjusts the pixels between certain character pairs to improve readability. Kerning is supported for all fonts with kerning tables.
Legal values are Kerning.ON, Kerning.OFF, Kerning.AUTO, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of Kerning.AUTO.
Implementation
public function get kerning():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
leadingModel | property |
leadingModel:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Specifies the leading model, which is a combination of leading basis and leading direction.
Leading basis is the baseline to which the lineHeight property refers. Leading direction determines whether the lineHeight property refers to the distance of a line's baseline from that of the line before it or the line after it. The default value of FormatValue.AUTO is resolved based on the paragraph's locale property. For Japanese and Chinese, it is LeadingModel.IDEOGRAPHIC_TOP_DOWN and for all others it is LeadingModel.ROMAN_UP.
Leading Basis:
Leading Direction:
Legal values are LeadingModel.ROMAN_UP, LeadingModel.IDEOGRAPHIC_TOP_UP, LeadingModel.IDEOGRAPHIC_CENTER_UP, LeadingModel.IDEOGRAPHIC_TOP_DOWN, LeadingModel.IDEOGRAPHIC_CENTER_DOWN, LeadingModel.APPROXIMATE_TEXT_FIELD, LeadingModel.ASCENT_DESCENT_UP, LeadingModel.BOX, LeadingModel.AUTO, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of LeadingModel.AUTO.
Implementation
public function get leadingModel():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
ligatureLevel | property |
ligatureLevel:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Controls which of the ligatures that are defined in the font may be used in the text. The ligatures that appear for each of these settings is dependent on the font. A ligature occurs where two or more letter-forms are joined as a single glyph. Ligatures usually replace consecutive characters sharing common components, such as the letter pairs 'fi', 'fl', or 'ae'. They are used with both Latin and Non-Latin character sets. The ligatures enabled by the values of the LigatureLevel class - MINIMUM, COMMON, UNCOMMON, and EXOTIC - are additive. Each value enables a new set of ligatures, but also includes those of the previous types.
Note: When working with Arabic or Syriac fonts, ligatureLevel must be set to MINIMUM or above.
Legal values are LigatureLevel.MINIMUM, LigatureLevel.COMMON, LigatureLevel.UNCOMMON, LigatureLevel.EXOTIC, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of LigatureLevel.COMMON.
Implementation
public function get ligatureLevel():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
lineBreak | property |
lineBreak:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Controls word wrapping within the container (adopts default value if undefined during cascade).
Text in the container may be set to fit the width of the container (LineBreak.TO_FIT), or can be set to break only at explicit return or line feed characters (LineBreak.EXPLICIT).
Legal values are LineBreak.EXPLICIT, LineBreak.TO_FIT, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will have a value of LineBreak.TO_FIT.
Implementation
public function get lineBreak():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
lineHeight | property |
lineHeight:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Leading controls for the text. The distance from the baseline of the previous or the next line (based on LeadingModel) to the baseline of the current line is equal to the maximum amount of the leading applied to any character in the line. This is either a number or a percent. If specifying a percent, enter a string value, like 140%.
Legal values as a number are from -720 to 720.
Legal values as a percent are numbers from -1000% to 1000%.
Legal values include FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of 120%.
Implementation
public function get lineHeight():*Throws
RangeError — when set value is not within range for this property
|
lineThrough | property |
lineThrough:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
If true, applies strikethrough, a line drawn through the middle of the text.
Legal values are true, false and FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of false.
Implementation
public function get lineThrough():*Throws
RangeError — when set value is not within range for this property
|
linkActiveFormat | property |
linkActiveFormat:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Defines the formatting attributes used for links in normal state. This value will cascade down the hierarchy and apply to any links that are descendants.
Accepts inherit, an ITextLayoutFormat or converts an array of objects with key and value as members to a TextLayoutFormat.
Legal values include FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of null.
Implementation
public function get linkActiveFormat():*Throws
RangeError — when set value is not within range for this property
|
linkHoverFormat | property |
linkHoverFormat:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Defines the formatting attributes used for links in hover state, when the mouse is within the bounds (rolling over) a link. This value will cascade down the hierarchy and apply to any links that are descendants.
Accepts inherit, an ITextLayoutFormat or converts an array of objects with key and value as members to a TextLayoutFormat.
Legal values include FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of null.
Implementation
public function get linkHoverFormat():*Throws
RangeError — when set value is not within range for this property
|
linkNormalFormat | property |
linkNormalFormat:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Defines the formatting attributes used for links in normal state. This value will cascade down the hierarchy and apply to any links that are descendants.
Accepts inherit, an ITextLayoutFormat or converts an array of objects with key and value as members to a TextLayoutFormat.
Legal values include FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of null.
Implementation
public function get linkNormalFormat():*Throws
RangeError — when set value is not within range for this property
|
listAutoPadding | property |
listAutoPadding:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
This specifies an auto indent for the start edge of lists when the padding value of the list on that side is auto.
Legal values are numbers from -1000 to 1000 and FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of 40.
Implementation
public function get listAutoPadding():*Throws
RangeError — when set value is not within range for this property
|
listMarkerFormat | property |
listMarkerFormat:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Defines the formatting attributes list markers. This value will cascade down the hierarchy and apply to any links that are descendants.
Accepts inherit, an IListMarkerFormat or converts an array of objects with key and value as members to a ListMarkerFormat.
Legal values include FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of null.
Implementation
public function get listMarkerFormat():*Throws
RangeError — when set value is not within range for this property
|
listStylePosition | property |
listStylePosition:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Legal values are ListStylePosition.INSIDE, ListStylePosition.OUTSIDE, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of ListStylePosition.OUTSIDE.
Implementation
public function get listStylePosition():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
listStyleType | property |
listStyleType:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Legal values are ListStyleType.UPPER_ALPHA, ListStyleType.LOWER_ALPHA, ListStyleType.UPPER_ROMAN, ListStyleType.LOWER_ROMAN, ListStyleType.NONE, ListStyleType.DISC, ListStyleType.CIRCLE, ListStyleType.SQUARE, ListStyleType.BOX, ListStyleType.CHECK, ListStyleType.DIAMOND, ListStyleType.HYPHEN, ListStyleType.ARABIC_INDIC, ListStyleType.BENGALI, ListStyleType.DECIMAL, ListStyleType.DECIMAL_LEADING_ZERO, ListStyleType.DEVANAGARI, ListStyleType.GUJARATI, ListStyleType.GURMUKHI, ListStyleType.KANNADA, ListStyleType.PERSIAN, ListStyleType.THAI, ListStyleType.URDU, ListStyleType.CJK_EARTHLY_BRANCH, ListStyleType.CJK_HEAVENLY_STEM, ListStyleType.HANGUL, ListStyleType.HANGUL_CONSTANT, ListStyleType.HIRAGANA, ListStyleType.HIRAGANA_IROHA, ListStyleType.KATAKANA, ListStyleType.KATAKANA_IROHA, ListStyleType.LOWER_ALPHA, ListStyleType.LOWER_GREEK, ListStyleType.LOWER_LATIN, ListStyleType.UPPER_ALPHA, ListStyleType.UPPER_GREEK, ListStyleType.UPPER_LATIN, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of ListStyleType.DISC.
Implementation
public function get listStyleType():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
locale | property |
locale:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
The locale of the text. Controls case transformations and shaping. Standard locale identifiers as described in Unicode Technical Standard #35 are used. For example en, en_US and en-US are all English, ja is Japanese.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of en.
Implementation
public function get locale():*Throws
RangeError — when set value is not within range for this property
|
paddingBottom | property |
paddingBottom:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Bottom inset in pixels. Default of auto is zero except in lists which get a start side padding of 45. (adopts default value if undefined during cascade). Space between the bottom edge of the container and the text. Value is a Number or auto.
With horizontal text, in scrollable containers with multiple columns, the first and following columns will show the padding as blank space at the bottom of the container, but for the last column, if the text doesn't all fit, you may have to scroll in order to see the padding.
Legal values as a string are FormatValue.AUTO, FormatValue.INHERIT and numbers from -8000 to 8000.
Default value is undefined indicating not set.
If undefined during the cascade this property will have a value of FormatValue.AUTO.
Implementation
public function get paddingBottom():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
paddingLeft | property |
paddingLeft:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Left inset in pixels. Default of auto is zero except in lists which get a start side padding of 45. (adopts default value if undefined during cascade). Space between the left edge of the container and the text. Value is a Number or auto.
With vertical text, in scrollable containers with multiple columns, the first and following columns will show the padding as blank space at the end of the container, but for the last column, if the text doesn't all fit, you may have to scroll in order to see the padding.
Legal values as a string are FormatValue.AUTO, FormatValue.INHERIT and numbers from -8000 to 8000.
Default value is undefined indicating not set.
If undefined during the cascade this property will have a value of FormatValue.AUTO.
Implementation
public function get paddingLeft():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
paddingRight | property |
paddingRight:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Right inset in pixels. Default of auto is zero except in lists which get a start side padding of 45. (adopts default value if undefined during cascade). Space between the right edge of the container and the text. Value is a Number or auto.
Legal values as a string are FormatValue.AUTO, FormatValue.INHERIT and numbers from -8000 to 8000.
Default value is undefined indicating not set.
If undefined during the cascade this property will have a value of FormatValue.AUTO.
Implementation
public function get paddingRight():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
paddingTop | property |
paddingTop:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Top inset in pixels. Default of auto is zero except in lists which get a start side padding of 45. (adopts default value if undefined during cascade). Space between the top edge of the container and the text. Value is a Number or auto.
Legal values as a string are FormatValue.AUTO, FormatValue.INHERIT and numbers from -8000 to 8000.
Default value is undefined indicating not set.
If undefined during the cascade this property will have a value of FormatValue.AUTO.
Implementation
public function get paddingTop():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
paragraphEndIndent | property |
paragraphEndIndent:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
A Number that specifies, in pixels, the amount to indent the paragraph's end edge. Refers to the right edge in left-to-right text and the left edge in right-to-left text.
Legal values are numbers from 0 to 8000 and FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of 0.
Implementation
public function get paragraphEndIndent():*Throws
RangeError — when set value is not within range for this property
|
paragraphSpaceAfter | property |
paragraphSpaceAfter:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
A Number that specifies the amount of space, in pixels, to leave after the paragraph.
Collapses in tandem with paragraphSpaceBefore.
Legal values are numbers from 0 to 8000 and FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of 0.
Implementation
public function get paragraphSpaceAfter():*Throws
RangeError — when set value is not within range for this property
|
paragraphSpaceBefore | property |
paragraphSpaceBefore:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
A Number that specifies the amount of space, in pixels, to leave before the paragraph.
Collapses in tandem with paragraphSpaceAfter.
Legal values are numbers from 0 to 8000 and FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of 0.
Implementation
public function get paragraphSpaceBefore():*Throws
RangeError — when set value is not within range for this property
|
paragraphStartIndent | property |
paragraphStartIndent:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
A Number that specifies, in pixels, the amount to indent the paragraph's start edge. Refers to the left edge in left-to-right text and the right edge in right-to-left text.
Legal values are numbers from 0 to 8000 and FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of 0.
Implementation
public function get paragraphStartIndent():*Throws
RangeError — when set value is not within range for this property
|
renderingMode | property |
renderingMode:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
The rendering mode used for this text. Applies only to embedded fonts (fontLookup property is set to FontLookup.EMBEDDED_CFF).
Legal values are RenderingMode.NORMAL, RenderingMode.CFF, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of RenderingMode.CFF.
Implementation
public function get renderingMode():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
styleName | property |
styleName:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Assigns an identifying class to the element, making it possible to set a style for the element by referencing the styleName.
Default value is undefined indicating not set.
If undefined during the cascade this property will have a value of null.
Implementation
public function get styleName():*Throws
RangeError — when set value is not within range for this property
|
tabStops | property |
tabStops:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Specifies the tab stops associated with the paragraph.
Setters can take an array of TabStopFormat, a condensed string representation, undefined, or FormatValue.INHERIT.
The condensed string representation is always converted into an array of TabStopFormat.
The string-based format is a list of tab stops, where each tab stop is delimited by one or more spaces.
A tab stop takes the following form: <alignment type><alignment position>|<alignment token>.
The alignment type is a single character, and can be S, E, C, or D (or lower-case equivalents). S or s for start, E or e for end, C or c for center, D or d for decimal. The alignment type is optional, and if its not specified will default to S.
The alignment position is a Number, and is specified according to FXG spec for Numbers (decimal or scientific notation). The alignment position is required.
The vertical bar is used to separate the alignment position from the alignment token, and should only be present if the alignment token is present.
The alignment token is optional if the alignment type is D, and should not be present if the alignment type is anything other than D.
The alignment token may be any sequence of characters terminated by the space that ends the tab stop (for the last tab stop, the terminating space is optional; end of alignment token is implied).
A space may be part of the alignment token if it is escaped with a backslash (\ ). A backslash may be part of the alignment token if it is escaped with another backslash (\\).
If the alignment type is D, and the alignment token is not specified, it will take on the default value of null.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of null.
Implementation
public function get tabStops():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
textAlign | property |
textAlign:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Alignment of lines in the paragraph relative to the container.
TextAlign.LEFT aligns lines along the left edge of the container. TextAlign.RIGHT aligns on the right edge. TextAlign.CENTER positions the line equidistant from the left and right edges. TextAlign.JUSTIFY spreads the lines out so they fill the space. TextAlign.START is equivalent to setting left in left-to-right text, or right in right-to-left text. TextAlign.END is equivalent to setting right in left-to-right text, or left in right-to-left text.
Legal values are TextAlign.LEFT, TextAlign.RIGHT, TextAlign.CENTER, TextAlign.JUSTIFY, TextAlign.START, TextAlign.END, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of TextAlign.START.
Implementation
public function get textAlign():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
textAlignLast | property |
textAlignLast:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Alignment of the last (or only) line in the paragraph relative to the container in justified text.
If textAlign is set to TextAlign.JUSTIFY, textAlignLast specifies how the last line (or only line, if this is a one line block) is aligned. Values are similar to textAlign.
Legal values are TextAlign.LEFT, TextAlign.RIGHT, TextAlign.CENTER, TextAlign.JUSTIFY, TextAlign.START, TextAlign.END, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of TextAlign.START.
Implementation
public function get textAlignLast():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
textAlpha | property |
textAlpha:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Alpha (transparency) value for the text. A value of 0 is fully transparent, and a value of 1 is fully opaque. Display objects with textAlpha set to 0 are active, even though they are invisible.
Legal values are numbers from 0 to 1 and FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of 1.
Implementation
public function get textAlpha():*Throws
RangeError — when set value is not within range for this property
|
textDecoration | property |
textDecoration:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Decoration on text. Use to apply underlining; default is none.
Legal values are TextDecoration.NONE, TextDecoration.UNDERLINE, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of TextDecoration.NONE.
Implementation
public function get textDecoration():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
textIndent | property |
textIndent:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
A Number that specifies, in pixels, the amount to indent the first line of the paragraph. A negative indent will push the line into the margin, and possibly out of the container.
Legal values are numbers from -8000 to 8000 and FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of 0.
Implementation
public function get textIndent():*Throws
RangeError — when set value is not within range for this property
|
textJustify | property |
textJustify:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Specifies options for justifying text.
Default value is TextJustify.INTER_WORD, meaning that extra space is added to the space characters. TextJustify.DISTRIBUTE adds extra space to space characters and between individual letters. Used only in conjunction with a justificationRule value of JustificationRule.SPACE.
Legal values are TextJustify.INTER_WORD, TextJustify.DISTRIBUTE, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of TextJustify.INTER_WORD.
Implementation
public function get textJustify():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
textRotation | property |
textRotation:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Determines the number of degrees to rotate this text.
Legal values are TextRotation.ROTATE_0, TextRotation.ROTATE_180, TextRotation.ROTATE_270, TextRotation.ROTATE_90, TextRotation.AUTO, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of TextRotation.AUTO.
Implementation
public function get textRotation():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
trackingLeft | property |
trackingLeft:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Number in pixels (or percent of fontSize, like 120%) indicating the amount of tracking (manual kerning) to be applied to the left of each character. If kerning is enabled, the trackingLeft value is added to the values in the kerning table for the font. If kerning is disabled, the trackingLeft value is used as a manual kerning value. Supports both positive and negative values.
Legal values as a number are from -1000 to 1000.
Legal values as a percent are numbers from -1000% to 1000%.
Legal values include FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of 0.
Implementation
public function get trackingLeft():*Throws
RangeError — when set value is not within range for this property
|
trackingRight | property |
trackingRight:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Number in pixels (or percent of fontSize, like 120%) indicating the amount of tracking (manual kerning) to be applied to the right of each character. If kerning is enabled, the trackingRight value is added to the values in the kerning table for the font. If kerning is disabled, the trackingRight value is used as a manual kerning value. Supports both positive and negative values.
Legal values as a number are from -1000 to 1000.
Legal values as a percent are numbers from -1000% to 1000%.
Legal values include FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of 0.
Implementation
public function get trackingRight():*Throws
RangeError — when set value is not within range for this property
|
typographicCase | property |
typographicCase:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
The type of typographic case used for this text. Here are some examples:
Legal values are TLFTypographicCase.DEFAULT, TLFTypographicCase.CAPS_TO_SMALL_CAPS, TLFTypographicCase.UPPERCASE, TLFTypographicCase.LOWERCASE, TLFTypographicCase.LOWERCASE_TO_SMALL_CAPS, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of TLFTypographicCase.DEFAULT.
Implementation
public function get typographicCase():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
verticalAlign | property |
verticalAlign:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Vertical alignment or justification (adopts default value if undefined during cascade). Determines how TextFlow elements align within the container.
Legal values are VerticalAlign.TOP, VerticalAlign.MIDDLE, VerticalAlign.BOTTOM, VerticalAlign.JUSTIFY, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will have a value of VerticalAlign.TOP.
Implementation
public function get verticalAlign():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
whiteSpaceCollapse | property |
whiteSpaceCollapse:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Collapses or preserves whitespace when importing text into a TextFlow. WhiteSpaceCollapse.PRESERVE retains all whitespace characters. WhiteSpaceCollapse.COLLAPSE removes newlines, tabs, and leading or trailing spaces within a block of imported text. Line break tags () and Unicode line separator characters are retained.
Legal values are WhiteSpaceCollapse.PRESERVE, WhiteSpaceCollapse.COLLAPSE, FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of WhiteSpaceCollapse.COLLAPSE.
Implementation
public function get whiteSpaceCollapse():*Throws
RangeError — when set value is not within range for this property
|
Related API Elements
wordSpacing | property |
wordSpacing:* [read-only] | Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Specifies the optimum, minimum, and maximum spacing (as a multiplier of the width of a normal space) between words to use during justification. The optimum space is used to indicate the desired size of a space, as a fraction of the value defined in the font. The minimum and maximum values are the used when textJustify is distribute to determine how wide or narrow the spaces between the words may grow before letter spacing is used to justify the line.
Legal values as a percent are numbers from -1000% to 1000%.
Legal values include FormatValue.INHERIT.
Default value is undefined indicating not set.
If undefined during the cascade this property will inherit its value from an ancestor. If no ancestor has set this property, it will have a value of 100%, 50%, 150%.
Implementation
public function get wordSpacing():*Throws
RangeError — when set value is not within range for this property
|
getStyle | () | method |
public function getStyle(styleName:String):*| Language Version: | ActionScript 3.0 |
| Runtime Versions: | Flash Player 10, AIR 1.5 |
Return the value of the style specified by the styleProp parameter
which specifies the style name.
Parameters
styleName:String — The name of the style whose value is to be retrieved.
|
* — The value of the specified style. The type varies depending on the type of the style being
accessed. Returns undefined if the style is not set.
|
Mon Nov 28 2011, 06:48 AM -08:00