ProgressBar.Step 屬性

定義

取得或設定數量,以其做為呼叫 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

屬性值

Int32

每次呼叫 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 以便在複製檔案時遞增的值 ProgressBarThe 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 範例中所定義的方法,並且從中的另一個方法或事件呼叫該方法 FormThe 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 方法,以屬性的值遞增進度列 StepWhen each file is copied, you can call the PerformStep method to increment the progress bar by the value of the Step property. 如果您想要更有彈性地控制進度列的值,您可以使用 Increment 方法或直接設定屬性的值 ValueIf 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.

適用於

另請參閱