ProgressBar.PerformStep Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Przesuwa bieżącą pozycję paska postępu o ilość Step właściwości.

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

Wyjątki

InvalidOperationException

Style parametr jest ustawiony na Marqueewartość .

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 ] ) == 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

Uwagi

Metoda PerformStep zwiększa wartość paska postępu o kwotę określoną przez Step właściwość . 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.

Właściwość Value określa bieżące położenie obiektu ProgressBar. Jeśli po wywołaniu PerformStep metody Value właściwość jest większa niż wartość Maximum właściwości, Value właściwość pozostaje na wartości Maximum właściwości . Jeśli po wywołaniu PerformStep metody z wartością ujemną określoną w Stepobiekcie Value właściwość jest mniejsza niż wartość Minimum właściwości, Value właściwość pozostaje na wartości Minimum właściwości .

ProgressBar Ponieważ obiekt, którego styl jest ustawiony tak, aby Marquee wyświetlał pasek ciągłego przewijania zamiast , Valuewywołanie PerformStep metody jest niepotrzebne i zgłosi błąd InvalidOperationException.

Dotyczy

Zobacz też