ProgressBar.Maximum Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

ProgressBar.cs

Získá nebo nastaví maximální hodnotu rozsahu ovládacího prvku.

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

Hodnota vlastnosti

Int32

Maximální hodnota rozsahu. Výchozí hodnota je 100.

Výjimky

ArgumentException

Zadaná hodnota je menší než 0.

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. Příklad používá Minimum a Maximum vlastnosti k určení rozsahu, ProgressBar který odpovídá počtu souborů, které se mají kopírovat. Kód také používá Step vlastnost s metodou PerformStep ke zvýšení hodnoty ProgressBar jako souboru je zkopírována. Tento příklad vyžaduje, abyste měli ProgressBar vytvořený ovládací prvek, pBar1 který je vytvořen v rámci a Form že existuje vytvořená CopyFile metoda (která vrátí 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 že metoda je 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

Tato vlastnost určuje horní limit Value vlastnosti. Při změně hodnoty Maximum vlastnosti je ovládací prvek překreslen tak, ProgressBar aby odrážel nový rozsah ovládacího prvku. Pokud je hodnota Value vlastnosti rovna hodnotě Maximum vlastnosti, indikátor průběhu je zcela vyplněn.

Tuto vlastnost můžete použít k určení hodnoty, na kterou Value musí být vlastnost nastavena (nastavením Value vlastnosti nebo pomocí Increment metod PerformStep ) označující, že je operace dokončena. Můžete například nastavit hodnotu Maximum vlastnosti na celkový počet souborů v operaci kopírování souboru. Při každém zkopírování souboru může být vlastnost zvýšena o 1, Value dokud se nezkopíruje celkový počet souborů. V tomto okamžiku by byl indikátor průběhu zcela vyplněný.

Viz také

• Minimum
• Value