ProgressBar.Increment メソッド

指定した量だけプログレス バーの現在位置を進めます。

Public Sub Increment( _
   ByVal value As Integer _)
[C#]
public void Increment(intvalue);
[C++]
public: void Increment(intvalue);
[JScript]
public function Increment(
   value : int);

パラメータ

• value
  プログレス バーの現在位置をインクリメントする量。

解説

Increment メソッドを使用すると、指定した量だけプログレス バーの値をインクリメントできます。このメソッドによるプログレス バーのインクリメントは、 PerformStep メソッドで Step プロパティを使用する方法と似ています。 Value プロパティは、 ProgressBar の現在位置を指定します。 Increment メソッドを呼び出した後で、 Value プロパティが Maximum プロパティの値を超える場合、 Value プロパティは Maximum プロパティの値のままになります。value パラメータに負の値を指定して Increment メソッドを呼び出した後に、 Value プロパティが Minimum プロパティの値未満の場合、 Value プロパティは Minimum プロパティの値のままになります。

使用例

[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 ファミリ

参照

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