| 套件 | fl.containers |
| 類別 | public class ScrollPane |
| 繼承 | ScrollPane BaseScrollPane UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| 實作 | IFocusManagerComponent |
| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
注意:如果是從不同的網域或系統安全執行程序載入內容,則基於安全考量,可能無法讓您存取此內容的屬性。 如需有關網域安全性如何影響載入程序的詳細資訊,請參閱 ProLoader 類別。
注意:將非常大的影像檔載入至 ScrollPane 物件時,可能需要偵聽 complete 事件,然後使用 setSize() 方法來調整 ScrollPane 大小。請參閱 complete 事件範例。
相關 API 元素
| 屬性 | 定義自 | ||
|---|---|---|---|
![]() | accessibilityImplementation : AccessibilityImplementation
對此 InteractiveObject 實體目前的輔助功能實作 (AccessibilityImplementation)。 | InteractiveObject | |
![]() | accessibilityProperties : AccessibilityProperties
此顯示物件的目前輔助功能選項。 | DisplayObject | |
![]() | alpha : Number
指出所指定物件的 Alpha 透明度值。 | DisplayObject | |
![]() | blendMode : String
來自 BlendMode 類別的值,會指定要使用何種混合模式。 | DisplayObject | |
![]() | blendShader : Shader [唯寫]
設定用來混合前景和背景的著色器。 | DisplayObject | |
![]() | buttonMode : Boolean
可指定此 sprite 的按鈕模式。 | Sprite | |
| bytesLoaded : Number [唯讀]
會取得已載入之內容的位元組數。 | ScrollPane | ||
| bytesTotal : Number [唯讀]
會取得要載入的內容位元組總數。 | ScrollPane | ||
![]() | cacheAsBitmap : Boolean
如果設定為 true,Flash 執行階段會快取顯示物件的內部點陣圖表示法。 | DisplayObject | |
![]() | cacheAsBitmapMatrix : Matrix
如果為非 null,當 cacheAsBitmap 設定為 true 時,這個 Matrix 物件會定義顯示物件的顯示方法。 | DisplayObject | |
![]() | constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | |
| content : DisplayObject [唯讀]
會取得捲動窗格中所載入內容的參考。 | ScrollPane | ||
![]() | contextMenu : NativeMenu
指定與此物件有關聯的快顯選單。 | InteractiveObject | |
![]() | doubleClickEnabled : Boolean
會指定物件是否會收到 doubleClick 事件。 | InteractiveObject | |
![]() | dropTarget : DisplayObject [唯讀]
指定要將 sprite 拖曳至或丟棄至哪個顯示物件上。 | Sprite | |
![]() | enabled : Boolean
會取得或設定值,指出組件是否可以接受使用者互動。 | UIComponent | |
![]() | filters : Array
索引的陣列,其中包含目前和顯示物件相關的每個濾鏡物件。 | DisplayObject | |
![]() | focusEnabled : Boolean
會取得或設定 Boolean 值,指出組件是否可以在使用者按一下之後成為焦點。 | UIComponent | |
![]() | focusManager : IFocusManager
會取得或設定控制此組件及其同輩之焦點的 FocusManager。 | UIComponent | |
![]() | focusRect : Object
會指定這個物件是否會顯示焦點矩形。 | InteractiveObject | |
![]() | graphics : Graphics [唯讀]
指定屬於此 sprite 物件的 Graphics 物件,其中可能會產生向量繪圖命令。 | Sprite | |
![]() | height : Number [覆寫]
會取得或設定組件的高度,以像素為單位。 | UIComponent | |
![]() | hitArea : Sprite
指定用來當作 sprite 作用區域的另一個 sprite。 | Sprite | |
![]() | horizontalLineScrollSize : Number
會取得或設定值,描述當按一下捲動箭頭時,內容要水平捲動的量。 | BaseScrollPane | |
![]() | horizontalPageScrollSize : Number
會取得或設定當按下捲軸軌道時,捲動縮圖在水平捲軸上移動的像素數目。 | BaseScrollPane | |
![]() | horizontalScrollBar : ScrollBar [唯讀]
會取得水平捲軸的參考。 | BaseScrollPane | |
![]() | horizontalScrollPolicy : String
會取得或設定指出水平捲軸狀態的值。 | BaseScrollPane | |
![]() | horizontalScrollPosition : Number
會取得或設定值,描述水平捲軸在捲動窗格中的水平位置,以像素為單位。 | BaseScrollPane | |
![]() | loaderInfo : LoaderInfo [唯讀]
會傳回 LoaderInfo 物件,其中包含關於載入此顯示物件所屬之檔案的資訊。 | DisplayObject | |
![]() | mask : DisplayObject
呼叫之顯示物件會以指定的 mask 物件遮蓋。 | DisplayObject | |
![]() | maxHorizontalScrollPosition : Number [唯讀]
會取得目前內容的最大水平捲動位置,以像素為單位。 | BaseScrollPane | |
![]() | maxVerticalScrollPosition : Number [唯讀]
會取得目前內容的最大垂直捲動位置,以像素為單位。 | BaseScrollPane | |
![]() | metaData : Object
如果中繼資料是透過 PlaceObject4 標籤與 SWF 檔案中的這個 DisplayObject 實體一同儲存,則會取得 DisplayObject 實體的中繼資料物件。 | DisplayObject | |
![]() | 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 | |
![]() | parent : DisplayObjectContainer [唯讀]
指出包含此顯示物件的 DisplayObjectContainer 物件。 | DisplayObject | |
| percentLoaded : Number [唯讀]
會取得介於 0 和 100 之間的數字,表示已載入內容的百分比。 | ScrollPane | ||
![]() | 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 | |
| scrollDrag : Boolean
會取得或設定值,指出當使用者在捲動窗格中拖曳內容時,是否發生捲動。 | ScrollPane | ||
![]() | scrollRect : Rectangle
顯示物件的捲動矩形範圍。 | DisplayObject | |
![]() | softKeyboard : String
控制軟體鍵盤的外觀。 | InteractiveObject | |
![]() | softKeyboardInputAreaOfInterest : Rectangle
定義顯示軟體鍵盤時,應保留於螢幕上的區域 (iOS 未提供)。 | InteractiveObject | |
![]() | soundTransform : flash.media:SoundTransform
控制此 Sprite 的聲音。 | Sprite | |
| source : Object
會取得或設定絕對或相對 URL,它會識別要載入之 SWF 或影像檔的位置、元件庫中影片片段的類別名稱、顯示物件的參考,或是識別與組件位於相同層級的影片片段實體名稱。 | ScrollPane | ||
![]() | 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 | |
![]() | useBitmapScrolling : Boolean
設定為 true 時,捲動內容的 cacheAsBitmap 屬性會設定為 true;設定為 false 時,則會關閉這個值。 | BaseScrollPane | |
![]() | useHandCursor : Boolean
指示當指標滑入 Sprite,且其 buttonMode 屬性設為 true 時,是否要出現指示手掌 (手掌游標) 的 Boolean 值。 | Sprite | |
![]() | verticalLineScrollSize : Number
會取得或設定值,描述當按一下捲動箭頭時,要垂直捲動多少像素。 | BaseScrollPane | |
![]() | verticalPageScrollSize : Number
會取得或設定當按下捲軸軌道時,捲動縮圖在垂直捲軸上移動的像素數目。 | BaseScrollPane | |
![]() | verticalScrollBar : ScrollBar [唯讀]
會取得垂直捲軸的參考。 | BaseScrollPane | |
![]() | verticalScrollPolicy : String
會取得或設定指出垂直捲軸狀態的值。 | BaseScrollPane | |
![]() | verticalScrollPosition : Number
會取得或設定值,描述垂直捲軸在捲動窗格中的垂直位置,以像素為單位。 | BaseScrollPane | |
![]() | visible : Boolean [覆寫]
會取得或設定值,指出目前組件實體是否為可見。 | UIComponent | |
![]() | width : Number [覆寫]
會取得或設定組件的寬度,以像素為單位。 | UIComponent | |
![]() | x : Number [覆寫]
會取得或設定 x 座標,代表組件在其父輩容器內的 x 軸位置。 | UIComponent | |
![]() | y : Number [覆寫]
會取得或設定 y 座標,代表組件在其父輩容器內的 y 軸位置。 | UIComponent | |
![]() | z : Number
表示 DisplayObject 實體相對於 3D 父輩容器的 z 座標位置 (沿著 z 軸)。 | DisplayObject | |
| 方法 | 定義自 | ||
|---|---|---|---|
建立新的 ScrollPane 組件實體。 | ScrollPane | ||
![]() |
將 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 | |
[靜態]
會擷取目前組件的預設樣式對應。 | ScrollPane | ||
![]() |
將 point 物件從「舞台」(全域) 座標轉換成顯示物件的 (區域) 座標。 | DisplayObject | |
![]() |
將二維點從「舞台」(全域) 座標轉換為三維顯示物件的 (區域) 座標。 | DisplayObject | |
![]() |
會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。 | EventDispatcher | |
![]() |
指出物件是否有已定義的指定屬性。 | Object | |
![]() |
評估顯示物件的範圍框,看它是否與 obj 顯示物件的範圍框重疊或相交。 | DisplayObject | |
![]() |
評估顯示物件,看它是否與 x 和 y 參數所指定的點重疊或相交。 | DisplayObject | |
![]() |
會將屬性標示為無效,除非另有指定,否則會在下一個影格上重繪組件。 | UIComponent | |
![]() |
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | |
此方法的 request 參數只會接受 URLRequest 物件,此物件的 source 屬性包含字串、類別或 URLRequest 物件。 | ScrollPane | ||
![]() |
將三維顯示物件的 (區域) 座標的三維點轉換為「舞台」(全域) 座標中的二維點。 | DisplayObject | |
![]() |
將 point 物件從顯示物件的 (區域) 座標轉換成「舞台」(全域) 座標。 | DisplayObject | |
![]() | [靜態]
會將多種類別中的樣式合併為一個物件。 | UIComponent | |
![]() |
將組件移至其父輩內指定的位置。 | UIComponent | |
![]() |
指出指定的屬性是否存在,以及是否可列舉。 | Object | |
會重新載入捲動窗格的內容。 | ScrollPane | ||
![]() |
將指定的 child DisplayObject 實體從 DisplayObjectContainer 實體的子清單中移除。 | DisplayObjectContainer | |
![]() |
從 DisplayObjectContainer 子清單中的指定索引位置移除子 DisplayObject。 | DisplayObjectContainer | |
![]() |
將所有 child DisplayObject 實體從 DisplayObjectContainer 實體的子清單中移除。 | DisplayObjectContainer | |
![]() |
會從 EventDispatcher 物件移除偵聽程式。 | EventDispatcher | |
![]() |
升起顯示虛擬鍵盤。 | InteractiveObject | |
![]() |
變更顯示物件容器中現有子系的位置。 | DisplayObjectContainer | |
![]() |
將焦點設定到此組件。 | UIComponent | |
![]() |
為迴圈作業設定動態屬性的可用性。 | Object | |
![]() |
會將組件設定為指定的寬度和高度。 | UIComponent | |
![]() |
針對此組件實體設定樣式屬性。 | UIComponent | |
![]() |
讓使用者拖曳指定的 sprite。 | Sprite | |
![]() |
讓使用者將指定的 Sprite 拖曳至觸控裝置上。 | Sprite | |
![]() |
遞迴停止執行所有 MovieClips 的時間軸根源於此物件。 | DisplayObjectContainer | |
![]() |
結束 startDrag() 方法。 | Sprite | |
![]() |
結束觸控裝置使用的 startTouchDrag() 方法。 | Sprite | |
![]() |
替換兩個指定子物件的 z 順序 (深度階層,由前至後順序)。 | DisplayObjectContainer | |
![]() |
在子清單的兩個指定索引位置,替換子物件的 z 順序 (深度階層,由前至後順序)。 | DisplayObjectContainer | |
![]() |
傳回代表此物件的字串,根據地區特定慣例進行格式化。 | Object | |
![]() |
會傳回指定之物件的字串形式。 | Object | |
會根據內容的寬度和高度,重新整理捲軸屬性。 | ScrollPane | ||
![]() |
會確認此物件之屬性和版面的有效性並加以更新,並在必要時重繪此物件。 | UIComponent | |
![]() |
會傳回指定之物件的基本值。 | Object | |
![]() |
檢查此 EventDispatcher 物件是否已註冊事件偵聽程式,或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。 | EventDispatcher | |
| 事件 | 摘要 | 定義自 | ||
|---|---|---|---|---|
![]() | [廣播事件] 當 Flash Player 或 AIR 應用程式取得作業系統焦點並成為作用中時傳送。 | EventDispatcher | ||
![]() | 當顯示物件加入顯示清單中時傳送。 | DisplayObject | ||
![]() | 會在顯示物件加入舞台上的顯示清單時,以直接或是透過加入包含該顯示物件之子樹狀結構的方式傳送。 | DisplayObject | ||
![]() | 當使用者從文字快顯選單中選取「清除」(或「刪除」) 時傳送。 | InteractiveObject | ||
![]() | 會當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置主按鈕時傳送。 | InteractiveObject | ||
| 當內容載入完成時傳送。 | ScrollPane | |||
![]() | 當使用者手勢在 AIR 應用程式中觸發與此互動式物件相關聯的快顯選單時傳送。 | InteractiveObject | ||
![]() | 當使用者針對複製作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「複製」時傳送。 | InteractiveObject | ||
![]() | 當使用者針對剪下作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「剪下」時傳送。 | InteractiveObject | ||
![]() | [廣播事件] 當 Flash Player 或 AIR 應用程式失去作業系統焦點並成為非作用中時傳送。 | EventDispatcher | ||
![]() | 在 InteractiveObject 物件的 doubleClickEnabled 旗標設為 true 的情況下,當使用者在相同的物件上方連續兩次快速按下並放開指標裝置主要按鈕時傳送。 | InteractiveObject | ||
![]() | [廣播事件] 當播放磁頭進入新影格時傳送。 | DisplayObject | ||
![]() | [廣播事件] 當播放磁頭結束目前影格時傳送。 | DisplayObject | ||
![]() | 當顯示物件取得焦點之後傳送。 | InteractiveObject | ||
![]() | 當顯示物件失去焦點時傳送。 | InteractiveObject | ||
![]() | [廣播事件] 在影格顯示物件的建構函式執行之後,且影格指令碼執行之前傳送。 | DisplayObject | ||
![]() | 當使用者沿著觸控面與 InteractiveObject 實體建立接觸點 (例如沿著 Apple TV 的 Siri Remote 觸控面點選),某些裝置可能也會將此接觸解譯為數個觸控事件的組合。 | InteractiveObject | ||
![]() | 當使用在觸控裝置上的同一個 InteractiveObject 實體上按下兩個接觸點後送出 (例如在行動電話或平板電腦觸控螢幕的顯示物件上方,以兩支手指按下後鬆開)。 | InteractiveObject | ||
![]() | 當使用者在觸控裝置上,將接觸點移動到 InteractiveObject 實體上方後傳送 (例如,在行動電話或平板電腦觸控螢幕的顯示物件上,由左向右移動手指)。 | InteractiveObject | ||
![]() | 當使用者在 InteractiveObject 實體的接觸點上做出旋轉手勢後傳送 (例如兩指觸摸行動電話或平板電腦的觸控螢幕,然後手指在顯示物件上旋轉)。 | InteractiveObject | ||
![]() | 當使用者在與 InteractiveObject 實體的某個接觸點上做出揮動手勢後傳送 (例如,三指併在一起觸碰行動電話或平板電腦的觸控螢幕,然後在顯示物件上快速平行移動手指)。 | InteractiveObject | ||
![]() | 當使用者與 InteractiveObject 實體建立接觸點,然後在觸控裝置上點一下後送出 (例如,將多根手指放到行動電話或平板電腦觸控螢幕的顯示物件上以開啟選單,然後其中一根手點一下,選取選單項目)。 | InteractiveObject | ||
![]() | 當使用者在 InteractiveObject 實體的某個接觸點上做出放大縮小手勢後傳送 (例如兩指併在一起觸摸行動電話或平板電腦的觸控螢幕,然後手指在顯示物件上快速張開)。 | InteractiveObject | ||
![]() | 在組件的可見性從可見變更為隱藏之後傳送。 | UIComponent | ||
![]() | 這個事件會送出至任何支援 IME 內嵌輸入的用戶端應用程式。 | InteractiveObject | ||
| 當您可以存取載入的 SWF 檔案的屬性和方法時傳送。 | ScrollPane | |||
| 在發生輸入或輸出錯誤之後傳送。 | ScrollPane | |||
![]() | 會當使用者按下按鍵時傳送。 | InteractiveObject | ||
![]() | 當使用者嘗試使用鍵盤瀏覽變更焦點時傳送。 | InteractiveObject | ||
![]() | 會當使用者放開按鍵時傳送。 | InteractiveObject | ||
![]() | 當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置中間按鈕時傳送。 | InteractiveObject | ||
![]() | 當使用者將指向裝置的中間按鈕移至 InteractiveObject 實體上方按下時傳送。 | InteractiveObject | ||
![]() | 當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。 | InteractiveObject | ||
![]() | 當使用者將指向裝置按鈕移至 InteractiveObject 實體上方按下時傳送。 | InteractiveObject | ||
![]() | 會當使用者嘗試使用指向裝置變更焦點時傳送。 | InteractiveObject | ||
![]() | 會當指向裝置停在 InteractiveObject 上方的情況下使用者將其移動時傳送。 | InteractiveObject | ||
![]() | 會當使用者將指向裝置移開 InteractiveObject 實體時傳送。 | InteractiveObject | ||
![]() | 會當使用者將指向裝置移至 InteractiveObject 實體上方時傳送。 | InteractiveObject | ||
![]() | 當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。 | InteractiveObject | ||
![]() | 當滑鼠滾輪在 InteractiveObject 實體上方轉動時傳送。 | InteractiveObject | ||
![]() | 在移動組件之後傳送。 | UIComponent | ||
![]() | 當使用者釋放手勢時,由拖曳初始程式 InteractiveObject 傳送。 | InteractiveObject | ||
![]() | 已在目標 InteractiveObject 上放下拖曳的物件,而且已呼叫 DragManager.acceptDragDrop() 接受該放開的資料時,由此目標 InteractiveObject 傳送。 | InteractiveObject | ||
![]() | 當手勢進入 InteractiveObject 的邊界時,由此 InteractiveObject 傳送。 | InteractiveObject | ||
![]() | 當手勢離開 InteractiveObject 的邊界時,由此 InteractiveObject 傳送。 | InteractiveObject | ||
![]() | 當拖曳手勢還留在 InteractiveObject 的邊界內,由此 InteractiveObject 持續傳送。 | InteractiveObject | ||
![]() | 在呼叫 DragManager.doDrag() 進行拖曳作業初期,由指定做為拖曳初始程式的 InteractiveObject 傳送。 | InteractiveObject | ||
![]() | 在呼叫 DragManager.doDrag() 進行拖曳作業期間,由指定做為拖曳初始程式的 InteractiveObject 傳送。 | InteractiveObject | ||
| 在網路作業開始之後傳送。 | ScrollPane | |||
![]() | 當使用者針對貼上作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「貼上」時傳送。 | InteractiveObject | ||
| 當內容正在載入時傳送。 | ScrollPane | |||
![]() | 在使用者將作用中觸控筆往下移至超過螢幕鄰近偵測邊框時傳送。 | InteractiveObject | ||
![]() | 在使用者將作用中觸控筆提到螢幕鄰近偵測邊框時傳送。 | InteractiveObject | ||
![]() | 在使用者將作用中觸控筆移到螢幕上方,而其餘仍在鄰近偵測邊框內時傳送。 | InteractiveObject | ||
![]() | 在使用者將作用中觸控筆移出這個 InteractiveObject 之外,而其餘仍在螢幕的鄰近偵測邊框內時傳送。 | InteractiveObject | ||
![]() | 在使用者直接將作用中觸控筆移到這個 InteractiveObject 上方,而其餘仍在螢幕的鄰近偵測邊框內時傳送。 | InteractiveObject | ||
![]() | 在使用者將作用中觸控筆移出這個 InteractiveObject 及其任一子系之外,而其餘仍在螢幕的鄰近偵測邊框內時傳送。 | InteractiveObject | ||
![]() | 在使用者透過這個 InteractiveObject,從顯示清單中後代的物件樹狀結構之外移動作用中觸控筆時傳送 (而其餘仍在螢幕的鄰近偵測邊框內)。 | InteractiveObject | ||
![]() | 當使用者第一次按下 InteractiveObject 實體上方的按鈕,然後將指向裝置滑出 InteractiveObject 實體之後即放開指向裝置上的按鈕時傳送。 | InteractiveObject | ||
![]() | 會當顯示物件將要從顯示清單移除時傳送。 | DisplayObject | ||
![]() | 會在顯示物件即將從顯示清單移除時,以直接或是透過移除包含該顯示物件之子樹狀結構的方式傳送。 | DisplayObject | ||
![]() | [廣播事件] 當顯示清單將要更新和顯示時傳送。 | DisplayObject | ||
![]() | 在調整組件大小之後傳送。 | UIComponent | ||
![]() | 當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置右邊按鈕時傳送。 | InteractiveObject | ||
![]() | 當使用者將指向裝置按鈕移至 InteractiveObject 實體上方按下時傳送。 | InteractiveObject | ||
![]() | 當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。 | InteractiveObject | ||
![]() | 會當使用者將指向裝置移開 InteractiveObject 實體時傳送。 | InteractiveObject | ||
![]() | 會當使用者將指向裝置移至 InteractiveObject 實體上方時傳送。 | InteractiveObject | ||
| 定義 scroll 事件物件的 type 屬性值。 | ScrollPane | |||
| 在載入內容期間發生了安全性錯誤時傳送。 | ScrollPane | |||
![]() | 當使用者針對全選作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「全選」時傳送。 | InteractiveObject | ||
![]() | 在組件的可見性從隱藏變更為可見之後傳送。 | UIComponent | ||
![]() | 升起顯示軟體鍵盤之後立即傳送。 | InteractiveObject | ||
![]() | 升起顯示軟體鍵盤前立即傳送。 | InteractiveObject | ||
![]() | 降下隱藏軟體鍵盤之後立即傳送。 | InteractiveObject | ||
![]() | 在物件的 tabChildren 旗標值變更時傳送。 | InteractiveObject | ||
![]() | 在物件的 tabEnabled 旗標變更時傳送。 | InteractiveObject | ||
![]() | 在物件的 tabIndex 屬性值變更時傳送。 | InteractiveObject | ||
![]() | 當使用者輸入一或多文字的字元時送出。 | InteractiveObject | ||
![]() | 當使用者在第一次接觸觸控裝置後傳送 (例如手指觸摸行動電話或平板電腦的觸控螢幕)。 | InteractiveObject | ||
![]() | 當使用者在觸控裝置上移除接觸點後傳送 (例如在行動電話或平板電腦觸控螢幕上移開手指)。 | InteractiveObject | ||
![]() | 當使用者觸控裝置時傳送,並且連續不斷地傳送,直到接觸點移除為止。 | InteractiveObject | ||
![]() | 當使用者在觸控裝置中,將接觸點移出 InteractiveObject 實體後送出 (例如在行動電話或平板電腦的觸控螢幕上,將手指從顯示物件移至另一個顯示物件)。 | InteractiveObject | ||
![]() | 當使用者在觸控裝置中將接觸點移至 InteractiveObject 實體上方後送出 (例如在行動電話或平板電腦的觸控螢幕上,將手指從顯示物件外面的某一點,往顯示物件上方拖曳)。 | InteractiveObject | ||
![]() | 當使用者在觸控裝置上,將接觸點從 InteractiveObject 實體移出後送出 (例如,在行動電話或平板電腦的觸控螢幕上,將手指從顯示物件上方拖曳到顯示物件以外)。 | InteractiveObject | ||
![]() | 當使用者在觸控裝置中將接觸點移至 InteractiveObject 實體上方後送出 (例如在行動電話或平板電腦的觸控螢幕上,將手指從顯示物件外面的某一點,往顯示物件上方拖曳)。 | InteractiveObject | ||
![]() | 當使用者在觸控裝置的同一個 InteractiveObject 實體上,在原先開始接觸點放開後送出 (例如在行動電話或平板電腦觸控螢幕上的顯示物件上方,以手指按下某個點後又鬆開)。 | InteractiveObject | ||
樣式可分為一般樣式及與特定主題關聯的樣式兩種。如果是一般樣式,可以與任何主題搭配使用。如果是與特定主題關聯的樣式,只有在您的應用程式使用特定主題時才能使用該樣式。
| 樣式 | 說明 | 定義自 | ||
|---|---|---|---|---|
contentPadding | 類型: Number 格式: Length 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 捲動窗格內內容周圍的邊框大小 (以像素計)。 預設值為 0。 | ScrollPane | ||
![]() | 類型: Number 格式: Length 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 將 enabled 屬性設定為 false 時,會阻礙組件之間的互動,組件上會覆蓋白色,使組件內容看不清楚. | BaseScrollPane | ||
disabledSkin | 類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 停用捲動窗格時會顯示的外觀元素。 預設值為 ScrollPane_disabledSkin。 | ScrollPane | ||
![]() | 類型: flash.text.TextFormat 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 當按鈕停用時用來繪製組件標籤的 TextFormat 物件. | UIComponent | ||
![]() | 類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 當捲軸的向下箭頭按鈕停用時,用來作為其外觀元素的類別名稱. | BaseScrollPane | ||
![]() | 類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 當您按一下捲軸的向下箭頭按鈕時,用來作為此箭頭按鈕之外觀元素的類別名稱. | BaseScrollPane | ||
![]() | 類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 當滑鼠指標位於捲軸的向下箭頭按鈕上方時,用來作為此箭頭按鈕之外觀元素的類別名稱. | BaseScrollPane | ||
![]() | 類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 用來作為捲軸向下箭頭按鈕之外觀元素的類別名稱. | BaseScrollPane | ||
![]() | 類型: Number 格式: Length 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 分開組件外邊框與焦點指示器的外邊緣的邊框 (以像素計). | UIComponent | ||
![]() | 類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 用來顯示焦點指示器的外觀元素. | UIComponent | ||
![]() | 類型: Number 格式: Time 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 在傳送第二個 buttonDown 事件之前,第一個 buttonDown 事件傳送之後要等候的毫秒數. | BaseScrollPane | ||
![]() | 類型: Number 格式: Time 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 在發生以 repeatDelay 樣式指定的延遲之後,所傳送的 buttonDown 事件前後的間隔,以毫秒為單位. | BaseScrollPane | ||
![]() | 類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 用來作為捲動窗格背景的外觀元素. | BaseScrollPane | ||
![]() | 類型: flash.text.TextFormat 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 用來繪製組件標籤的 TextFormat 物件. | UIComponent | ||
![]() | 類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 用來指出縮圖之停用狀態的外觀元素. | BaseScrollPane | ||
![]() | 類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 當您按一下捲軸的縮圖時,用來作為此縮圖之外觀元素的類別名稱. | BaseScrollPane | ||
![]() | 類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 用來作為捲軸縮圖之圖示的類別名稱. | BaseScrollPane | ||
![]() | 類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 當滑鼠指標位於捲軸的縮圖上方時,用來作為此縮圖之外觀元素的類別名稱. | BaseScrollPane | ||
![]() | 類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 用來作為捲軸縮圖之外觀元素的類別名稱. | BaseScrollPane | ||
![]() | 類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 用來指出已停用軌道的外觀元素. | BaseScrollPane | ||
![]() | 類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 用來指出已停用外觀元素之按下狀態的外觀元素. | BaseScrollPane | ||
![]() | 類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 用來指出捲動軌道之滑鼠滑入狀態的外觀元素. | BaseScrollPane | ||
![]() | 類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 用來指出捲動軌道之滑鼠未按下狀態的外觀元素. | BaseScrollPane | ||
![]() | 類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 當捲軸的向上箭頭按鈕停用時,用來作為其外觀元素的類別名稱. | BaseScrollPane | ||
![]() | 類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 當您按一下捲軸的向上箭頭按鈕時,用來作為此箭頭按鈕之外觀元素的類別名稱. | BaseScrollPane | ||
![]() | 類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 當滑鼠指標位於捲軸的向上箭頭按鈕上方時,用來作為此箭頭按鈕之外觀元素的類別名稱. | BaseScrollPane | ||
![]() | 類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 用來作為捲軸向上箭頭按鈕之外觀元素的類別名稱. | BaseScrollPane | ||
upSkin | 類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 顯示在捲動窗格上的預設外觀元素。 預設值為 ScrollPane_upSkin。 | ScrollPane | ||
bytesLoaded | 屬性 |
bytesLoaded:Number [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會取得已載入之內容的位元組數。 當此屬性等於 bytesTotal 的值時,就表示已經載入所有的位元組。
預設值為 0。
實作
public function get bytesLoaded():Number相關 API 元素
範例 ( 如何使用本範例 )
import fl.containers.ScrollPane;
import fl.controls.ProgressBar;
var path:String = "test.jpg";
var sp:ScrollPane = new ScrollPane();
sp.move(10,10);
sp.setSize(530,300);
sp.addEventListener(ProgressEvent.PROGRESS,reportProgress);
sp.load(new URLRequest(path));
addChild(sp);
var progressBar:ProgressBar = new ProgressBar();
progressBar.move(10,320);
progressBar.setSize(530,50);
progressBar.source = sp;
addChild(progressBar);
function reportProgress(e:ProgressEvent):void {
trace(e.bytesLoaded + " loaded out of " + e.bytesTotal);
}
bytesTotal | 屬性 |
bytesTotal:Number [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會取得要載入的內容位元組總數。
預設值為 0。
實作
public function get bytesTotal():Number相關 API 元素
範例 ( 如何使用本範例 )
progress 和 complete 事件,顯示 bytesLoaded、bytesTotal 和 percentLoaded 屬性:
import fl.containers.ScrollPane;
var url:String = "http://www.helpexamples.com/flash/images/image1.jpg";
var myScrollPane:ScrollPane = new ScrollPane();
myScrollPane.setSize(320, 240);
myScrollPane.move(10, 10);
myScrollPane.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myScrollPane.addEventListener(Event.COMPLETE, completeHandler);
myScrollPane.load(new URLRequest(url));
addChild(myScrollPane);
function progressHandler(event:ProgressEvent):void {
var bLoaded:int = event.bytesLoaded;
var bTotal:int = event.bytesTotal;
var pctLoaded:int = int(event.currentTarget.percentLoaded);
trace("progress: " + bLoaded + " of " + bTotal + " bytes loaded (" + pctLoaded + "%)");
}
function completeHandler(event:Event):void {
trace("complete:");
}
content | 屬性 |
content:DisplayObject [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會取得捲動窗格中所載入內容的參考。
預設值為 null。
實作
public function get content():DisplayObject範例 ( 如何使用本範例 )
import fl.containers.ScrollPane;
import fl.controls.NumericStepper;
var ns:NumericStepper = new NumericStepper();
ns.minimum = 10;
ns.maximum = 100;
ns.stepSize = 10;
ns.value = ns.maximum;
ns.addEventListener(Event.CHANGE, updateScrollPaneContentAlpha);
addChild(ns);
var sp:ScrollPane = new ScrollPane();
sp.move(0,30);
sp.setSize(180, 160);
sp.source = "http://www.helpexamples.com/flash/images/image2.jpg";
addChild(sp);
function updateScrollPaneContentAlpha(e:Event):void {
sp.content.alpha = e.target.value / 100;
}
import fl.containers.ScrollPane;
import fl.controls.Button;
import fl.events.ComponentEvent;
var MAX_SCROLLPANE_WIDTH:uint = 400;
var MAX_SCROLLPANE_HEIGHT:uint = 267;
var url:String = "http://www.helpexamples.com/flash/images/image1.jpg";
var myScrollPane:ScrollPane = new ScrollPane();
myScrollPane.scrollDrag = true;
myScrollPane.cacheAsBitmap = true;
myScrollPane.setSize(MAX_SCROLLPANE_WIDTH, MAX_SCROLLPANE_HEIGHT);
myScrollPane.move(10, 10);
myScrollPane.addEventListener(Event.COMPLETE, completeHandler);
myScrollPane.load(new URLRequest(url));
addChild(myScrollPane);
var zoomInButton:Button = new Button();
zoomInButton.autoRepeat = true;
zoomInButton.enabled = false;
zoomInButton.label = "Zoom in (+)";
zoomInButton.move(420, 10);
zoomInButton.addEventListener(ComponentEvent.BUTTON_DOWN, zoomInHandler);
addChild(zoomInButton);
var zoomOutButton:Button = new Button();
zoomOutButton.autoRepeat = true;
zoomOutButton.enabled = false;
zoomOutButton.label = "Zoom out (-)";
zoomOutButton.move(420, 40);
zoomOutButton.addEventListener(ComponentEvent.BUTTON_DOWN, zoomOutHandler);
addChild(zoomOutButton);
var cacheButton:Button = new Button();
cacheButton.enabled = false;
cacheButton.emphasized = myScrollPane.cacheAsBitmap;
cacheButton.label = "cacheAsBitmap";
cacheButton.toggle = true;
cacheButton.selected = myScrollPane.cacheAsBitmap;
cacheButton.move(420, 70);
cacheButton.addEventListener(Event.CHANGE, changeHandler);
addChild(cacheButton);
function completeHandler(event:Event):void {
zoomInButton.enabled = true;
zoomOutButton.enabled = true;
cacheButton.enabled = true;
myScrollPane.removeEventListener(Event.COMPLETE, completeHandler);
}
function changeHandler(event:Event):void {
myScrollPane.cacheAsBitmap = !myScrollPane.cacheAsBitmap;
cacheButton.emphasized = myScrollPane.cacheAsBitmap;
}
function zoomInHandler(event:ComponentEvent):void {
var zoomLvl:Number = myScrollPane.content.scaleX * 1.1;
updateSP(zoomLvl);
}
function zoomOutHandler(event:ComponentEvent):void {
var zoomLvl:Number = myScrollPane.content.scaleX / 1.1;
updateSP(zoomLvl);
}
function updateSP(newScale:Number):void {
var img:DisplayObject = myScrollPane.content as DisplayObject;
img.scaleY = newScale;
img.scaleX = newScale;
myScrollPane.width = Math.min(img.width, MAX_SCROLLPANE_WIDTH);
myScrollPane.height = Math.min(img.height, MAX_SCROLLPANE_HEIGHT);
myScrollPane.update();
}
percentLoaded | 屬性 |
percentLoaded:Number [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會取得介於 0 和 100 之間的數字,表示已載入內容的百分比。 如果是從元件庫載入的資源,而非外部載入的內容,則 percentLoaded 屬性會設定為 0。
預設值為 0。
實作
public function get percentLoaded():Number相關 API 元素
範例 ( 如何使用本範例 )
progress 和 complete 事件,顯示 bytesLoaded、bytesTotal 和 percentLoaded 屬性:
import fl.containers.ScrollPane;
var url:String = "http://www.helpexamples.com/flash/images/image1.jpg";
var myScrollPane:ScrollPane = new ScrollPane();
myScrollPane.setSize(320, 240);
myScrollPane.move(10, 10);
myScrollPane.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myScrollPane.addEventListener(Event.COMPLETE, completeHandler);
myScrollPane.load(new URLRequest(url));
addChild(myScrollPane);
function progressHandler(event:ProgressEvent):void {
var bLoaded:int = event.bytesLoaded;
var bTotal:int = event.bytesTotal;
var pctLoaded:int = int(event.currentTarget.percentLoaded);
trace("progress: " + bLoaded + " of " + bTotal + " bytes loaded (" + pctLoaded + "%)");
}
function completeHandler(event:Event):void {
trace("complete:");
}
scrollDrag | 屬性 |
scrollDrag:Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會取得或設定值,指出當使用者在捲動窗格中拖曳內容時,是否發生捲動。 值為 true 表示使用者拖曳內容時會發生捲動;值為 false 則表示不會發生。
預設值為 false。
實作
public function get scrollDrag():Boolean public function set scrollDrag(value:Boolean):void相關 API 元素
範例 ( 如何使用本範例 )
import fl.containers.ScrollPane;
import fl.events.ScrollEvent;
var myScrollPane:ScrollPane = new ScrollPane();
myScrollPane.scrollDrag = true;
myScrollPane.source = "http://www.helpexamples.com/flash/images/image2.jpg";
myScrollPane.addEventListener(ScrollEvent.SCROLL, scrollHandler);
myScrollPane.move(10, 10);
addChild(myScrollPane);
function scrollHandler(event:ScrollEvent):void {
var mySP:ScrollPane = event.currentTarget as ScrollPane;
trace("scrolling");
trace("\t" + "direction:", event.direction);
trace("\t" + "position:", event.position);
trace("\t" + "horizontalScrollPosition:", mySP.horizontalScrollPosition, "of", mySP.maxHorizontalScrollPosition);
trace("\t" + "verticalScrollPosition:", mySP.verticalScrollPosition, "of", mySP.maxVerticalScrollPosition);
}
source | 屬性 |
source:Object| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會取得或設定絕對或相對 URL,它會識別要載入之 SWF 或影像檔的位置、元件庫中影片片段的類別名稱、顯示物件的參考,或是識別與組件位於相同層級的影片片段實體名稱。
有效的影像檔格式包括 GIF、PNG 和 JPEG。 若要使用 URLRequest 物件來載入資源,請使用 load() 方法。
預設值為 null。
實作
public function get source():Object public function set source(value:Object):void相關 API 元素
範例 ( 如何使用本範例 )
source 屬性,將外部影像載入至 ScrollPane 組件:
import fl.containers.ScrollPane; var myScrollPane:ScrollPane = new ScrollPane(); myScrollPane.source = "http://www.helpexamples.com/flash/images/image1.jpg"; myScrollPane.setSize(320, 240); myScrollPane.move(10, 10); addChild(myScrollPane);
source 屬性,從元件庫將影片片段元件載入至 ScrollPane 組件:
import fl.containers.ScrollPane; var myScrollPane:ScrollPane = new ScrollPane(); myScrollPane.source = Box; myScrollPane.setSize(320, 240); myScrollPane.move(10, 10); addChild(myScrollPane);
ScrollPane | () | 建構函式 |
public function ScrollPane()| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
建立新的 ScrollPane 組件實體。
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 元素
範例 ( 如何使用本範例 )
import fl.controls.*;
import fl.containers.*;
import fl.controls.listClasses.*;
import fl.controls.dataGridClasses.*;
import fl.controls.progressBarClasses.*;
import fl.core.UIComponent;
import fl.data.DataProvider;
var dp:DataProvider = new DataProvider();
dp.addItem( { label: "BaseScrollPane", data:BaseScrollPane } );
dp.addItem( { label: "Button", data:Button } );
dp.addItem( { label: "CellRenderer", data:CellRenderer } );
dp.addItem( { label: "CheckBox", data:CheckBox } );
dp.addItem( { label: "ColorPicker", data:ColorPicker } );
dp.addItem( { label: "ComboBox", data:ComboBox } );
dp.addItem( { label: "DataGrid", data:DataGrid } );
dp.addItem( { label: "HeaderRenderer", data:HeaderRenderer } );
dp.addItem( { label: "ImageCell", data:ImageCell } );
dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } );
dp.addItem( { label: "Label", data:Label } );
dp.addItem( { label: "List", data:List } );
dp.addItem( { label: "NumericStepper", data:NumericStepper } );
dp.addItem( { label: "ProgressBar", data:ProgressBar } );
dp.addItem( { label: "RadioButton", data:RadioButton } );
dp.addItem( { label: "ScrollPane", data:ScrollPane } );
dp.addItem( { label: "Slider", data:Slider } );
dp.addItem( { label: "TextArea", data:TextArea } );
dp.addItem( { label: "TextInput", data:TextInput } );
dp.addItem( { label: "TileList", data:TileList } );
dp.addItem( { label: "UILoader", data:UILoader } );
dp.addItem( { label: "UIComponent", data:UIComponent } );
var cb:ComboBox = new ComboBox();
cb.move(10,10);
cb.setSize(300,25);
cb.prompt = "Select a component to view its styles";
cb.rowCount = 12;
cb.dataProvider = dp;
cb.addEventListener(Event.CHANGE, showStyleDefinition);
addChild(cb);
var dg:DataGrid = new DataGrid();
dg.setSize(425,300);
dg.move(10,50);
dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ];
addChild(dg);
function showStyleDefinition(e:Event):void {
var componentClass:Class = e.target.selectedItem.data as Class;
var styles:Object = componentClass["getStyleDefinition"].call(this);
trace(styles.toString());
var styleData:DataProvider = new DataProvider();
for(var i:* in styles) {
trace(i + " : " + styles[i]);
styleData.addItem( { StyleName:i, DefaultValue:styles[i] } );
}
styleData.sortOn("StyleName");
dg.dataProvider = styleData;
}
load | () | 方法 |
public function load(request:URLRequest, context:LoaderContext = null):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
此方法的 request 參數只會接受 URLRequest 物件,此物件的 source 屬性包含字串、類別或 URLRequest 物件。 根據預設,LoaderContext 物件會使用目前的網域做為應用程式網域。 若要指定不同的應用程式網域值、檢查原則檔,或變更安全性網域,請初始化新的 LoaderContext 物件,並將它傳遞至此方法。
參數
request:URLRequest — 要用來將影像載入至捲動窗格中的 URLRequest 物件。
| |
context:LoaderContext (default = null) — LoaderContext 物件,可設定載入作業的內容。
|
相關 API 元素
範例 ( 如何使用本範例 )
import fl.containers.ScrollPane;
var request:URLRequest = new URLRequest("http://www.helpexamples.com/flash/images/image1.jpg");
var sp:ScrollPane = new ScrollPane();
sp.setSize(180, 160);
sp.load(request);
addChild(sp);
refreshPane | () | 方法 |
public function refreshPane():void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會重新載入捲動窗格的內容。
此方法不會重新繪製捲軸。 若要重設捲軸,請使用 update() 方法。
相關 API 元素
範例 ( 如何使用本範例 )
refreshPane() 方法,將影像載入至 ScrollPane 組件實體,並重新整理窗格:
import fl.containers.ScrollPane;
import fl.controls.Button;
import fl.controls.TextArea;
var url:String = "http://www.helpexamples.com/flash/images/image2.jpg";
var myScrollPane:ScrollPane = new ScrollPane();
myScrollPane.setSize(320, 240);
myScrollPane.move(10, 10);
myScrollPane.load(new URLRequest(url));
myScrollPane.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myScrollPane.addEventListener(Event.COMPLETE, completeHandler);
addChild(myScrollPane);
var refreshButton:Button = new Button();
refreshButton.emphasized = true;
refreshButton.label = "refreshPane()";
refreshButton.move(myScrollPane.x + myScrollPane.width + 10, myScrollPane.y);
refreshButton.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(refreshButton);
var myTextArea:TextArea = new TextArea();
myTextArea.editable = false;
myTextArea.setSize(320, 120);
myTextArea.move(myScrollPane.x, myScrollPane.y + myScrollPane.height + 10);
addChild(myTextArea);
function progressHandler(event:ProgressEvent):void {
var bLoaded:int = event.bytesLoaded;
var bTotal:int = event.bytesTotal;
var pctLoaded:int = int(event.currentTarget.percentLoaded);
addText("progress (" + bLoaded + " of " + bTotal + " bytes loaded -- " + pctLoaded + "%)");
}
function completeHandler(event:Event):void {
addText("complete");
addText("----------");
}
function clickHandler(event:MouseEvent):void {
myScrollPane.refreshPane();
}
function addText(str:String):void {
myTextArea.appendText(str + "\n");
myTextArea.verticalScrollPosition = myTextArea.maxVerticalScrollPosition;
}
update | () | 方法 |
public function update():void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會根據內容的寬度和高度,重新整理捲軸屬性。 如果 ScrollPane 的內容會在執行階段變更,這就非常有用。
相關 API 元素
範例 ( 如何使用本範例 )
import fl.containers.ScrollPane;
import fl.controls.Button;
var baseURL:String = "http://www.helpexamples.com/flash/images/";
var img1Button:Button = new Button();
img1Button.label = "Image 1";
img1Button.move(10, 10);
img1Button.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(img1Button);
var img2Button:Button = new Button();
img2Button.label = "Image 2";
img2Button.move(10, 40);
img2Button.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(img2Button);
var img3Button:Button = new Button();
img3Button.label = "Image 3";
img3Button.move(10, 70);
img3Button.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(img3Button);
var myScrollPane:ScrollPane = new ScrollPane();
myScrollPane.setSize(320, 240);
myScrollPane.move(120, 10);
myScrollPane.addEventListener(Event.COMPLETE, completeHandler);
addChild(myScrollPane);
function clickHandler(event:MouseEvent):void {
switch (event.currentTarget) {
case img1Button:
myScrollPane.source = baseURL + "image1.jpg";
break;
case img2Button:
myScrollPane.source = baseURL + "image2.jpg";
break;
case img3Button:
myScrollPane.source = baseURL + "image3.jpg";
break;
}
}
function completeHandler(event:Event):void {
myScrollPane.update();
}
complete | 事件 |
flash.events.Event屬性 Event.type =
flash.events.Event.COMPLETE| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
當內容載入完成時傳送。
Event.COMPLETE 常數會定義 complete 事件物件的 type 屬性值。
這個事件具有下列屬性:
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false;沒有要取消的預設行為指令。 |
currentTarget | 正主動使用事件偵聽程式處理 Event 物件的物件。 |
target | 已完成載入的網路物件。 |
範例 ( 如何使用本範例 )
progress 和 complete 事件。一旦完成影像載入,就會調整 ScrollPane 大小 (使用 setSize() 方法)、將它置於舞台中央,並加入至顯示清單。
import fl.containers.ScrollPane;
import fl.controls.Label;
var url:String = "http://www.helpexamples.com/flash/images/image1.jpg";
var conversion:Number = 1024;
var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = "";
myLabel.move(10, 10);
addChild(myLabel);
var myScrollPane:ScrollPane = new ScrollPane();
myScrollPane.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myScrollPane.addEventListener(Event.COMPLETE, completeHandler);
myScrollPane.load(new URLRequest(url));
function progressHandler(event:ProgressEvent):void {
var bLoaded:int = int(event.bytesLoaded / conversion);
var bTotal:int = int(event.bytesTotal / conversion);
var pctLoaded:int = event.target.percentLoaded as int;
myLabel.text = bLoaded + " of " + bTotal + " (" + pctLoaded + "%)";
}
function completeHandler(event:Event):void {
var img:DisplayObject = myScrollPane.content;
myScrollPane.removeEventListener(ProgressEvent.PROGRESS, progressHandler);
myScrollPane.removeEventListener(Event.COMPLETE, completeHandler);
removeChild(myLabel);
myScrollPane.setSize(img.width, img.height);
var newX:uint = (stage.stageWidth - myScrollPane.width) / 2;
var newY:uint = (stage.stageHeight - myScrollPane.height) / 2;
myScrollPane.move(newX, newY);
addChild(myScrollPane);
}
相關 API 元素
init | 事件 |
flash.events.Event屬性 Event.type =
flash.events.Event.INIT| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
當您可以存取載入的 SWF 檔案的屬性和方法時傳送。 下列條件必須成立,才會傳送此事件:
- 所有與載入物件相關聯的屬性和方法,以及那些與組件相關聯的屬性和方法,都必須可供存取。
- 所有子物件的建構函式都必須已完成。
Event.INIT 常數會定義 init 事件物件的 type 屬性值。
這個事件具有下列屬性:
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false;沒有要取消的預設行為指令。 |
currentTarget | 正主動使用事件偵聽程式處理 Event 物件的物件。 |
target | 與所載入之 SWF 檔相關聯的 LoaderInfo 物件。 |
ioError | 事件 |
flash.events.IOErrorEvent屬性 IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
在發生輸入或輸出錯誤之後傳送。
定義ioError 事件物件的 type 屬性值。
這個事件具有下列屬性:
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false;沒有要取消的預設行為指令。 |
currentTarget | 正主動使用事件偵聽程式處理 Event 物件的物件。 |
errorID | 與特定錯誤相關聯的參考號碼 (僅限 AIR)。 |
target | 遭遇輸入/輸出錯誤的網路物件。 |
text | 要顯示為錯誤訊息的文字。 |
範例 ( 如何使用本範例 )
ioError 事件:
import fl.containers.UILoader;
var url:String = "http://www.helpexamples.com/flash/images/image404.jpg"
var myUILoader:UILoader = new UILoader();
myUILoader.load(new URLRequest(url));
myUILoader.move(10, 10);
myUILoader.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
addChild(myUILoader);
function ioErrorHandler(event:IOErrorEvent):void {
trace("<<", event.text, ">>");
myUILoader.removeEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
removeChild(myUILoader);
}
open | 事件 |
flash.events.Event屬性 Event.type =
flash.events.Event.OPEN| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
在網路作業開始之後傳送。
Event.OPEN 常數會定義 open 事件物件的 type 屬性值。
這個事件具有下列屬性:
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false;沒有要取消的預設行為指令。 |
currentTarget | 正主動使用事件偵聽程式處理 Event 物件的物件。 |
target | 已開啟連線的網路物件。 |
progress | 事件 |
flash.events.ProgressEvent屬性 ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
當內容正在載入時傳送。
定義progress 事件物件的 type 屬性值。
這個事件具有下列屬性:
| 屬性 | 值 |
|---|---|
bubbles | false |
bytesLoaded | 在偵聽程式處理事件時,載入的項目或位元組數目。 |
bytesTotal | 如果載入程序成功時,最終將載入的項目或位元組總數。 |
cancelable | false;沒有要取消的預設行為指令。 |
currentTarget | 正主動使用事件偵聽程式處理 Event 物件的物件。 |
target | 回報進度的物件。 |
範例 ( 如何使用本範例 )
progress 和 complete 事件,顯示 bytesLoaded、bytesTotal 和 percentLoaded 屬性:
import fl.containers.ScrollPane;
var url:String = "http://www.helpexamples.com/flash/images/image1.jpg";
var myScrollPane:ScrollPane = new ScrollPane();
myScrollPane.setSize(320, 240);
myScrollPane.move(10, 10);
myScrollPane.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myScrollPane.addEventListener(Event.COMPLETE, completeHandler);
myScrollPane.load(new URLRequest(url));
addChild(myScrollPane);
function progressHandler(event:ProgressEvent):void {
var bLoaded:int = event.bytesLoaded;
var bTotal:int = event.bytesTotal;
var pctLoaded:int = int(event.currentTarget.percentLoaded);
trace("progress: " + bLoaded + " of " + bTotal + " bytes loaded (" + pctLoaded + "%)");
}
function completeHandler(event:Event):void {
trace("complete:");
}
相關 API 元素
scroll | 事件 |
fl.events.ScrollEvent屬性 ScrollEvent.type =
fl.events.ScrollEvent.SCROLL| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
當使用者使用組件上的捲軸或滑鼠裝置上的滾輪捲動內容時傳送。
定義
scroll 事件物件的 type 屬性值。
這個事件具有下列屬性:
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false;沒有要取消的預設行為指令。 |
currentTarget | 正主動使用事件偵聽程式處理 Event 物件的物件。 |
delta | 1,指出捲動了多少距離的值。
|
direction | vertical,ScrollBar 的方向。 |
position | 0,捲軸縮圖移動後所在的位置。 |
target | 已經傳送該事件的物件。 此目標不一定是偵聽該事件的物件。 您可以使用 currentTarget 屬性,存取目前正在偵聽該事件的物件。 |
範例 ( 如何使用本範例 )
scroll 事件,並使用 ScrollEvent 類別的 direction 屬性,判斷是以水平或垂直方向捲動內容:
import fl.containers.ScrollPane;
import fl.events.ScrollEvent;
import fl.controls.ScrollBarDirection;
var myScrollPane:ScrollPane = new ScrollPane();
myScrollPane.scrollDrag = true;
myScrollPane.source = "http://www.helpexamples.com/flash/images/image1.jpg";
myScrollPane.addEventListener(ScrollEvent.SCROLL, scrollHandler);
addChild(myScrollPane);
function scrollHandler(event:ScrollEvent):void {
switch (event.direction) {
case ScrollBarDirection.HORIZONTAL:
trace("horizontal scroll", event.position, "of", event.currentTarget.maxHorizontalScrollPosition);
break;
case ScrollBarDirection.VERTICAL:
trace("vertical scroll", event.position, "of", event.currentTarget.maxVerticalScrollPosition);
break;
}
}
securityError | 事件 |
flash.events.SecurityErrorEvent屬性 SecurityErrorEvent.type =
flash.events.SecurityErrorEvent.SECURITY_ERROR| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
在載入內容期間發生了安全性錯誤時傳送。
SecurityErrorEvent.SECURITY_ERROR 常數會定義 securityError 事件物件的 type 屬性值。
這個事件具有下列屬性:
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false;沒有要取消的預設行為指令。 |
currentTarget | 正主動使用事件偵聽程式處理 Event 物件的物件。 |
target | 回報安全性錯誤的網路物件。 |
text | 要顯示為錯誤訊息的文字。 |
- 將影像
test.jpg與您的 FLA 放在相同的目錄中 (越大越好) - 將 ScrollPane 組件加入元件庫
- 將這個程式碼儲存成 ScrollPaneExample.as,並與您的 FLA 存放在相同的目錄中。
- 將 FLA 中的 DocumentClass 設定為 ScrollPaneExample。
注意:影像必須大於 ScrollPane (425x380),才能與此影像進行互動。由於點陣圖資料有最大尺寸的限制,所以影像的寬度和高度也必須小於 2880,才能讓影像顯示在預覽視窗中。
package
{
import flash.display.Sprite;
import flash.display.Shape;
import flash.display.MovieClip;
import flash.events.*;
import flash.geom.Rectangle;
import flash.display.Bitmap;
import flash.display.BitmapData;
import fl.containers.ScrollPane;
import fl.events.ScrollEvent;
public class ScrollPaneExample extends Sprite
{
private var sampleImagePath:String = "test.jpg";
private var sp:ScrollPane;
private var previewPositioner:Sprite;
private var windowSize:Number = 100;
private var box:Sprite;
public function ScrollPaneExample() {
stage.frameRate = 31;
createScrollPane();
}
private function createScrollPane():void {
sp = new ScrollPane();
sp.move(10,10);
sp.setSize(425,380);
sp.source = sampleImagePath;
sp.addEventListener(Event.COMPLETE,createPreviewWindow);
sp.addEventListener(ScrollEvent.SCROLL,repositionPreview);
sp.scrollDrag = true;
addChild(sp);
}
private function createPreviewWindow(e:Event):void {
var previewWindow:Sprite = new Sprite();
previewWindow.x = 445;
previewWindow.y = 10;
previewWindow.graphics.lineStyle(1,0,1);
previewWindow.graphics.drawRect(0,0,windowSize,windowSize);
addChild(previewWindow);
var bitmapData:BitmapData
try {
bitmapData = new BitmapData(sp.content.width,sp.content.height);
bitmapData.draw(sp.content);
var bitmap:Bitmap = new Bitmap(bitmapData);
bitmap.width = windowSize;
bitmap.height = windowSize;
bitmap.alpha = 0.25
previewWindow.addChild(bitmap);
}
catch (e:Error) {
trace(e.toString());
}
previewPositioner = new Sprite();
previewPositioner.graphics.beginFill(0xFFFFFF,0.5);
previewPositioner.graphics.lineStyle(1,0,0.5);
previewPositioner.graphics.drawRect(0,0,getHorizontalAspect() * windowSize, getVerticalAspect() * windowSize);
previewPositioner.addEventListener(MouseEvent.MOUSE_DOWN, dragPreviewPositioner);
previewPositioner.addEventListener(MouseEvent.MOUSE_UP, dropPreviewPositioner);
previewWindow.addChild(previewPositioner);
}
private function dragPreviewPositioner(e:MouseEvent):void {
var bounds:Rectangle = new Rectangle(0,0,windowSize - Math.floor(previewPositioner.width) + 1,windowSize - Math.floor(previewPositioner.height) + 1);
previewPositioner.startDrag(false,bounds);
previewPositioner.addEventListener(MouseEvent.MOUSE_MOVE, repositionScrollPane);
}
private function dropPreviewPositioner(e:MouseEvent):void {
previewPositioner.stopDrag();
previewPositioner.removeEventListener(MouseEvent.MOUSE_MOVE, repositionScrollPane);
}
private function repositionScrollPane(e:MouseEvent):void {
sp.horizontalScrollPosition = (previewPositioner.x / windowSize) * sp.content.width;
sp.verticalScrollPosition = (previewPositioner.y / windowSize) * sp.content.height;
}
private function repositionPreview(e:ScrollEvent):void {
previewPositioner.x = (sp.horizontalScrollPosition * windowSize) / sp.content.width;
previewPositioner.y = (sp.verticalScrollPosition * windowSize) / sp.content.height;
}
private function getHorizontalAspect():Number {
return sp.width / sp.content.width;
}
private function getVerticalAspect():Number {
return sp.height / sp.content.height;
}
}
}
Tue Jun 12 2018, 03:47 PM Z
隱藏繼承公用屬性
顯示繼承公用屬性