ProgressBar.Increment 메서드

진행률 표시줄의 현재 위치를 지정된 크기만큼 진행합니다.

네임스페이스: System.Windows.Forms
어셈블리: System.Windows.Forms(system.windows.forms.dll)

구문

‘선언
Public Sub Increment ( _
    value As Integer _
)
‘사용 방법
Dim instance As ProgressBar
Dim value As Integer

instance.Increment(value)

public void Increment (
    int value
)

public:
void Increment (
    int value
)

public void Increment (
    int value
)

public function Increment (
    value : int
)

매개 변수

• value
  진행률 표시줄의 현재 위치를 증분시킬 크기입니다.

예외

예외 형식	조건
InvalidOperationException	Style 속성이 Marquee로 설정된 경우

설명

Increment 메서드를 사용하면 진행률 표시줄의 값을 지정된 크기만큼 증분시킬 수 있습니다. 이러한 진행률 표시줄 증분 방법은 PerformStep 메서드와 함께 Step 속성을 사용하는 방법과 비슷합니다. Value 속성은 ProgressBar의 현재 위치를 지정합니다. Increment 메서드를 호출한 후 Value 속성이 Maximum 속성 값보다 크면 Value 속성이 Maximum 속성의 값으로 유지됩니다. Increment 메서드를 value 매개 변수에 지정된 음수 값으로 호출한 후 Value 속성이 Minimum 속성 값보다 작으면 Value 속성이 Minimum 속성 값으로 유지됩니다.

예제

다음 코드 예제에서는 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

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();
}

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 += gcnew 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( progressBar1->Value, "% 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();
   }

private Timer time = new Timer();

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

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.set_Text(progressBar1.get_Value() + "% Completed");
    // Determine if we have completed by comparing the value of the Value
    // property to the Maximum value.
    if (progressBar1.get_Value() == progressBar1.get_Maximum()) {
        // Stop the timer.
        time.Stop();
    }        
} //IncreaseProgressBar

플랫폼

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

참고 항목

참조

ProgressBar 클래스
ProgressBar 멤버
System.Windows.Forms 네임스페이스
Maximum
Minimum
Value
Step
PerformStep