| 套件 | flashx.textLayout.elements |
| 類別 | public final class LinkElement |
| 繼承 | LinkElement  SubParagraphGroupElementBase FlowGroupElement FlowElement Object |
| 實作 | IEventDispatcher |
| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
通常在按一下時，LinkElement 將會呼叫 flash.net.navigateToURL() 方法。特殊的 URI 配置 event: 也會受到支援。此配置將產生 TextFlow 事件，使用者可能會偵聽該事件以便執行 AS3 程式碼。範例如下。
如果您指定目標，則該目標必須是下列其中一個值：
| Target 值 | 說明 |
|---|---|
| _self | 取代目前 HTML 頁面。如果頁面位在頁框或頁框組中，則會在該頁框內載入。如果是完整的瀏覽器，則頁面會開啟以取代其來源頁面。 |
| _blank | 開啟沒有名稱的新瀏覽器名稱。 |
| _parent | 取代其來源 HTML 頁面。 |
| _top | 目前的瀏覽器中載入，並取代其中的任何內容 (如頁框組)。 |
預設 MXML 屬性mxmlChildren
更多範例
相關 API 元素
LinkState
FlowElement.linkActiveFormat
FlowElement.linkHoverFormat
FlowElement.linkNormalFormat
TextFlow
FlowElement.linkActiveFormat
FlowElement.linkHoverFormat
FlowElement.linkNormalFormat
TextFlow
公用屬性
隱藏繼承公用屬性
顯示繼承公用屬性| 屬性 | 定義自 | ||
|---|---|---|---|
 | alignmentBaseline : *
