次の方法で共有


ProgressBar コントロールの概要 (Windows フォーム)

重要

ToolStripProgressBar コントロールは、ProgressBar コントロールに代わって機能を追加します。ただし、ProgressBar コントロールは、下位互換性と将来の使用の両方で保持されます (選択した場合)。

Windows フォーム ProgressBar コントロールは、水平方向のバーに配置された適切な数の四角形を表示することで、プロセスの進行状況を示します。 プロセスが完了すると、バーがいっぱいになります。 進行状況バーは、プロセスが完了するまでの待ち時間をユーザーに知るために一般的に使用されます。たとえば、大きなファイルが読み込まれている場合などです。

ProgressBar コントロールは、フォーム上でのみ水平方向に配置できます。

主要なプロパティとメソッド

ProgressBar コントロールの主要なプロパティは、ValueMinimum、および Maximumです。 Minimum プロパティと Maximum プロパティは、進行状況バーに表示できる最大値と最小値を設定します。 Value プロパティは、操作の完了に向けた進行状況を表します。 コントロールに表示されるバーはブロックで構成されているため、ProgressBar コントロールによって表示される値は、Value プロパティの現在の値のみを近似します。 ProgressBar コントロールのサイズに基づいて、Value プロパティによって、次のブロックを表示するタイミングが決まります。

現在の進行状況の値を更新する最も一般的な方法は、Value プロパティを設定するコードを記述することです。 大きなファイルを読み込む例では、ファイルの最大サイズを KB 単位で設定できます。 たとえば、Maximum プロパティが 100 に設定されている場合、Minimum プロパティは 10 に設定され、Value プロパティは 50 に設定され、5 つの四角形が表示されます。 これは、表示できる数値の半分です。

ただし、ProgressBar プロパティを直接設定する以外にも、Value コントロールによって表示される値を変更する方法は他にもあります。 Step プロパティを使用して、Value プロパティをインクリメントする値を指定できます。 次に、PerformStep メソッドを呼び出すと、値がインクリメントされます。 インクリメント値を変更するには、Increment メソッドを使用し、Value プロパティをインクリメントする値を指定します。

現在のアクションについてユーザーにグラフィカルに通知するもう 1 つのコントロールは、StatusBar コントロールです。

重要

StatusStrip コントロールと ToolStripStatusLabel コントロールは、StatusBar コントロールと StatusBarPanel コントロールに機能を置き換えて追加します。ただし、StatusBar コントロールと StatusBarPanel コントロールは、下位互換性と将来の使用の両方で保持されます (選択した場合)。

こちらも参照ください