Sdílet prostřednictvím

ProgressBar.PerformStep Metoda

  • Reference

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll

Posune aktuální pozici indikátoru průběhu o velikost Step vlastnosti.

public:
 void PerformStep();
public void PerformStep ();
member this.PerformStep : unit -> unit
Public Sub PerformStep ()

Výjimky

InvalidOperationException

Style je nastavena na Marqueehodnotu .

Příklady

Následující příklad kódu používá ProgressBar ovládací prvek k zobrazení průběhu operace kopírování souboru. V příkladu se Minimum používají vlastnosti a Maximum určuje rozsah, ProgressBar který odpovídá počtu souborů, které se mají zkopírovat. Kód také používá Step vlastnost s metodou PerformStep zvýšit hodnotu ProgressBar jako soubor je zkopírován. Tento příklad vyžaduje, ProgressBar abyste měli vytvořený ovládací prvek, který je vytvořen pBar1 v rámci objektu Form, a že existuje metoda vytvořená 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 byla vytvořena pole řetězců obsahujících soubory ke kopírování a předáno CopyWithProgress metodě definované v příkladu a že metoda je volána z jiné metody nebo události v .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

Poznámky

Metoda PerformStep zvýší hodnotu indikátoru průběhu o množství určené vlastností Step . 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 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 hodnotou 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.

Vlastnost Value určuje aktuální pozici ProgressBar. Pokud je po volání PerformStep metody Value vlastnost větší než hodnota Maximum vlastnosti, Value vlastnost zůstává na hodnotě Maximum vlastnosti. Pokud po volání PerformStep metody se zápornou hodnotou zadanou v Step, Value vlastnost je menší než hodnota Minimum vlastnosti, Value vlastnost zůstává na hodnotě Minimum vlastnosti.

Vzhledem k tomu, ProgressBar že objekt, jehož styl je nastaven tak, aby Marquee zobrazoval nepřetržitě posuvník místo jeho Value, volání PerformStep je zbytečné a vyvolá .InvalidOperationException

Platí pro

Viz také