TextLayoutFormat：指定主基線對齊的基線。 | FlowElement | |
| backgroundAlpha : *
TextLayoutFormat：背景的 Alpha (透明度) 值 (如果重疊顯示時未定義，則採用預設值)。 | FlowElement | |
| backgroundColor : *
TextLayoutFormat：文字的背景色彩 (如果重疊顯示時未定義，則採用預設值)。 | FlowElement | |
| baselineShift : *
TextLayoutFormat：從 dominantBaseline 值位移基線的量。 | FlowElement | |
| blockProgression : *
TextLayoutFormat：指定行位置為垂直或水平走向。 | FlowElement | |
| breakOpportunity : *
TextLayoutFormat：將換行文字斷行時，控制斷行的位置。 | FlowElement | |
| cffHinting : *
TextLayoutFormat：用於此文字的 CFF 提示類型。 | FlowElement | |
| clearFloats : *
TextLayoutFormat：控制文字包圍在浮動物件四周的方式。 | FlowElement | |
| color : *
TextLayoutFormat：文字的色彩。 | FlowElement | |
| columnCount : *
TextLayoutFormat：文字欄的數目 (如果重疊顯示時未定義，則採用預設值)。 | FlowElement | |
| columnGap : *
TextLayoutFormat：以像素為單位，指定欄之間所留間距空間的量 (如果重疊顯示時未定義，則採用預設值)。 | FlowElement | |
| columnWidth : *
TextLayoutFormat：以像素為單位的欄寬 (如果重疊顯示時未定義，則採用預設值)。 | FlowElement | |
| computedFormat : flashx.textLayout.formats:ITextLayoutFormat [唯讀]
傳回對此元素使用的計算格式特質。 | FlowElement | |
| constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | |
| coreStyles : Object [唯讀] 傳回此 FlowElement 的 coreStyles。 | FlowElement | |
| digitCase : *
TextLayoutFormat：用於此文字的數字大小寫類型。 | FlowElement | |
| digitWidth : *
TextLayoutFormat：用於此文字的數字寬度類型。 | FlowElement | |
| direction : *
TextLayoutFormat：指定文字區塊內文字的預設雙向內嵌層級。 | FlowElement | |
| dominantBaseline : *
TextLayoutFormat：指定貼齊 alignmentBaseline 的元素基線，以決定行上元素的垂直位置。 | FlowElement | |
| firstBaselineOffset : *
TextLayoutFormat：指定容器中第一行的基線位置。 | FlowElement | |
| fontFamily : *
TextLayoutFormat：要使用的字體名稱，或是以逗號分隔的字體名稱清單。 | FlowElement | |
| fontLookup : *
TextLayoutFormat：要使用字體查詢。 | FlowElement | |
| fontSize : *
TextLayoutFormat：以像素為單位的文字大小。 | FlowElement | |
| fontStyle : *
TextLayoutFormat：文字樣式。 | FlowElement | |
| fontWeight : *
TextLayoutFormat：字體粗細。 | FlowElement | |
| format : flashx.textLayout.formats:ITextLayoutFormat 直接套用至此元素的 TextLayoutFormat 屬性。 | FlowElement | |
| href : String
與 LinkElement 物件相關的統一資源識別項 (URI)。 | LinkElement | ||
| id : String
指定元素的識別名稱，如此只要參照此 id 就可以設定元素的樣式。 | FlowElement | |
| justificationRule : *
TextLayoutFormat：對齊段落中文字所使用的規則。 | FlowElement | |
| justificationStyle : *
TextLayoutFormat：段落對齊所用的樣式。 | FlowElement | |
| kerning : *
TextLayoutFormat：字距微調會調整某些字元組之間的像素，以改善可讀性。 | FlowElement | |
| leadingModel : *
TextLayoutFormat：指定行距模型，它結合了行距基礎及行距方向。 | FlowElement | |
| ligatureLevel : *
TextLayoutFormat：控制字體中定義的哪些連字可用於文字。 | FlowElement | |
| lineBreak : *
TextLayoutFormat：控制容器內的文字換行 (如果重疊顯示時未定義，則採用預設值)。 | FlowElement | |
| lineHeight : *
TextLayoutFormat：文字的行距控制。 | FlowElement | |
| lineThrough : *
TextLayoutFormat：若為 true，將套用刪除線，亦即通過文字中間的線。 | FlowElement | |
| linkActiveFormat : *
TextLayoutFormat：定義正常狀態下的連結格式化特質。 | FlowElement | |
| linkHoverFormat : *
TextLayoutFormat：定義滑鼠位於連結範圍 (滑入) 時，停留狀態連結的格式化特質。 | FlowElement | |
| linkNormalFormat : *
TextLayoutFormat：定義正常狀態下的連結格式化特質。 | FlowElement | |
| linkState : String [唯讀]
連結的目前狀態。 | LinkElement | ||
| listAutoPadding : *
TextLayoutFormat：當清單開始邊緣該側的邊框距離值設為 auto 時，這會將清單的開始邊緣指定為自動縮排。 | FlowElement | |
| listMarkerFormat : *
TextLayoutFormat：定義格式化特質清單標記。 | FlowElement | |
| listStylePosition : *
TextLayoutFormat：有效值為 ListStylePosition.INSIDE、ListStylePosition.OUTSIDE、FormatValue.INHERIT。若未定義預設值，則表示未設定。如果重疊顯示時未定義此屬性，則此屬性將繼承祖系的值。 | FlowElement | |
| listStyleType : *
TextLayoutFormat：有效值為 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。若未定義預設值，則表示未設定。如果重疊顯示時未定義此屬性，則此屬性將繼承祖系的值。 | FlowElement | |
| locale : *
TextLayoutFormat：文字的地區設定。 | FlowElement | |
| mxmlChildren : Array
將子系的陣列附加至此物件。 | FlowGroupElement | |
| numChildren : int [唯讀]
傳回此 FlowGroupElement 物件所具有的 FlowElement 子系數目。 | FlowGroupElement | |
| paddingBottom : *
TextLayoutFormat：下方內移距 (像素)。 | FlowElement | |
| paddingLeft : *
TextLayoutFormat：左方內移距 (像素)。 | FlowElement | |
| paddingRight : *
TextLayoutFormat：右方內移距 (像素)。 | FlowElement | |
| paddingTop : *
TextLayoutFormat：上方內移距 (像素)。 | FlowElement | |
| paragraphEndIndent : *
TextLayoutFormat：指定段落結尾邊緣縮排量的數字 (以像素為單位)。 | FlowElement | |
| paragraphSpaceAfter : *
TextLayoutFormat：一個數字，指定段落後面要保留的空間量 (像素)。 | FlowElement | |
| paragraphSpaceBefore : *
TextLayoutFormat：一個數字，指定段落前面要保留的空間量 (像素)。 | FlowElement | |
| paragraphStartIndent : *
TextLayoutFormat：指定段落開頭邊緣縮排量的數字 (以像素為單位)。 | FlowElement | |
| parent : FlowGroupElement [唯讀] 傳回此 FlowElement 物件的父輩。 | FlowElement | |
| parentRelativeEnd : int [唯讀] 傳回父輩中此 FlowElement 物件的相對結尾。 | FlowElement | |
| parentRelativeStart : int [唯讀] 傳回父輩中此 FlowElement 物件的相對開頭。 | FlowElement | |
| renderingMode : *
TextLayoutFormat：用於此文字的顯示模式。 | FlowElement | |
| styleName : *
TextLayoutFormat：指定元素的識別類別，如此只要參照此 styleName 就可以設定元素的樣式。 | FlowElement | |
| styles : Object [唯讀] 傳回此 FlowElement 的樣式。 | FlowElement | |
| tabStops : *
TextLayoutFormat：指定段落關聯的定位停駐點。 | FlowElement | |
| target : String
與 LinkElement 相關的 Target 值。 | LinkElement | ||
| textAlign : *
TextLayoutFormat：段落中各行相對於容器的對齊方式。 | FlowElement | |
| textAlignLast : *
TextLayoutFormat：段落中最後 (或唯一的) 一行相對於齊行文字中之容器的對齊方式。 | FlowElement | |
| textAlpha : *
TextLayoutFormat：文字的 Alpha (透明) 值。 | FlowElement | |
| textDecoration : *
TextLayoutFormat：文字上的裝飾。 | FlowElement | |
| textIndent : *
TextLayoutFormat：以像素為單位，指定段落中第一行縮排量的數字。 | FlowElement | |
| textJustify : *
TextLayoutFormat：指定對齊文字的選項。 | FlowElement | |
| textLength : int [唯讀]
傳回此 FlowElement 物件及其子系所擁有的文字總長度。 | FlowElement | |
| textRotation : *
TextLayoutFormat：決定此文字要旋轉的度數。 | FlowElement | |
| tracking : Object [唯寫]
設定字距調整，且與 trackingRight 屬性的意義相同。 | FlowElement | |
| trackingLeft : *
TextLayoutFormat：以像素為單位代表要套用至每個字元左側字距調整 (手動字距微調) 量的數字 (或 fontSize 的百分比，例如，120%)。 | FlowElement | |
| trackingRight : *
TextLayoutFormat：以像素為單位代表要套用至每個字元右側字距調整 (手動字距微調) 量的數字 (或 fontSize 的百分比，例如，120%)。 | FlowElement | |
| typeName : String
每個 FlowElement 都有 typeName。 | FlowElement | |
| typographicCase : *
TextLayoutFormat：用於此文字的印刷大小寫類型。 | FlowElement | |
| userStyles : Object 可讓您讀寫 FlowElement 物件上的使用者樣式。 | FlowElement | |
| verticalAlign : *
TextLayoutFormat：垂直對齊或齊行 (如果重疊顯示時未定義，則採用預設值)。 | FlowElement | |
| whiteSpaceCollapse : *
TextLayoutFormat：將文字匯入 TextFlow 時捨去或保留空格。 | FlowElement | |
| wordSpacing : *
TextLayoutFormat：指定對齊時要使用之文字間的最佳、最小及最大間距 (標準間距寬度的倍數)。 | FlowElement | |
公用方法
| 方法 | 定義自 | ||
|---|---|---|---|
建構函式 - 建立新的 LinkElement 實體。 | LinkElement | ||
|
附加子系 FlowElement 物件。 | FlowGroupElement | |
|
在指定的索引位置新增子系 FlowElement 物件。 | FlowGroupElement | |
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
會在 EventDispatcher 物件註冊事件偵聽程式，以便讓偵聽程式收到事件的通知。 | LinkElement | ||
| 清除此 FlowElement 物件中由 styleProp 參數所指定的樣式。 | FlowElement | |
|
製作此 FlowElement 物件 (包含任何子系) 的深層複本，這會複製兩個指定字元位置之間的內容，並傳回複本做為 FlowElement 物件。 | FlowElement | |
會將事件傳送到事件流程。 | LinkElement | ||
| 將這一個的 userStyles 與 otherElement 的 userStyles 進行比較。 | FlowElement | |
|
指定相對文字位置，尋找第一個內含相對位置的子系 FlowElement 的索引。 | FlowGroupElement | |
|
指定相對文字位置，尋找內含位置的分葉元素。 | FlowGroupElement | |
|
傳回文字流排中的元素開始位置做為絕對索引。 | FlowElement | |
|
傳回指定位置的字元 (與此 FlowElement 物件相對的位置)。 | FlowElement | |
| 傳回指定位置的字元碼 (與此 FlowElement 相對的位置)。 | FlowElement | |
|
傳回指定索引位置的 FlowElement 子系。 | FlowGroupElement | |
|
搜尋子系以找出指定的 FlowElement 物件，並傳回其索引位置。 | FlowGroupElement | |
|
傳回此元素的開頭 (與祖系元素相對的位置)。 | FlowElement | |
|
傳回此群組的第一個 FlowLeafElement 子系。 | FlowGroupElement | |
|
傳回此群組的最後一個 FlowLeafElement 子系。 | FlowGroupElement | |
| 傳回文字流排階層中的下一個 FlowElement 同級項目。 | FlowElement | |
|
傳回與此元素相關的 ParagraphElement 物件。 | FlowElement | |
| 傳回文字流排階層中的上一個 FlowElement 同級項目。 | FlowElement | |
| 傳回 styleProp 參數所指定的樣式值，此參數會指定樣式名稱，而且可以包含任何使用者樣式名稱。 | FlowElement | |
| [覆寫] | FlowGroupElement | |
|
往上瀏覽文字流排階層，以傳回元素的根 TextFlow 物件。 | FlowElement | |
會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。 | LinkElement | ||
|
指出物件是否有已定義的指定屬性。 | Object | |
| 實作物件已經建立而且在 MXML 標籤上指定的所有組件屬性已經初始化後，為 MXML 物件進行呼叫。 | FlowElement | |
|
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | |
|
指出指定的屬性是否存在，以及是否可列舉。 | Object | |
|
從群組中移除指定的子系 FlowElement 物件。 | FlowGroupElement | |
|
移除指定索引位置的子系 FlowElement 物件。 | FlowGroupElement | |
會從 EventDispatcher 物件移除偵聽程式。 | LinkElement | ||
|
將群組中的子元素取代為指定的新元素。 | FlowGroupElement | |
|
為迴圈作業設定動態屬性的可用性。 | Object | |
| 將 styleProp 參數所指定的樣式設為 newValue 參數所指定的值。 | FlowElement | |
|
製作此 FlowElement 物件的複本，這會複製兩個指定字元位置之間的內容。 | FlowElement | |
|
在 childIndex 參數指定的位置分割此物件。 | FlowGroupElement | |
|
在 relativePosition 參數指定的位置分割此 FlowElement 物件，而此參數是此元素在文字中的相對位置。 | FlowElement | |
|
傳回代表此物件的字串，根據地區特定慣例進行格式化。 | Object | |
|
會傳回指定之物件的字串形式。 | Object | |
|
會傳回指定之物件的基本值。 | Object | |
檢查此 EventDispatcher 物件是否已註冊事件偵聽程式，或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。 | LinkElement | ||
事件
| 事件 | 摘要 | 定義自 | ||
|---|---|---|---|---|
| 在按一下連結時發送。 | LinkElement | |||
| 在連結按下滑鼠時發送。 | LinkElement | |||
| 在滑鼠滑過連結時發送。 | LinkElement | |||
| 在連結上放開滑鼠時發送。 | LinkElement | |||
| 在滑鼠離開連結時發送。 | LinkElement | |||
| 在滑鼠第一次進入連結時發送。 | LinkElement | |||
屬性詳細資訊
href | 屬性 |
href:String| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
與 LinkElement 物件相關的統一資源識別項 (URI)。URI 可以是 flash.net.navigateToURL() 方法所支援的任何 URI。此屬性會對應至該方法的 request 參數。URI 也可以是 event:eventType 的形式。按一下時，TextFlow 將產生類型為 eventType 的事件。
實作
public function get href():String public function set href(value:String):void相關 API 元素
linkState | 屬性 |
target | 屬性 |
建構函式詳細資料
LinkElement | () | 建構函式 |
public function LinkElement()| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
建構函式 - 建立新的 LinkElement 實體。
方法詳細資訊
addEventListener | () | 方法 |
public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
會在 EventDispatcher 物件註冊事件偵聽程式，以便讓偵聽程式收到事件的通知。您可以在顯示清單上的所有節點，為特定類型的事件、階段與優先順序註冊事件偵聽程式。
當您成功註冊事件偵聽程式後，就不可以透過對 addEventListener() 的額外呼叫來變更其優先順序。 若要變更偵聽程式的優先順序，您必須先呼叫 removeEventListener()。 然後，您就可以使用新的優先順序等級來重新註冊偵聽程式。
一旦您註冊了偵聽程式，對 addEventListener() 來進行後續呼叫，若使用不同的 type 或 useCapture 值，將會導致建立個別的偵聽程式註冊程序。 例如，如果您先將 useCapture 設為 true 來註冊偵聽程式，則只會在捕捉階段進行偵聽。 如果您使用相同的偵聽程式物件 (但將 useCapture 設為 false) 再次呼叫 addEventListener()，會得到兩個不同的偵聽程式： 一個會在捕捉階段進行偵聽，另一個則會在目標與反昇階段進行偵聽。
您無法單獨針對目標階段或反昇階段註冊事件偵聽程式。 由於反昇階段只適用於目標節點的祖系，因此這兩種階段必須一起進行註冊。
當您不再需要事件偵聽程式，可以呼叫 EventDispatcher.removeEventListener() 來移除它，否則可能產生記憶體問題。 含有已註冊之事件偵聽程式的物件不會自動從記憶體中移除，因為垃圾回收器不會將仍保有參照的物件移除。
複製 EventDispatcher 實體並不會將附加在該實體上的事件偵聽程式一併複製 (如果新建立的節點需要事件偵聽程式，則您必須在建立節點後再附加偵聽程式)。 然而，如果您移動了 EventDispatcher 實體，則附加的事件偵聽程式也會跟著移動。
若於此節點正在處理事件的同時將事件偵聽程式註冊到某個節點上，則事件偵聽程式不會在目前階段觸發，但會在事件流程的後續階段 (例如反昇階段) 中觸發。
如果您在節點正在處理事件的同時將事件偵聽程式從節點中移除，則事件偵聽程式還是會被目前的動作觸發。 一旦移除了事件偵聽程式，就無法再叫用它 (除非您為了日後的處理而再次註冊它)。
參數
type:String — 事件類型。
| |
listener:Function — 處理事件的偵聽程式函數。此函數必須接受事件物件當做唯一的參數，而且必須傳回空值，如下列範例所示：
| |
useCapture:Boolean (default = false)useCapture 設為 true，則偵聽程式只會在捕捉階段 (而不是在目標或反昇階段) 處理事件。如果 useCapture 為 false，則偵聽程式只會在目標或反昇階段處理事件。若要在全部三個階段中偵聽事件，請呼叫 addEventListener() 兩次，先將 useCapture 設為 true 後進行第一次呼叫，接著將 useCapture 設為 false 再進行第二次呼叫。
| |
priority:int (default = 0) | |
useWeakReference:Boolean (default = false)類別層級的成員函數不受記憶體回收限制，因此您可以將類別層級成員函數的 |
dispatchEvent | () | 方法 |
hasEventListener | () | 方法 |
public function hasEventListener(type:String):Boolean| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。 這可讓您判斷 EventDispatcher 物件是否已經改變事件流程階層中事件類型的處理方式。 若要判斷特定事件類型是否已經實際觸發事件偵聽程式，請使用 IEventDispatcher.willTrigger()。
hasEventListener() 與 willTrigger() 之間的差異在於 hasEventListener() 只檢查所屬的物件，而 willTrigger() 則會檢查整個事件流程中 type 參數所指定的事件。
參數
type:String — 事件類型。
|
Boolean — 如果註冊了特定類型的偵聽程式，則值為 true 值，否則為 false。
|
removeEventListener | () | 方法 |
public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
會從 EventDispatcher 物件移除偵聽程式。 如果沒有相符的偵聽程式以 EventDispatcher 物件來註冊，則呼叫此方法不會產生任何作用。
參數
type:String — 事件類型。
| |
listener:Function — 要移除的偵聽程式物件。
| |
useCapture:Boolean (default = false)removeEventListener() 的兩次呼叫才能移除這兩個階段：一次呼叫的 useCapture 是設為 true，而另一次呼叫的 useCapture 則是設定為 false。
|
willTrigger | () | 方法 |
public function willTrigger(type:String):Boolean| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
檢查此 EventDispatcher 物件是否已註冊事件偵聽程式，或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。當特定類型的事件傳送至此 EventDispatcher 物件或其任何後代時，如果事件偵聽程式在事件流程的任何階段觸發，此方法就會傳回 true。
hasEventListener() 與 willTrigger() 之間的差異在於 hasEventListener() 只檢查所屬的物件，而 willTrigger() 則會檢查整個事件流程中 type 參數所指定的事件。
參數
type:String — 事件類型。
|
Boolean — 如果即將觸發特定類型的偵聽程式，則為 true 值，否則為 false。
|
事件詳細資訊
click | 事件 |
事件物件類型:
屬性 FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEvent屬性 FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEvent.CLICK| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
在按一下連結時發送。用戶端可能會透過自行處理事件並呼叫 preventDefault()，以覆寫處理事件的方式。
定義type 屬性值 (click 事件物件)。
mouseDown | 事件 |
事件物件類型:
屬性 FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEvent屬性 FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEvent.MOUSE_DOWN| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
在連結按下滑鼠時發送。
定義mouseDown 事件物件的 type 屬性值。
mouseMove | 事件 |
事件物件類型:
屬性 FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEvent屬性 FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEvent.MOUSE_MOVE| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
在滑鼠滑過連結時發送。
定義mouseMove 事件物件的 type 屬性值。
mouseUp | 事件 |
事件物件類型:
屬性 FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEvent屬性 FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEvent.MOUSE_UP| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
在連結上放開滑鼠時發送。
定義type 屬性值 (mouseUp 事件物件)。
rollOut | 事件 |
事件物件類型:
屬性 FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEvent屬性 FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEvent.ROLL_OUT| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
在滑鼠離開連結時發送。
定義type 屬性值 (rollOut 事件物件)。
rollOver | 事件 |
事件物件類型:
屬性 FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEvent屬性 FlowElementMouseEvent.type =
flashx.textLayout.events.FlowElementMouseEvent.ROLL_OVER| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
在滑鼠第一次進入連結時發送。
定義type 屬性值 (rollOver 事件物件)。
範例 如何使用本範例
LinkElementExample.as
此範例會將 LinkElement 新增至段落，並覆寫停留狀態的預設格式，讓連結文字變成紅色。
package flashx.textLayout.elements.examples
{
import flash.display.Sprite;
import flashx.textLayout.container.ContainerController;
import flashx.textLayout.elements.LinkElement;
import flashx.textLayout.elements.ParagraphElement;
import flashx.textLayout.elements.SpanElement;
import flashx.textLayout.elements.TextFlow;
import flashx.textLayout.formats.TextLayoutFormat;
public class LinkElementExample extends Sprite
{
public function LinkElementExample()
{
var textFlow:TextFlow = new TextFlow();
var textLayoutFormat:TextLayoutFormat = new TextLayoutFormat();
textLayoutFormat.fontFamily = "Arial, Helvetica, _sans";
textLayoutFormat.fontSize = 18;
textFlow.hostFormat = textLayoutFormat;
var p:ParagraphElement = new ParagraphElement();
var span1:SpanElement = new SpanElement();
var link:LinkElement = new LinkElement();
var span2:SpanElement = new SpanElement();
var inf:Object = {color:0xFF0000};
p.linkHoverFormat = inf;
span1.text = "Text that includes a link to ";
link.href = "http://www.adobe.com";
var linkSpan:SpanElement = new SpanElement();
linkSpan.text = "Adobe's website";
link.addChild(linkSpan);
span2.text = ". Notice the custom formatting when the cursor hovers " +
"over the link.";
p.addChild(span1);
p.addChild(link);
p.addChild(span2);
textFlow.addChild(p);
textFlow.flowComposer.addController(new ContainerController(this,stage.stageWidth, stage.stageHeight));
textFlow.flowComposer.updateAllControllers();
}
}
}
LinkElementEventExample.as
此範例使用
event: URI 配置來產生事件，以便在按一下時執行 ActionScript 程式碼。
package flashx.textLayout.elements.examples
{
import flash.display.Sprite;
import flashx.textLayout.container.ContainerController;
import flashx.textLayout.elements.LinkElement;
import flashx.textLayout.elements.ParagraphElement;
import flashx.textLayout.elements.SpanElement;
import flashx.textLayout.elements.TextFlow;
import flashx.textLayout.events.FlowElementMouseEvent;
import flashx.textLayout.formats.TextLayoutFormat;
public class LinkElementEventExample extends Sprite
{
public function LinkElementEventExample()
{
var textFlow:TextFlow = new TextFlow();
textFlow.fontFamily = "Arial, Helvetica, _sans";
textFlow.fontSize = 18;
textFlow.paddingLeft = textFlow.paddingRight = textFlow.paddingTop = 20;
var p:ParagraphElement = new ParagraphElement();
var span1:SpanElement = new SpanElement();
var link:LinkElement = new LinkElement();
var span2:SpanElement = new SpanElement();
span1.text = "Text that includes a link to ";
link.href = "event:changeTextFlowColor";
var linkSpan:SpanElement = new SpanElement();
linkSpan.text = "custom event code"
link.addChild(linkSpan);
span2.text = ". Clicking the link changes the default color of the TextFlow";
p.addChild(span1);
p.addChild(link);
p.addChild(span2);
textFlow.addChild(p);
textFlow.flowComposer.addController(new ContainerController(this,stage.stageWidth, stage.stageHeight));
textFlow.flowComposer.updateAllControllers();
textFlow.addEventListener("changeTextFlowColor",changeTextFlowColor)
}
private function changeTextFlowColor(e:FlowElementMouseEvent):void
{
var textFlow:TextFlow = e.flowElement.getTextFlow();
textFlow.color = textFlow.color == 0x00ff00 ? 0 : 0x00ff00;
textFlow.flowComposer.updateAllControllers();
}
}
}
Tue Jun 12 2018, 03:47 PM Z