ProgressBar.Step Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Źródło:

ProgressBar.cs

Pobiera lub ustawia kwotę, o jaką wywołanie PerformStep() metody zwiększa bieżącą pozycję paska postępu.

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

Wartość właściwości

Int32

Wartość, o jaką ma być zwiększany pasek postępu przy każdym wywołaniu PerformStep() metody. Wartość domyślna to 10.

Przykłady

Poniższy przykład kodu używa ProgressBar kontrolki do wyświetlania postępu operacji kopiowania plików. W przykładzie użyto Minimum właściwości i Maximum w celu określenia zakresu odpowiadającego ProgressBar liczbie plików do skopiowania. Kod używa Step również właściwości z PerformStep metodą , aby zwiększać wartość ProgressBar elementu jako plik jest kopiowany. W tym przykładzie jest ProgressBar wymagana utworzona kontrolka o nazwie pBar1 , która została utworzona w obiekcie Formi że istnieje utworzona metoda o nazwie CopyFile (która zwraca wartość logiczną wskazującą, że operacja kopiowania pliku została ukończona pomyślnie), która wykonuje operację kopiowania plików. Kod wymaga również, aby tablica ciągów zawierających pliki do skopiowania została utworzona i przekazana do CopyWithProgress metody zdefiniowanej w przykładzie oraz że metoda jest wywoływana z innej metody lub zdarzenia w metodzie 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 ] ))
         {
            // 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]))
        {
            // 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

Uwagi

Możesz użyć Step właściwości , aby określić ilość, jaką każde ukończone zadanie w operacji zmienia wartość paska postępu. Jeśli na przykład kopiujesz grupę plików, możesz ustawić wartość Step właściwości na 1, a wartość Maximum właściwości na całkowitą liczbę plików do skopiowania. Po skopiowaniu każdego pliku można wywołać metodę PerformStep , aby zwiększać pasek postępu przez wartość Step właściwości . Jeśli chcesz mieć bardziej elastyczną kontrolę nad wartością paska postępu, możesz użyć Increment metody lub ustawić wartość Value właściwości bezpośrednio.

Zobacz też

• PerformStep()
• Value
• Increment(Int32)