ProgressBar.Maximum Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

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. 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ý pBar1 ovládací prvek, který se vytvoří v rámci Form objektu a že je vytvořená metoda CopyFile (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 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

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 operace je 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 nekopíruje celkový počet souborů. V tomto okamžiku by byl indikátor průběhu zcela vyplněný.

Viz také

• Minimum
• Value