ProgressBar.Value プロパティ

プログレス バーの現在位置を取得または設定します。

Public Property Value As Integer
[C#]
public int Value {get; set;}
[C++]
public: __property int get_Value();public: __property void set_Value(int);
[JScript]
public function get Value() : int;public function set Value(int);

プロパティ値

プログレス バーの範囲内の位置。既定値は 0 です。

例外

例外の種類	条件
ArgumentException	指定された値が Maximum プロパティの値を超えます。 または 指定された値が Minimum プロパティの値未満です。

解説

Value プロパティの最小値および最大値は、 Minimum プロパティおよび Maximum プロパティで指定します。このプロパティを使用すると、プログレス バーの値を直接インクリメントまたはデクリメントできます。 ProgressBar コントロールの値を一定の量ずつ増やすには、 PerformStep メソッドで Step プロパティを使用します。プログレス バーの値を増分量を変化させて増やすには、 Increment メソッドを使用します。

使用例

[Visual Basic, C#, C++] Increment メソッドと Value プロパティを使用して、 Timer の Tick イベントで ProgressBar の値をインクリメントする例を次に示します。この例ではまた、 StatusBarPanel オブジェクトの Value プロパティを表示して、 ProgressBar をテキストでも表示しています。この例は、 progressBar1 という名前の ProgressBar コントロール、および statusBarPanel1 という名前の StatusBarPanel が配置された StatusBar コントロールがあることを前提にしています。time という名前の Timer オブジェクトはメンバとしてフォームに追加する必要があります。

 
Private time As New Timer()

' Call this method from the constructor of the form.
Private Sub InitializeMyTimer()
   ' Set the interval for the timer.
   time.Interval = 250
   ' Connect the Tick event of the timer to its event handler.
   AddHandler time.Tick, AddressOf IncreaseProgressBar
   ' Start the timer.
   time.Start()
End Sub


Private Sub IncreaseProgressBar(ByVal sender As Object, ByVal e As EventArgs)
   ' Increment the value of the ProgressBar a value of one each time.
   ProgressBar1.Increment(1)
   ' Display the textual value of the ProgressBar in the StatusBar control's first panel.
   statusBarPanel1.Text = ProgressBar1.Value.ToString() + "% Completed"
   ' Determine if we have completed by comparing the value of the Value property to the Maximum value.
   If ProgressBar1.Value = ProgressBar1.Maximum Then
      ' Stop the timer.
      time.Stop()
   End If
End Sub

[C#] 
private Timer time = new Timer();

// Call this method from the constructor of the form.
private void InitializeMyTimer()
{
   // Set the interval for the timer.
   time.Interval = 250;
   // Connect the Tick event of the timer to its event handler.
   time.Tick += new EventHandler(IncreaseProgressBar);
   // Start the timer.
   time.Start();
}

private void IncreaseProgressBar(object sender, EventArgs e)
{
   // Increment the value of the ProgressBar a value of one each time.
   progressBar1.Increment(1);
   // Display the textual value of the ProgressBar in the StatusBar control's first panel.
   statusBarPanel1.Text = progressBar1.Value.ToString() + "% Completed";
   // Determine if we have completed by comparing the value of the Value property to the Maximum value.
   if (progressBar1.Value == progressBar1.Maximum)
      // Stop the timer.
      time.Stop();
}

[C++] 
private:
   Timer* time;

   // Call this method from the constructor of the form.
   void InitializeMyTimer()
   {
      // Set the interval for the timer.
      time->Interval = 250;
      // Connect the Tick event of the timer to its event handler.
      time->Tick += new EventHandler(this, &Form1::IncreaseProgressBar);
      // Start the timer.
      time->Start();
   }

   void IncreaseProgressBar(Object* /*sender*/, EventArgs* /*e*/)
   {
      // Increment the value of the ProgressBar a value of one each time.
      progressBar1->Increment(1);
      // Display the textual value of the ProgressBar in the StatusBar control's first panel.
      statusBarPanel1->Text = String::Concat( __box(progressBar1->Value), S"% Completed" );
      // Determine if we have completed by comparing the value of the Value property to the Maximum value.
      if (progressBar1->Value == progressBar1->Maximum)
         // Stop the timer.
         time->Stop();
   }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

ProgressBar クラス | ProgressBar メンバ | System.Windows.Forms 名前空間 | Maximum | Minimum