ProgressBar.Step Eigenschap

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

Waarde van eigenschap

Het bedrag waarmee de voortgangsbalk moet worden verhoogd met elke aanroep naar de PerformStep() methode. De standaardwaarde is 10.

Voorbeelden

In het volgende codevoorbeeld wordt een ProgressBar besturingselement gebruikt om de voortgang van een bestandskopiebewerking weer te geven. In het voorbeeld worden de Minimum en Maximum eigenschappen gebruikt om een bereik op te geven dat ProgressBar gelijk is aan het aantal bestanden dat moet worden gekopieerd. De code maakt ook gebruik van de Step eigenschap met de PerformStep methode om de waarde van het ProgressBar bestand te verhogen als een bestand wordt gekopieerd. Voor dit voorbeeld is vereist dat u een ProgressBar besturingselement hebt gemaakt pBar1 dat is gemaakt in een Form, en dat er een methode is gemaakt met de naam CopyFile (die een Booleaanse waarde retourneert die aangeeft dat de bewerking voor het kopiëren van bestanden is voltooid) waarmee de bewerking voor het kopiëren van bestanden wordt uitgevoerd. De code vereist ook dat een matrix met tekenreeksen met de te kopiëren bestanden wordt gemaakt en doorgegeven aan de CopyWithProgress methode die in het voorbeeld is gedefinieerd, en dat de methode wordt aangeroepen vanuit een andere methode of gebeurtenis in de 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

Opmerkingen

U kunt de Step eigenschap gebruiken om het bedrag op te geven dat elke voltooide taak in een bewerking de waarde van de voortgangsbalk wijzigt. Als u bijvoorbeeld een groep bestanden kopieert, kunt u de waarde van de Step eigenschap instellen op 1 en de waarde van de Maximum eigenschap op het totale aantal te kopiëren bestanden. Wanneer elk bestand wordt gekopieerd, kunt u de PerformStep methode aanroepen om de voortgangsbalk te verhogen op basis van de waarde van de Step eigenschap. Als u flexibeler controle wilt over de waarde van de voortgangsbalk, kunt u de Increment methode gebruiken of de waarde van de Value eigenschap rechtstreeks instellen.

Zie ook

• PerformStep()
• Value
• Increment(Int32)