ProgressBar.Step Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

ProgressBar.cs

Získá nebo nastaví částku, o kterou volání PerformStep() metody zvyšuje aktuální pozici indikátoru průběhu.

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

Hodnota vlastnosti

Int32

Množství, o které se má zvýšit indikátor průběhu při každém volání PerformStep() metody. Výchozí hodnota je 10.

Příklady

Následující příklad kódu používá ovládací prvek ProgressBar k zobrazení průběhu operace kopírování souboru. Příklad používá Minimum vlastnosti a Maximum k určení rozsahu ProgressBar , který odpovídá počtu souborů ke kopírování. Kód také používá Step vlastnost s metodou PerformStep ke zvýšení hodnoty ProgressBar souboru při kopírování souboru. Tento příklad vyžaduje, abyste vytvořili ProgressBar ovládací prvek s názvem pBar1 , který je vytvořen v rámci Forma že existuje metoda s názvem CopyFile (která vrací logickou hodnotu označující, že operace kopírování souboru byla úspěšně dokončena), která provádí operaci kopírování souboru. Kód také vyžaduje, aby bylo vytvořeno pole řetězců obsahujících soubory ke kopírování a předáno CopyWithProgress metodě definované v příkladu a aby byla metoda volána z jiné metody nebo události v objektu 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

Poznámky

Vlastnost můžete použít Step k určení množství, které každý dokončený úkol v operaci změní hodnotu indikátoru průběhu. Pokud například kopírujete skupinu souborů, můžete chtít nastavit hodnotu Step vlastnosti na hodnotu 1 a hodnotu Maximum vlastnosti na celkový počet souborů, které chcete zkopírovat. Při kopírování každého souboru můžete volat metodu PerformStep pro zvýšení indikátoru průběhu o hodnotu Step vlastnosti. Pokud chcete mít flexibilnější kontrolu nad hodnotou indikátoru průběhu, můžete použít metodu Increment nebo nastavit hodnotu Value vlastnosti přímo.

Viz také

• PerformStep()
• Value
• Increment(Int32)