Object Hierarchy | 関連する C++クラス:ProgressBar
v3.0
プログレスバーは、処理時間が長い場合に横長の矩形内にカラーバーを表示して、その進捗状況を示すコントロールです。バー全体の長さに対するプログレスバーの長さは、完了した操作の比率に対応します。プログレスバーにはXSIUIToolkit.ProgressBarプロパティを使用してアクセスします。デフォルトの最小値と最大値は
1 のステップでそれぞれ0および100です。
警告:JScriptからProgressBar を使用する場合は、スクリプトの処理の完了後に、Visible プロパティを明示的に
False に設定する必要があります。他の言語では、ProgressBar
オブジェクトを参照しているすべてのローカル変数がスコープから外れるとすぐに、画面から自動的に
ProgressBar自体が削除されます。
注:プログレスバーの更新頻度は、1秒あたり数回までにしてください。それ以上頻繁になると、スクリプトの実行速度が遅くなる可能性があります。たとえば、アルゴリズムスキャニングの
1,000,000ベクトルは、各ベクトルでプログレスバーが更新される場合は、かなり遅くなります。
/* Demonstrates how to properly finish with the progress bar. */ var oProgressBar = XSIUIToolkit.ProgressBar ; oProgressBar.Maximum = 100 ; oProgressBar.Step = 1; oProgressBar.Caption = "Creating Nulls"; oProgressBar.CancelEnabled = true ; oProgressBar.Visible = true; while( oProgressBar.Value < oProgressBar.Maximum ) { Application.ActiveSceneRoot.AddNull() ; if ( oProgressBar.CancelPressed ) break ; oProgressBar.Increment() ; } // Make sure the progress bar disappears oProgressBar.Visible = false ; |
' ' Demonstrates the use of the progress bar in displaying percentage complete. ' dim oProgressBar set oProgressBar = XSIUIToolkit.ProgressBar oProgressBar.Maximum = 65535 oProgressBar.Step = 10 oProgressBar.CancelEnabled = true oProgressBar.Caption = "Processing" oProgressBar.Visible= true Do While oProgressBar.CancelPressed<>True And oProgressBar.Value < oProgressBar.Maximum oProgressBar.Increment Loop |
' ' Demonstrates the use of the progress bar in displaying progress per frame. ' dim oProgressBar set oProgressBar = XSIUIToolkit.ProgressBar oProgressBar.Maximum = 65535 oProgressBar.Visible= true Do While oProgressBar.CancelPressed<>True And oProgressBar.Value < oProgressBar.Maximum i = oProgressBar.Increment oProgressBar.StatusText = "Frame " & i Loop |