ProgressBar.PerformStep ProgressBar.PerformStep ProgressBar.PerformStep ProgressBar.PerformStep Method

정의

양을 기준으로 진행률 표시줄의 현재 위치를 앞으로 이동 합니다 Step 속성입니다.Advances the current position of the progress bar by the amount of the Step property.

public:
 void PerformStep();
public void PerformStep ();
member this.PerformStep : unit -> unit
Public Sub PerformStep ()

예외

예제

다음 코드 예제에서는 ProgressBar 파일 복사 작업의 진행률을 표시 하는 컨트롤입니다.The following code example uses a ProgressBar control to display the progress of a file copy operation. 예제에서는 합니다 MinimumMaximum 속성에 대 한 범위를 지정 하는 ProgressBar 복사할 파일의 수에는 해당 합니다.The example uses the Minimum and Maximum properties to specify a range for the ProgressBar that is equivalent to the number of files to copy. 코드 또한 사용 하 여는 Step 속성을 PerformStep 값이 증가 하는 방법은 ProgressBar 파일이 복사 되는 대로.The code also uses the Step property with the PerformStep method to increment the value of the ProgressBar as a file is copied. 이 예제를 실행 하려면를 ProgressBar 라는 컨트롤 pBar1 내에서 만들어지는 Form, 및 메서드는 생성 호출 CopyFile (반환 하는 파일 복사 작업이 나타내는 부울 값을 성공적으로 완료) 파일 복사 작업을 수행 합니다.This example requires that you have a ProgressBar control created called pBar1 that is created within a Form, and that there is a method created called CopyFile (that returns a Boolean value indicating the file copy operation was completed successfully) that performs the file copy operation. 복사할 파일을 포함 하는 문자열의 배열을 생성 되어에 전달 되는 코드가 필요 합니다 CopyWithProgress 예제에서는 메서드를 정의 하 고 다른 메서드 또는 이벤트에서 메서드를 호출 하는 Form.The code also requires that an array of strings containing the files to copy is created and passed to the CopyWithProgress method defined in the example, and that the method is called from another method or event in the Form.

private:
   void CopyWithProgress( array<String^>^filenames )
   {
      // Display the ProgressBar control.
      pBar1->Visible = true;

      // Set Minimum to 1 to represent the first file being copied.
      pBar1->Minimum = 1;

      // Set Maximum to the total number of files to copy.
      pBar1->Maximum = filenames->Length;

      // Set the initial value of the ProgressBar.
      pBar1->Value = 1;

      // Set the Step property to a value of 1 to represent each file being copied.
      pBar1->Step = 1;

      // Loop through all files to copy.
      for ( int x = 1; x <= filenames->Length; x++ )
      {
         // Copy the file and increment the ProgressBar if successful.
         if ( CopyFile( filenames[ x - 1 ] ) == true )
         {
            // Perform the increment on the ProgressBar.
            pBar1->PerformStep();
         }
      }
   }
private void CopyWithProgress(string[] filenames)
{
	// Display the ProgressBar control.
	pBar1.Visible = true;
	// Set Minimum to 1 to represent the first file being copied.
	pBar1.Minimum = 1;
	// Set Maximum to the total number of files to copy.
	pBar1.Maximum = filenames.Length;
	// Set the initial value of the ProgressBar.
	pBar1.Value = 1;
	// Set the Step property to a value of 1 to represent each file being copied.
	pBar1.Step = 1;
	
	// Loop through all files to copy.
	for (int x = 1; x <= filenames.Length; x++)
	{
		// Copy the file and increment the ProgressBar if successful.
		if(CopyFile(filenames[x-1]) == true)
		{
			// Perform the increment on the ProgressBar.
			pBar1.PerformStep();
		}
	}
}
Private Sub CopyWithProgress(ByVal ParamArray filenames As String())
    ' Display the ProgressBar control.
    pBar1.Visible = True
    ' Set Minimum to 1 to represent the first file being copied.
    pBar1.Minimum = 1
    ' Set Maximum to the total number of files to copy.
    pBar1.Maximum = filenames.Length
    ' Set the initial value of the ProgressBar.
    pBar1.Value = 1
    ' Set the Step property to a value of 1 to represent each file being copied.
    pBar1.Step = 1

    ' Loop through all files to copy.
    Dim x As Integer
    for x = 1 To filenames.Length - 1
        ' Copy the file and increment the ProgressBar if successful.
        If CopyFile(filenames(x - 1)) = True Then
            ' Perform the increment on the ProgressBar.
            pBar1.PerformStep()
        End If
    Next x
End Sub

설명

PerformStep 하 여 지정 된 양만큼 진행률 표시줄의 값을 증가 하는 메서드는 Step 속성입니다.The PerformStep method increments the value of the progress bar by the amount specified by the Step property. 사용할 수는 Step 작업에서 완료 된 각 태스크 진행률 표시줄의 값을 변경 하는 시간을 지정 하는 속성입니다.You can use the Step property to specify the amount that each completed task in an operation changes the value of the progress bar. 예를 들어, 파일 그룹을 복사 하는 경우 하려는 값을 설정 합니다 Step 속성의 값과 1을는 Maximum 속성을 복사할 파일의 총 수입니다.For example, if you are copying a group of files, you might want to set the value of the Step property to 1 and the value of the Maximum property to the total number of files to copy. 호출할 수 있습니다 각 파일이 복사 되는 경우는 PerformStep 값을 기준으로 진행률 표시줄을 증가 하는 방법의 Step 속성입니다.When each file is copied, you can call the PerformStep method to increment the progress bar by the value of the Step property. 사용할 수 있는 진행률 표시줄의 값 보다 유연 하 게 제어 하려는 경우는 Increment 메서드의 값을 가져오거나 설정 합니다 Value 속성을 직접.If you want to have more flexible control of the value of the progress bar, you can use the Increment method or set the value of the Value property directly.

합니다 Value 속성의 현재 위치를 지정 된 ProgressBar합니다.The Value property specifies the current position of the ProgressBar. 호출한 후를 PerformStep 메서드를를 Value 속성의 값 보다 큽니다.를 Maximum 속성을 Value 속성의 값으로 유지 됩니다는 Maximum 속성.If, after calling the PerformStep method, the Value property is greater than the value of the Maximum property, the Value property remains at the value of the Maximum property. 호출한 후는 PerformStep 에 지정 된 음수 값을 사용 하 여 메서드 Step, Value 속성의 값 보다 작습니다를 Minimum 속성을 Value 속성의 값으로 유지 됩니다는 Minimum 속성 .If, after calling the PerformStep method with a negative value specified in Step, the Value property is less than the value of the Minimum property, the Value property remains at the value of the Minimum property.

때문에 ProgressBar 해당 스타일으로 설정 되어 개체 Marquee 대신 지속적으로 스크롤 막대를 표시 해당 Value를 호출 PerformStep 필요 하지 않으며 발생는 InvalidOperationException.Because a ProgressBar object whose style is set to Marquee displays a continuously scrolling bar instead of its Value, calling PerformStep is unnecessary and will raise an InvalidOperationException.

적용 대상

추가 정보