進度列 ProgressBar

顯示正在載入資源的進度,可搭配指定 UILoader 物件或 ScrollPane 物件的載入工作,顯示進度列。

ProgressBar 類別與物件 - fl.controls 套件

建構 ProgressBar 物件

從組件視窗將 ProgressBar 組件加入元件庫,
  1. import fl.controls.*;
  2. var pb:ProgressBar=new ProgressBar();
  3. pb.source=UILoader物件實體名稱的字串;
  4. addChild(pb);
另外,也可從組件視窗將 ProgressBar 組件放入舞台,為 ProgressBar 實體命名,並在組件檢測器視窗的參數標籤內指定 source 為 UILoader 實體及其它屬性。

ProgressBar 的屬性與方法

ProgressBar 繼承 UIComponent
[屬性]
source
  • 正在測量載入進度的參考內容,一般指定 UILoader 物件,也可是 ScrollPane 物件。
  • source:Object [讀寫] ,預設值為 null 。
  • pb.source=ldr // pb 物件顯示 ldr 物件的載入進度。
percentComplete
  • 表示已載入的百分比數 0 ~ 100 。
  • percentComplete:Number [唯讀] ,預設值為 0 。
  • lb.text=Math.floor(pb.percentComplete)+"%" // lb 物件顯示 pb 物件載入進行的百分比進度。
direction
  • 指定進度列的填色方向:
    • ProgressBarDirection.RIGHT :向右填滿進度列,此為預設值。
    • ProgressBarDirection.LEFT :向左填滿進度列。
  • direction:String [讀寫]
  • pb.direction=ProgressBarDirection.LEFT // pb 物件進度列向左填滿。
[方法]
reset()
  • 會重設進度列以進行新的載入作業。
  • public function reset():void
  • pb.reset() // 重設 pb 物件。
[事件]
complete
  • 代表載入工作完成時。
  • 建議使用 Event.COMPLETE 靜態常數代表。
progress
  • 代表載入工作進行時。
  • 建議使用 ProgressEvent.PROGRESS 靜態常數代表。