ProgressBar.Maximum Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Pobiera lub ustawia maksymalną wartość zakresu kontrolki.

public:
 property int Maximum { int get(); void set(int value); };

public int Maximum { get; set; }

member this.Maximum : int with get, set

Public Property Maximum As Integer

Wartość właściwości

Int32

Maksymalna wartość zakresu. Wartość domyślna to 100.

Wyjątki

ArgumentException

Określona wartość jest mniejsza niż 0.

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 Form i ż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 Formobiekcie .

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

Ta właściwość określa górny limit Value właściwości. Gdy wartość Maximum właściwości zostanie zmieniona, kontrolka ProgressBar zostanie ponownie narysowana, aby odzwierciedlić nowy zakres kontrolki. Gdy wartość Value właściwości jest równa wartości Maximum właściwości, pasek postępu jest całkowicie wypełniony.

Za pomocą tej właściwości można określić wartość, do której Value należy ustawić właściwość (ustawiając Value właściwość lub przy użyciu Increment metod lub PerformStep ), aby wskazać, że operacja została ukończona. Można na przykład ustawić wartość Maximum właściwości na całkowitą liczbę plików w operacji kopiowania plików. Za każdym razem, gdy plik jest kopiowany, Value właściwość można zwiększyć o 1 do momentu skopiowania całkowitej liczby plików. W tym momencie pasek postępu zostanie całkowicie wypełniony.

Zobacz też

• Minimum
• Value