| メソッド | プロパティ | エフェクト | イベント | スタイル | 例 | フレームあり | フレームなし |
ProgressBar コントロールは、処理の進行状況を視覚的に表現します。ProgressBar コントロールには、有限および無限の 2 つの種類があります。
有限の ProgressBar コントロールでは、処理の進行状況を時間経過に沿って直線的に表現します。処理の量について見通しが立つ場合は有限の ProgressBar を使用し、ユーザーをしばらくの間待たせる必要があることを示します。
無限の ProgressBar コントロールでは、量の見通しが立たない処理の進行状況を時間ベースで表現します。見通しが立つようになり次第、有限の ProgressBar コントロールを使用することをお勧めします。
他のコントロールとは異なり、ProgressBar コントロールでは、UIComponent ではなく UIObject クラスを直接継承しています。
MXML シンタックス
<mx:ProgressBar> タグは、UIObject のすべてのプロパティを継承し、次のプロパティを追加します。
<mx:ProgressBar例を参照するにはここをクリックしてください
conversion=""
direction="right|left"
indeterminate="false|true"
label="No default."
labelPlacement="bottom|top|left|right|center"
maximum="0"
minimum="0"
mode="event|polled|manual"
source="No default."
trackColors="[0xE6EEEE,0xE6EEEE]"
complete="Event handler; no default."
progress="Event handler; no default."
/>
| コンストラクタ | |
ProgressBar ( )
コンストラクタです。 |
|
| メソッド | |
| setProgress( completed:Number, total:Number)
: Void manual モードを使用している場合に、現時点での進行量を反映するようバーの状態を設定します。 |
| プロパティ | |
| className:Stringこのクラスの名前です。 |
| conversion:Number 現時点でのロード済みバイト数とコンテンツ全体のバイト数を変換するために使われる数値です。 |
| direction:String ProgressBar の塗りつぶしが伸びる進行方向です。 |
| indeterminate:Boolean ProgressBar コントローラの外観が有限か無限かを示します。 |
| label:String プログレスバーに付加されるテキストです。 |
| labelPlacement:String ラベルの配置です。 |
| maximum:Number ProgressBar の進行状況の最大値です。 |
| minimum:Number ProgressBar の進行状況の最小値です。 |
| mode:String モードです。event、polled、または manual のいずれかです。 |
| percentComplete:Number
[読み取り専用]
処理が完了した割合です。 |
| source:Object ProgressBar で進行状況を測定する対象のコントロールを参照します。 |
| value:Number
[読み取り専用]
現時点での進行量を示す読み取り専用プロパティです。値は、最小値と最大値の間の範囲になります。 |
static | version:Stringこのクラスのバージョンを表すストリングです。 |
| エフェクト |
| mx.core.UIObject クラスから継承されるエフェクト |
creationCompleteEffect hideEffect mouseDownEffect mouseOutEffect mouseOverEffect mouseUpEffect moveEffect resizeEffect showEffect |
| イベント | |
complete | ロードが完了したときにブロードキャストします。このイベントオブジェクトには、次のプロパティが含まれます。
|
hide | オブジェクトの状態が可視から不可視に変化したときにブロードキャストします。 このイベントオブジェクトの target プロパティには、イベントをトリガしたコンポーネントへの参照が含まれます。type イベントの名前 hide が含まれます。 |
progress | event モードまたは polled モードの場合に、コンテンツのロード中にブロードキャストします。このイベントオブジェクトには、次のプロパティが含まれます。
|
show | コンポーネントが表示されたときにブロードキャストします。このイベントオブジェクトの target プロパティには、イベントをトリガしたコンポーネントへの参照が含まれます。type イベントの名前 show が含まれます。 |
| スタイル | |
themeColor | 型 : Number 形式 : Color CSS の継承 : ありProgressBar コントロールのテーマカラーです。指定できる値は、haloGreen、haloBlue、および haloOrange です。themeColor スタイルは個々のコントロールではなく <mx:Application> タグで設定することをお勧めします。 |
trackColors | 型 : Array CSS の継承 : なし2 色の配列としてトラックの色を指定します。単色のトラックの場合は同じ色を 2 回使用できます。デフォルト値は [0xE6EEEE,0xE6EEEE] です。 |
| mx.core.UIObject クラスから継承されるスタイル |
color fontFamily fontSize fontStyle fontWeight horizontalGap leading marginLeft marginRight textAlign textDecoration textIndent verticalGap |
| コンストラクタの詳細 |
ProgressBar( )
| メソッドの詳細 |
setProgress( completed:Number, total:Number)
: Void
completed 引数は value プロパティに、total 引数は maximum プロパティに割り当てられます。minimum プロパティは変更されません。
パラメータ
completed:Number - 現在の値です。
total:Number - 合計値または目標値です。
| プロパティの詳細 |
className:String
conversion:Number
1 で、変換しないことを意味します。
direction:String
right および left です。デフォルト値は right です。
indeterminate:Boolean
true の場合、無限の外観が使用されます。デフォルト値は false です。
label:String
labelPlacement:String
top、bottom、left、right、および center です。デフォルト値は bottom です。
maximum:Number
0 です。
minimum:Number
mode:String
event、polled、または manual のいずれかです。デフォルト値は event です。
percentComplete:Number [読み取り専用]
setProgress() メソッドを使用します。
source:Object
value:Number [読み取り専用]
static version:String
| 例 |
| SimpleProgressBar.mxml |
|