Package | flash.text.engine |
Class | public final class TabStop |
Inheritance | TabStop Object |
Language version: | ActionScript 3.0 |
Runtime version: | AIR 1.5 |
TextBlock.tabStops
property.
Setting the properties of a TabStop object after you apply it to a TextBlock does not invalidate the TextBlock.
See also
Property | Defined by | ||
---|---|---|---|
alignment : String
Specifies the tab alignment for this tab stop.
| TabStop | ||
constructor : Object
A reference to the class object or constructor function for a given object instance.
| Object | ||
decimalAlignmentToken : String
Specifies the alignment token to use when you set the
alignment property to TabAlignment.DECIMAL . | TabStop | ||
position : Number
The position of the tab stop, in pixels, relative to the start of the text line.
| TabStop | ||
prototype : Object
[static]
A reference to the prototype object of a class or function object.
| Object |
Method | Defined by | ||
---|---|---|---|
Creates a new TabStop.
| TabStop | ||
Indicates whether an object has a specified property defined.
| Object | ||
Indicates whether an instance of the Object class is in the prototype chain of the object specified
as the parameter.
| Object | ||
Indicates whether the specified property exists and is enumerable.
| Object | ||
Sets the availability of a dynamic property for loop operations.
| Object | ||
Returns the string representation of this object, formatted according to locale-specific conventions.
| Object | ||
Returns the string representation of the specified object.
| Object | ||
Returns the primitive value of the specified object.
| Object |
alignment | property |
alignment:String
[read-write]
Language version: | ActionScript 3.0 |
Runtime version: | AIR 1.5 |
Specifies the tab alignment for this tab stop. Use the constants in the TabAlignment class to set this property.
The default value is TabAlignment.START
.
Use the lineOffset
argument to TextBlock.createTextLine()
to adjust the tabs if the origin of the line does not align with other lines that
share the same tab stops.
Use the following constants from the TabAlignment class to set the value for this property:
String value | Description |
---|---|
TabAlignment.START |
The position property specifies the number of pixels that the start of the tabbed text is from the start of the text line. |
TabAlignment.CENTER |
The position property specifies the number of pixels that the center of the tabbed text is from the start of the text line. |
TabAlignment.END |
The position property specifies the number of pixels that the end of the tabbed text is from the start of the text line. |
TabAlignment.DECIMAL |
The position property specifies the number of pixels that the alignment token is from the start of the text line. |
public function get alignment():String
public function set alignment(value:String):void
ArgumentError — If set to any value that is not a member of TabAlignment .
|
See also
decimalAlignmentToken | property |
decimalAlignmentToken:String
[read-write]
Language version: | ActionScript 3.0 |
Runtime version: | AIR 1.5 |
Specifies the alignment token to use when you set the alignment
property to TabAlignment.DECIMAL
. The value
is a String that occurs in the text line.
The default value is ""
.
public function get decimalAlignmentToken():String
public function set decimalAlignmentToken(value:String):void
See also
position | property |
position:Number
[read-write]
Language version: | ActionScript 3.0 |
Runtime version: | AIR 1.5 |
The position of the tab stop, in pixels, relative to the start of the text line.
The default value is 0.0.
Implementation public function get position():Number
public function set position(value:Number):void
ArgumentError — If set to a value less than 0.0.
|
TabStop | () | constructor |
public function TabStop(alignment:String = "start", position:Number = 0.0, decimalAlignmentToken:String = "")
Language version: | ActionScript 3.0 |
Runtime version: | AIR 1.5 |
Creates a new TabStop.
Parametersalignment:String (default = "start ") — The tab alignment type of this tab stop.
Valid values for this property are found in the members of the TabAlignment class.
The default value is TabAlignment.START .
|
|
position:Number (default = 0.0 ) — The position of the tab stop, in pixels.
The default value is 0.0 .
|
|
decimalAlignmentToken:String (default = " ") — The alignment token to be used if the alignment is TabAlignment.DECIMAL ,
The default value is "" .
|
ArgumentError — The alignment specified is not a member of TabAlignment .
|
See also
package { import flash.text.engine.*; import flash.display.Sprite; public class TabStopExample extends Sprite { public function TabStopExample():void { var container:Sprite = new Sprite(); var english:ElementFormat = new ElementFormat(); english.fontDescription = new FontDescription("Arial"); english.fontSize = 16; english.locale = "en"; var tabStops:Vector.<TabStop> = new Vector.<TabStop>(); tabStops.push( new TabStop(TabAlignment.START, 20), new TabStop(TabAlignment.CENTER, 120), new TabStop(TabAlignment.DECIMAL, 220, "."), new TabStop(TabAlignment.END, 320) ); var textBlock:TextBlock = new TextBlock(); textBlock.content = new TextElement( "\tstart\tcenter\tdeci.mal\tend\n" + "\tl\tl\t3.4\tl\n" + "\tlm\tlm\t234.56\tlm\n" + "\tlmn\tlmn\t12345678.34567\tlmn\n" , english); textBlock.tabStops = tabStops; var y:Number = 60; var previousTextLine:TextLine = null; var textLine:TextLine; var i:int; var tabOrigin:Number = 100; for (i = 0; i < 4; i++) { textLine = textBlock.createTextLine(previousTextLine, 1000, 0); textLine.x = 20; textLine.y = y; container.addChild(textLine); y += 25; previousTextLine = textLine; } addChild(container); } } }