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 |