套件 | flash.text.engine |
類別 | public final class SpaceJustifier |
繼承 | SpaceJustifier TextJustifier Object |
語言版本: | ActionScript 3.0 |
執行階段版本: | Flash Player 10, AIR 1.5, Flash Lite 4 |
在設定 SpaceJustifier 物件的屬性之前,您必須使用建構函式 new SpaceJustifier()
來建立該物件。在 SpaceJustifier 物件已經套用到 TextBlock 之後再設定該物件的屬性時,不會讓 TextBlock 失效。
相關 API 元素
公用屬性
屬性 | 定義自 | ||
---|---|---|---|
constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | ||
letterSpacing : Boolean
指定是否要在對齊過程中使用字母間距。 | SpaceJustifier | ||
lineJustification : String
指定文字區塊之文字所適用的齊行。 | TextJustifier | ||
locale : String [唯讀]
指定地區來決定文字區塊中文字所適用的齊行規則。 | TextJustifier | ||
maximumSpacing : Number
指定對齊時要使用之文字間的最大間距 (標準間距的倍數)。 | SpaceJustifier | ||
minimumSpacing : Number
指定對齊時要使用之文字間的最小間距 (標準間距的倍數)。 | SpaceJustifier | ||
optimumSpacing : Number
指定對齊時要使用之文字間的最佳間距 (標準間距的倍數)。 | SpaceJustifier |
公用方法
方法 | 定義自 | ||
---|---|---|---|
SpaceJustifier(locale:String = "en", lineJustification:String = "unjustified", letterSpacing:Boolean = false)
建立 SpaceJustifier 物件。 | SpaceJustifier | ||
[覆寫]
建構 SpaceJustifier 的已複製副本。 | SpaceJustifier | ||
[靜態]
建構適合指定之地區使用的預設 TextJustifier 子類別。 | TextJustifier | ||
指出物件是否有已定義的指定屬性。 | Object | ||
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | ||
指出指定的屬性是否存在,以及是否可列舉。 | Object | ||
為迴圈作業設定動態屬性的可用性。 | Object | ||
傳回代表此物件的字串,根據地區特定慣例進行格式化。 | Object | ||
會傳回指定之物件的字串形式。 | Object | ||
會傳回指定之物件的基本值。 | Object |
屬性詳細資訊
letterSpacing | 屬性 |
maximumSpacing | 屬性 |
maximumSpacing:Number
語言版本: | ActionScript 3.0 |
執行階段版本: | Flash Player 10.1, AIR 2 |
指定對齊時要使用之文字間的最大間距 (標準間距的倍數)。如果 letterSpacing
是 true
,兩個單字間的間距達到最大值時,將會使用字母間距。如果 letterSpacing
是 false
,兩個單字間的間距將會擴展超越最大值。
預設值為 1.5
實作
public function get maximumSpacing():Number
public function set maximumSpacing(value:Number):void
擲回值
ArgumentError — 指定的 value 小於 optimumSpacing 。
|
minimumSpacing | 屬性 |
minimumSpacing:Number
語言版本: | ActionScript 3.0 |
執行階段版本: | Flash Player 10.1, AIR 2 |
指定對齊時要使用之文字間的最小間距 (標準間距的倍數)。
預設值為 0.5
實作
public function get minimumSpacing():Number
public function set minimumSpacing(value:Number):void
擲回值
ArgumentError — 指定的 value 小於零或是大於 optimumSpacing 。
|
optimumSpacing | 屬性 |
optimumSpacing:Number
語言版本: | ActionScript 3.0 |
執行階段版本: | Flash Player 10.1, AIR 2 |
指定對齊時要使用之文字間的最佳間距 (標準間距的倍數)。
預設值為 1.0
實作
public function get optimumSpacing():Number
public function set optimumSpacing(value:Number):void
擲回值
ArgumentError — 指定的 value 小於minimumSpacing 或是大於 maximumSpacing 。
|
建構函式詳細資料
SpaceJustifier | () | 建構函式 |
public function SpaceJustifier(locale:String = "en", lineJustification:String = "unjustified", letterSpacing:Boolean = false)
語言版本: | ActionScript 3.0 |
執行階段版本: | Flash Player 10, AIR 1.5, Flash Lite 4 |
建立 SpaceJustifier 物件。LineJustification 類別包含用來指定可套用之齊行類型的常數。
參數locale:String (default = "en ") — 用來判斷齊行規則的地區。預設值為 "en" 。
| |
lineJustification:String (default = "unjustified ") — 段落的齊行類型。請針對此屬性使用 LineJustification 常數。預設值為 LineJustification.UNJUSTIFIED 。
| |
letterSpacing:Boolean (default = false ) — 指定是否要在對齊過程中使用字母間距。預設值是 false 。
|
擲回值
ArgumentError — 指定的 locale 為 null 或是太短,無法代表有效的地區。
| |
ArgumentError — 指定的 lineJustification 不是 LineJustification 的成員。
|
相關 API 元素
方法詳細資訊
clone | () | 方法 |
override public function clone():flash.text.engine:TextJustifier
語言版本: | ActionScript 3.0 |
執行階段版本: | Flash Player 10, AIR 1.5, Flash Lite 4 |
建構 SpaceJustifier 的已複製副本。
傳回值flash.text.engine:TextJustifier — SpaceJustifier 物件的副本。
|
範例 如何使用本範例
SpaceJustifierExample.as
下列範例使用字母間距並對齊文字區塊內的所有字行 (最後一行除外)。
package { import flash.display.Sprite; import flash.text.engine.TextBlock; import flash.text.engine.TextElement; import flash.text.engine.TextLine; import flash.text.engine.ElementFormat; import flash.text.engine.SpaceJustifier; import flash.text.engine.LineJustification; public class SpaceJustifierExample extends Sprite { public function SpaceJustifierExample():void { var str:String = "Lorem ipsum dolor sit amet, consectetur adipisicing elit, " + "sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut " + "enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut " + "aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit " + "in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur " + "sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt " + "mollit anim id est laborum."; var format:ElementFormat = new ElementFormat(null, 12, 0xCC0000); var textElement:TextElement = new TextElement(str, format); var spaceJustifier:SpaceJustifier = new SpaceJustifier("en", LineJustification.ALL_BUT_LAST); spaceJustifier.letterSpacing = true; var textBlock:TextBlock = new TextBlock(); textBlock.content = textElement; textBlock.textJustifier = spaceJustifier; createLines(textBlock); } private function createLines(textBlock:TextBlock):void { var yPos = 20; var textLine:TextLine = textBlock.createTextLine (null, 150); while (textLine) { addChild(textLine); textLine.x = 15; yPos += textLine.textHeight+2; textLine.y = yPos; textLine = textBlock.createTextLine(textLine, 150); } } } }
Tue Jun 12 2018, 03:47 PM Z