ProgressBar.Step ProgressBar.Step ProgressBar.Step ProgressBar.Step Property

정의

사용 되는 크기를 가져오거나에 대 한 호출을 PerformStep() 메서드는 진행률 표시줄의 현재 위치를 증가 합니다.Gets or sets the amount by which a call to the PerformStep() method increases the current position of the progress bar.

public:
 property int Step { int get(); void set(int value); };
public int Step { get; set; }
member this.Step : int with get, set
Public Property Step As Integer

속성 값

각 호출을 사용 하 여 진행률 표시줄이 증분되는 크기는 PerformStep() 메서드.The amount by which to increment the progress bar with each call to the PerformStep() method. 기본값은 10입니다.The default is 10.

예제

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

설명

사용할 수는 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.

적용 대상

추가 정보