flash.text.engine
public final class TabStop
继承TabStop Inheritance Object

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

TabStop 类表示文本块中 Tab 停靠位的属性。您可以将 Tab 停靠位作为 TabStop 对象的矢量分配给 TextBlock.tabStops 属性。

将 TabStop 对象应用于 TextBlock 后设置该对象的属性不会使 TextBlock 无效。

查看示例

另请参见

TextBlock.tabStops
TabAlignment


公共属性
 属性定义方
  alignment : String
指定此 Tab 停靠位的 Tab 对齐方式。
TabStop
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
  decimalAlignmentToken : String
指定在将对齐属性设置为 TabAlignment.DECIMAL 时要使用的对齐标记。
TabStop
  position : Number
Tab 停靠位相对于文本行开头的位置,以像素为单位。
TabStop
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
公共方法
 方法定义方
  
TabStop(alignment:String = "start", position:Number = 0.0, decimalAlignmentToken:String = "")
创建新的 TabStop。
TabStop
 Inherited
指示对象是否已经定义了指定的属性。
Object
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
返回指定对象的字符串表示形式。
Object
 Inherited
返回指定对象的原始值。
Object
属性详细信息
alignment属性
alignment:String  [读写]

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

指定此 Tab 停靠位的 Tab 对齐方式。使用 TabAlignment 类中的常量来设置此属性。

默认值为 TabAlignment.START

如果行的原点与共享相同 Tab 停靠位的其他行不对齐,则使用 TextBlock.createTextLine()lineOffset 参数调整 Tab 停靠位。

使用 TabAlignment 类中的以下常量设置此属性的值:

字符串值Description
TabAlignment.START position 属性指定带制表符的文本的开头距离文本行开头的像素数。
TabAlignment.CENTER position 属性指定带制表符的文本的中心距离文本行开头的像素数。
TabAlignment.END position 属性指定带制表符的文本的末尾距离文本行开头的像素数。
TabAlignment.DECIMAL position 属性指定对齐标记距离文本行开头的像素数。



实现
    public function get alignment():String
    public function set alignment(value:String):void

引发
ArgumentError — 如果设置的值不是 TabAlignment 的成员。

另请参见

decimalAlignmentToken属性 
decimalAlignmentToken:String  [读写]

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

指定在将 alignment 属性设置为 TabAlignment.DECIMAL 时要使用的对齐标记。该值是存在于文本行中的一个字符串。

默认值为 "" .



实现
    public function get decimalAlignmentToken():String
    public function set decimalAlignmentToken(value:String):void

另请参见

position属性 
position:Number  [读写]

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

Tab 停靠位相对于文本行开头的位置,以像素为单位。

默认值为 0.0。



实现
    public function get position():Number
    public function set position(value:Number):void

引发
ArgumentError — 如果设置为小于 0.0 的值。
构造函数详细信息
TabStop()构造函数
public function TabStop(alignment:String = "start", position:Number = 0.0, decimalAlignmentToken:String = "")

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

创建新的 TabStop。

参数
alignment:String (default = "start") — 此 Tab 停靠位的 Tab 对齐类型。此属性的有效值包括在 TabAlignment 类的成员中。默认值为 TabAlignment.START
 
position:Number (default = 0.0) — Tab 停靠位的位置,以像素为单位。默认值为 0.0
 
decimalAlignmentToken:String (default = "") — 在 alignmentTabAlignment.DECIMAL 的情况下要使用的对齐标记,默认值为 ""

引发
ArgumentError — 指定的 alignment 不是 TabAlignment 的成员。

另请参见

示例 如何使用示例
TabStopExample.as

本示例阐释了四种 Tab 停靠位对齐设置的效果:START、CENTER、DECIMAL 和 END。
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);        
        }
    }
}