套件 | fl.controls |
類別 | public class UIScrollBar |
繼承 | UIScrollBar ScrollBar UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
scrollTarget
屬性,如此便能附加到 TextField 實體或 TLFTextField 實體。
注意:當您使用 ActionScript 更新會影響文字版面的 TextField 或 TLFTextField 實體的屬性時,必須呼叫 UIScrollBar 組件實體上的 update()
方法以重新整理其捲動屬性。屬於 TextField 或 TLFTextField 實體的文字版面配置屬性範例包括 width
、height
以及 wordWrap
。
屬性 | 定義自 | ||
---|---|---|---|
accessibilityImplementation : AccessibilityImplementation
對此 InteractiveObject 實體目前的輔助功能實作 (AccessibilityImplementation)。 | InteractiveObject | ||
accessibilityProperties : AccessibilityProperties
此顯示物件的目前輔助功能選項。 | DisplayObject | ||
alpha : Number
指出所指定物件的 Alpha 透明度值。 | DisplayObject | ||
blendMode : String
來自 BlendMode 類別的值,會指定要使用何種混合模式。 | DisplayObject | ||
blendShader : Shader [唯寫]
設定用來混合前景和背景的著色器。 | DisplayObject | ||
buttonMode : Boolean
可指定此 sprite 的按鈕模式。 | Sprite | ||
cacheAsBitmap : Boolean
如果設定為 true,Flash 執行階段會快取顯示物件的內部點陣圖表示法。 | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
如果為非 null,當 cacheAsBitmap 設定為 true 時,這個 Matrix 物件會定義顯示物件的顯示方法。 | DisplayObject | ||
constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | ||
contextMenu : NativeMenu
指定與此物件有關聯的快顯選單。 | InteractiveObject | ||
direction : String [覆寫]
會取得或設定值,指出捲軸的捲動方向是垂直或水平。 | UIScrollBar | ||
doubleClickEnabled : Boolean
會指定物件是否會收到 doubleClick 事件。 | InteractiveObject | ||
dropTarget : DisplayObject [唯讀]
指定要將 sprite 拖曳至或丟棄至哪個顯示物件上。 | Sprite | ||
enabled : Boolean [覆寫]
會取得或設定 Boolean 值,指出捲軸是否為啟用。 | ScrollBar | ||
filters : Array
索引的陣列,其中包含目前和顯示物件相關的每個濾鏡物件。 | DisplayObject | ||
focusEnabled : Boolean
會取得或設定 Boolean 值,指出組件是否可以在使用者按一下之後成為焦點。 | UIComponent | ||
focusManager : IFocusManager
會取得或設定控制此組件及其同輩之焦點的 FocusManager。 | UIComponent | ||
focusRect : Object
會指定這個物件是否會顯示焦點矩形。 | InteractiveObject | ||
graphics : Graphics [唯讀]
指定屬於此 sprite 物件的 Graphics 物件,其中可能會產生向量繪圖命令。 | Sprite | ||
height : Number [覆寫]
會取得或設定組件的高度,以像素為單位。 | ScrollBar | ||
hitArea : Sprite
指定用來當作 sprite 作用區域的另一個 sprite。 | Sprite | ||
lineScrollSize : Number
會取得或設定當按下捲軸軌道時,代表要捲動頁面的遞增值。 | ScrollBar | ||
loaderInfo : LoaderInfo [唯讀]
會傳回 LoaderInfo 物件,其中包含關於載入此顯示物件所屬之檔案的資訊。 | DisplayObject | ||
mask : DisplayObject
呼叫之顯示物件會以指定的 mask 物件遮蓋。 | DisplayObject | ||
maxScrollPosition : Number
會取得或設定代表最高捲動位置的數字。 | ScrollBar | ||
metaData : Object
如果中繼資料是透過 PlaceObject4 標籤與 SWF 檔案中的這個 DisplayObject 實體一同儲存,則會取得 DisplayObject 實體的中繼資料物件。 | DisplayObject | ||
minScrollPosition : Number
會取得或設定代表最低捲動位置的數字。 | ScrollBar | ||
mouseChildren : Boolean
判斷物件的子系是否支援啟用滑鼠或使用者輸入裝置。 | DisplayObjectContainer | ||
mouseEnabled : Boolean
指定此物件是否接收滑鼠或其他使用者輸入及訊息。 | InteractiveObject | ||
mouseFocusEnabled : Boolean
會取得或設定值,指出組件是否可以在使用者按一下之後成為焦點。 | UIComponent | ||
mouseX : Number [唯讀]
指出滑鼠或使用者輸入裝置位置的 x 座標,以像素為單位。 | DisplayObject | ||
mouseY : Number [唯讀]
指出滑鼠或使用者輸入裝置位置的 y 座標,以像素為單位。 | DisplayObject | ||
name : String
指出 DisplayObject 的實體名稱。 | DisplayObject | ||
needsSoftKeyboard : Boolean
指定虛擬鍵盤 (螢幕上的軟體鍵盤) 是否應在此 InteractiveObject 實體接收到焦點時顯示。 | InteractiveObject | ||
numChildren : int [唯讀]
傳回此物件的子系數量。 | DisplayObjectContainer | ||
opaqueBackground : Object
會指定顯示物件是否不透明,並具有特定背景顏色。 | DisplayObject | ||
pageScrollSize : Number
會取得或設定當按下捲軸軌道時,代表捲動頁面遞增的值。 | ScrollBar | ||
pageSize : Number
會取得或設定一頁包含的行數。 | ScrollBar | ||
parent : DisplayObjectContainer [唯讀]
指出包含此顯示物件的 DisplayObjectContainer 物件。 | DisplayObject | ||
root : DisplayObject [唯讀]
對載入之 SWF 檔案的顯示物件而言,root 屬性就是該 SWF 檔案所呈現之顯示清單樹狀結構部分的最上層顯示物件。 | DisplayObject | ||
rotation : Number
指出 DisplayObject 實體的旋轉度數 (從該物件原本方向算起)。 | DisplayObject | ||
rotationX : Number
表示 DisplayObject 實體相對於 3D 父輩容器從原始方向旋轉的 x 軸旋轉 (以度數為單位)。 | DisplayObject | ||
rotationY : Number
表示 DisplayObject 實體相對於 3D 父輩容器從原始方向旋轉的 y 軸旋轉 (以度數為單位)。 | DisplayObject | ||
rotationZ : Number
表示 DisplayObject 實體相對於 3D 父輩容器從原始方向旋轉的 z 軸旋轉 (以度數為單位)。 | DisplayObject | ||
scale9Grid : Rectangle
目前產生效用的縮放格線。 | DisplayObject | ||
scaleX : Number [覆寫]
會將目前組件的寬度乘以縮放比例係數。 | UIComponent | ||
scaleY : Number [覆寫]
會將目前組件的高度乘以縮放比例係數。 | UIComponent | ||
scaleZ : Number
指出從物件註冊點套用的物件深度縮放 (百分比)。 | DisplayObject | ||
scrollPosition : Number
會取得或設定目前的捲動位置,並更新縮圖的位置。 | ScrollBar | ||
scrollRect : Rectangle
顯示物件的捲動矩形範圍。 | DisplayObject | ||
scrollTarget : DisplayObject
將 TextField 實體或 TLFTextField 實體註冊至 ScrollBar 組件實體。 | UIScrollBar | ||
softKeyboard : String
控制軟體鍵盤的外觀。 | InteractiveObject | ||
softKeyboardInputAreaOfInterest : Rectangle
定義顯示軟體鍵盤時,應保留於螢幕上的區域 (iOS 未提供)。 | InteractiveObject | ||
soundTransform : flash.media:SoundTransform
控制此 Sprite 的聲音。 | Sprite | ||
stage : Stage [唯讀]
顯示物件的「舞台」。 | DisplayObject | ||
tabChildren : Boolean
判斷物件的子系是否支援啟用定位鍵。 | DisplayObjectContainer | ||
tabEnabled : Boolean
會指定這個物件是否在停駐點順序中。 | InteractiveObject | ||
tabIndex : int
會指定 SWF 檔中的物件停駐點順序。 | InteractiveObject | ||
textSnapshot : flash.text:TextSnapshot [唯讀]
傳回此 DisplayObjectContainer 實體的 TextSnapshot 物件。 | DisplayObjectContainer | ||
transform : flash.geom:Transform
這是一個物件,具有和顯示物件的矩陣、顏色轉換和像素邊界有關的屬性。 | DisplayObject | ||
useHandCursor : Boolean
指示當指標滑入 Sprite,且其 buttonMode 屬性設為 true 時,是否要出現指示手掌 (手掌游標) 的 Boolean 值。 | Sprite | ||
visible : Boolean [覆寫]
會取得或設定值,指出目前組件實體是否為可見。 | UIComponent | ||
width : Number [覆寫]
會取得或設定組件的寬度,以像素為單位。 | ScrollBar | ||
x : Number [覆寫]
會取得或設定 x 座標,代表組件在其父輩容器內的 x 軸位置。 | UIComponent | ||
y : Number [覆寫]
會取得或設定 y 座標,代表組件在其父輩容器內的 y 軸位置。 | UIComponent | ||
z : Number
表示 DisplayObject 實體相對於 3D 父輩容器的 z 座標位置 (沿著 z 軸)。 | DisplayObject |
方法 | 定義自 | ||
---|---|---|---|
建立新的 UIScrollBar 組件實體。 | UIScrollBar | ||
將 DisplayObject 子實體加入至此 DisplayObjectContainer 實體。 | DisplayObjectContainer | ||
將 DisplayObject 子實體加入至此 DisplayObjectContainer 實體。 | DisplayObjectContainer | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
會在 EventDispatcher 物件註冊事件偵聽程式,以便讓偵聽程式收到事件的通知。 | EventDispatcher | ||
指出安全性限制是否會造成傳回的清單 (可用指定的 point 點呼叫 DisplayObjectContainer.getObjectsUnderPoint() 方法來取得) 省略任何顯示物件。 | DisplayObjectContainer | ||
從此組件實體刪除某種樣式屬性。 | UIComponent | ||
判斷指定的顯示物件是否為 DisplayObjectContainer 實體的子系,或為實體本身。 | DisplayObjectContainer | ||
會將事件傳送到事件流程。 | EventDispatcher | ||
會顯示或隱藏此組件上的焦點指示器。 | UIComponent | ||
會起始立即繪製作業,而不需像 invalidateNow 一樣使所有項目無效化。 | UIComponent | ||
傳回可定義顯示物件區域 (相對於 targetCoordinateSpace 物件的座標系統) 的矩形。 | DisplayObject | ||
傳回存在於指定索引位置的子顯示物件實體。 | DisplayObjectContainer | ||
傳回具有指定名稱的子顯示物件。 | DisplayObjectContainer | ||
傳回 child DisplayObject 實體的索引位置。 | DisplayObjectContainer | ||
會擷取目前成為焦點的物件。 | UIComponent | ||
傳回位於指定點底下,且屬於此 DisplayObjectContainer 實體之子系 (或孫系,以下類推) 的物件陣列。 | DisplayObjectContainer | ||
根據 targetCoordinateSpace 參數所定義的座標系統,並排除形狀上的任何筆畫,傳回可定義顯示物件邊界的矩形。 | DisplayObject | ||
會擷取在組件樣式查閱鏈中設定的樣式屬性。 | UIComponent | ||
[靜態]
會擷取目前組件的預設樣式對應。 | UIScrollBar | ||
將 point 物件從「舞台」(全域) 座標轉換成顯示物件的 (區域) 座標。 | DisplayObject | ||
將二維點從「舞台」(全域) 座標轉換為三維顯示物件的 (區域) 座標。 | DisplayObject | ||
會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。 | EventDispatcher | ||
指出物件是否有已定義的指定屬性。 | Object | ||
評估顯示物件的範圍框,看它是否與 obj 顯示物件的範圍框重疊或相交。 | DisplayObject | ||
評估顯示物件,看它是否與 x 和 y 參數所指定的點重疊或相交。 | DisplayObject | ||
會將屬性標示為無效,除非另有指定,否則會在下一個影格上重繪組件。 | UIComponent | ||
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | ||
將三維顯示物件的 (區域) 座標的三維點轉換為「舞台」(全域) 座標中的二維點。 | DisplayObject | ||
將 point 物件從顯示物件的 (區域) 座標轉換成「舞台」(全域) 座標。 | DisplayObject | ||
[靜態]
會將多種類別中的樣式合併為一個物件。 | UIComponent | ||
將組件移至其父輩內指定的位置。 | UIComponent | ||
指出指定的屬性是否存在,以及是否可列舉。 | Object | ||
將指定的 child DisplayObject 實體從 DisplayObjectContainer 實體的子清單中移除。 | DisplayObjectContainer | ||
從 DisplayObjectContainer 子清單中的指定索引位置移除子 DisplayObject。 | DisplayObjectContainer | ||
將所有 child DisplayObject 實體從 DisplayObjectContainer 實體的子清單中移除。 | DisplayObjectContainer | ||
會從 EventDispatcher 物件移除偵聽程式。 | EventDispatcher | ||
升起顯示虛擬鍵盤。 | InteractiveObject | ||
變更顯示物件容器中現有子系的位置。 | DisplayObjectContainer | ||
將焦點設定到此組件。 | UIComponent | ||
為迴圈作業設定動態屬性的可用性。 | Object | ||
setScrollProperties(pageSize:Number, minScrollPosition:Number, maxScrollPosition:Number, pageScrollSize:Number = 0):void [覆寫]
會設定 ScrollBar 組件的範圍和檢視區域大小。 | UIScrollBar | ||
[覆寫]
會將組件設定為指定的寬度和高度。 | ScrollBar | ||
針對此組件實體設定樣式屬性。 | UIComponent | ||
讓使用者拖曳指定的 sprite。 | Sprite | ||
讓使用者將指定的 Sprite 拖曳至觸控裝置上。 | Sprite | ||
遞迴停止執行所有 MovieClips 的時間軸根源於此物件。 | DisplayObjectContainer | ||
結束 startDrag() 方法。 | Sprite | ||
結束觸控裝置使用的 startTouchDrag() 方法。 | Sprite | ||
替換兩個指定子物件的 z 順序 (深度階層,由前至後順序)。 | DisplayObjectContainer | ||
在子清單的兩個指定索引位置,替換子物件的 z 順序 (深度階層,由前至後順序)。 | DisplayObjectContainer | ||
傳回代表此物件的字串,根據地區特定慣例進行格式化。 | Object | ||
會傳回指定之物件的字串形式。 | Object | ||
會強制捲軸立即更新其捲動屬性。 | UIScrollBar | ||
會確認此物件之屬性和版面的有效性並加以更新,並在必要時重繪此物件。 | UIComponent | ||
會傳回指定之物件的基本值。 | Object | ||
檢查此 EventDispatcher 物件是否已註冊事件偵聽程式,或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。 | EventDispatcher |
direction | 屬性 |
direction:String
[覆寫] 語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會取得或設定值,指出捲軸的捲動方向是垂直或水平。 有效值為 ScrollBarDirection.HORIZONTAL
與 ScrollBarDirection.VERTICAL
。
預設值為 ScrollBarDirection.VERTICAL。
實作
override public function get direction():String
override public function set direction(value:String):void
相關 API 元素
範例 ( 如何使用本範例 )
import fl.controls.UIScrollBar; import fl.controls.ScrollBarDirection; var url:String = "http://www.helpexamples.com/flash/text/lorem.txt"; var uLdr:URLLoader = new URLLoader(new URLRequest(url)); uLdr.addEventListener(Event.COMPLETE, completeHandler); var tf:TextField = new TextField(); tf.width = 320; tf.height = 140; tf.x = 10; tf.y = 10; tf.border = true; tf.multiline = true; tf.wordWrap = false; addChild(tf) var hScrollBar:UIScrollBar = new UIScrollBar(); hScrollBar.direction = ScrollBarDirection.HORIZONTAL; hScrollBar.move(tf.x, tf.y + tf.height); hScrollBar.width = tf.width; hScrollBar.scrollTarget = tf; addChild(hScrollBar); var vScrollBar:UIScrollBar = new UIScrollBar(); vScrollBar.direction = ScrollBarDirection.VERTICAL; vScrollBar.move(tf.x + tf.width, tf.y); vScrollBar.height = tf.height; vScrollBar.scrollTarget = tf; addChild(vScrollBar); function completeHandler(event:Event):void { tf.text = event.target.data; hScrollBar.update(); vScrollBar.update(); }
import fl.controls.ScrollBarDirection; import fl.controls.UIScrollBar; var myTextField:TextField = new TextField(); myTextField.width = 160; myTextField.height = 120; myTextField.border = true; myTextField.x = 10; myTextField.y = 10; addChild(myTextField); var hScrollBar:UIScrollBar = new UIScrollBar(); hScrollBar.direction = ScrollBarDirection.HORIZONTAL; hScrollBar.scrollTarget = myTextField; hScrollBar.width = myTextField.width; hScrollBar.move(myTextField.x, myTextField.y + myTextField.height); addChild(hScrollBar); var myURLLoader:URLLoader = new URLLoader(); myURLLoader.addEventListener(Event.COMPLETE, completeHandler); myURLLoader.load(new URLRequest("http://www.helpexamples.com/flash/lorem.txt")); function completeHandler(event:Event):void { var txt:String = URLLoader(event.currentTarget).data as String; myTextField.text = txt; vScrollBar.update(); }
scrollTarget | 屬性 |
scrollTarget:DisplayObject
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
將 TextField 實體或 TLFTextField 實體註冊至 ScrollBar 組件實體。
實作
public function get scrollTarget():DisplayObject
public function set scrollTarget(value:DisplayObject):void
相關 API 元素
範例 ( 如何使用本範例 )
scrollTarget
屬性將其連結到文字欄位:
import fl.controls.UIScrollBar; var url:String = "http://www.helpexamples.com/flash/text/lorem.txt"; var tf:TextField = new TextField(); tf.x = 10; tf.y = 10; tf.width = 500; tf.height = 380; tf.wordWrap = true; addChild(tf); var myScrollBar:UIScrollBar = new UIScrollBar(); myScrollBar.move(tf.x + tf.width, tf.y); myScrollBar.height = tf.height; myScrollBar.scrollTarget = tf; addChild(myScrollBar); var uLdr:URLLoader = new URLLoader(); uLdr.addEventListener(Event.COMPLETE, completeHandler); uLdr.load(new URLRequest(url)); function completeHandler(event:Event):void { tf.text = URLLoader(event.target).data; myScrollBar.update(); }
UIScrollBar | () | 建構函式 |
public function UIScrollBar()
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
建立新的 UIScrollBar 組件實體。
getStyleDefinition | () | 方法 |
public static function getStyleDefinition():Object
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會擷取目前組件的預設樣式對應。 視組件使用的樣式而定,樣式對應會包含適用於組件的類型。 例如,disabledTextFormat
樣式會包含 null
值或 TextFormat 物件。 您可以使用這些樣式,並針對目前的組件呼叫 setStyle()
。 下列程式碼會覆寫指定組件上預設的 disabledTextFormat
樣式:
componentInstance.setStyle("disabledTextFormat", new TextFormat());
Object — 預設的樣式物件。
|
相關 API 元素
setScrollProperties | () | 方法 |
override public function setScrollProperties(pageSize:Number, minScrollPosition:Number, maxScrollPosition:Number, pageScrollSize:Number = 0):void
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會設定 ScrollBar 組件的範圍和檢視區域大小。 ScrollBar 組件會更新箭頭按鈕的狀態,並依據該狀態變更捲動縮圖的大小。 所有的捲動屬性都是以 minScrollPosition
和 maxScrollPosition
為相對比例。 介於最大值和最小值之間的每個數字各代表一個捲動位置。
參數
pageSize:Number — 一頁的大小。 會決定縮圖的大小,以及按一下箭頭時捲軸移動的遞增量。
| |
minScrollPosition:Number — 捲動範圍底部。
| |
maxScrollPosition:Number — 捲動範圍的頂端。
| |
pageScrollSize:Number (default = 0 ) — 當按下軌道時移動的遞增量,以像素為單位。
|
相關 API 元素
update | () | 方法 |
public function update():void
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會強制捲軸立即更新其捲動屬性。 在使用 ActionScript 將文字加入到指定的 scrollTarget
文字欄位之後,然後需要重新整理捲軸時,必須執行此動作。
相關 API 元素
範例 ( 如何使用本範例 )
import fl.controls.UIScrollBar; var myTextField:TextField = new TextField(); myTextField.wordWrap = true; myTextField.width = 160; myTextField.height = 120; myTextField.border = true; myTextField.x = 10; myTextField.y = 10; addChild(myTextField); var vScrollBar:UIScrollBar = new UIScrollBar(); vScrollBar.scrollTarget = myTextField; vScrollBar.height = myTextField.height; vScrollBar.move(myTextField.x + myTextField.width, myTextField.y); addChild(vScrollBar); var myURLLoader:URLLoader = new URLLoader(); myURLLoader.addEventListener(Event.COMPLETE, completeHandler); myURLLoader.load(new URLRequest("http://www.helpexamples.com/flash/lorem.txt")); function completeHandler(event:Event):void { var txt:String = URLLoader(event.currentTarget).data as String; myTextField.text = txt; vScrollBar.update(); }
若要執行範例,請遵循下列步驟:
- 將 UIScrollBar 組件加入元件庫。
- 將此程式碼另存為 UIScrollBarExample.as,與 FLA 檔放在同一個目錄中。
- 將 FLA 檔中的 Document 類別設定為 UIScrollBarExample。
package { import fl.controls.UIScrollBar; import flash.display.Sprite; import flash.text.TextField; public class UIScrollBarExample extends Sprite { private var tf:TextField; private var sb:UIScrollBar = new UIScrollBar(); private var sampleText:String = "Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Phasellus vestibulum. Praesent in velit. Fusce scelerisque. Nullam fringilla. Aenean ut lacus at mi rutrum elementum. Suspendisse sit amet ligula et ipsum rhoncus sagittis. Aenean quis lacus. Nullam quis lorem. Integer pellentesque dictum lorem. In hendrerit lectus non orci. Sed vestibulum. Maecenas ornare, libero eu laoreet tristique, felis odio tincidunt nibh, et faucibus nibh tellus at metus. In hac habitasse platea dictumst. Nullam aliquam, dolor ut commodo dictum, ante justo dictum nisi, id suscipit elit sapien nec pede." public function UIScrollBarExample() { createTextField(); assignScrollBar(); } private function createTextField():void { tf = new TextField(); tf.width = 200; tf.height = 100; tf.wordWrap = true; tf.multiline = true; tf.border = true; tf.text = sampleText; addChild(tf); } private function assignScrollBar():void { sb = new UIScrollBar(); sb.move(tf.x + tf.width, tf.y); sb.setSize(sb.width, tf.height); sb.scrollTarget = tf; addChild(sb); } } }
Tue Jun 12 2018, 03:47 PM Z