ProgressBar.Maximum Tulajdonság

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

ProgressBar.cs

Lekéri vagy beállítja a vezérlőelem tartományának maximális értékét.

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

Tulajdonság értéke

Int32

A tartomány maximális értéke. Az alapértelmezett érték 100.

Kivételek

ArgumentException

A megadott érték kisebb, mint 0.

Példák

Az alábbi példakód egy vezérlővel ProgressBar jeleníti meg a fájlmásolási művelet előrehaladását. A példa a Minimum tulajdonságokat használva Maximum a másolandó fájlok számával egyenértékű tartományt ProgressBar ad meg. A kód a Step tulajdonságot is használja a PerformStep metódussal a fájl másolásának értékének ProgressBar növeléséhez. Ehhez a példához létre kell hoznia egy ProgressBar vezérlőelemet, amely egy pBar1 adott rendszeren belül jön létreForm, és hogy létre kell hozni egy metódust CopyFile (amely egy logikai értéket ad vissza, amely azt jelzi, hogy a fájlmásolási művelet sikeresen befejeződött), amely végrehajtja a fájlmásolási műveletet. A kód azt is megköveteli, hogy a másolandó fájlokat tartalmazó sztringek tömbje létrejön, és átadja a CopyWithProgress példában meghatározott metódusnak, és hogy a metódust a program meghívja egy másik metódusból vagy eseményből a Formpéldában.

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

Megjegyzések

Ez a tulajdonság a tulajdonság felső korlátját Value adja meg. A tulajdonság értékének Maximum módosításakor a ProgressBar vezérlő újrarajzolt lesz, hogy tükrözze a vezérlőelem új tartományát. Ha a Value tulajdonság értéke megegyezik a Maximum tulajdonság értékével, a folyamatjelző sáv teljesen ki van töltve.

Ezzel a tulajdonságtal megadhatja azt az értéket, amelyre a Value tulajdonságot be kell állítani (a Value tulajdonság beállításával vagy a IncrementPerformStep metódusok használatával), hogy jelezze, hogy a művelet befejeződött. Beállíthatja Maximum például a tulajdonság értékét a fájlmásolási műveletben lévő fájlok teljes számára. Minden alkalommal, amikor egy fájlt másolnak, a Value tulajdonság 1-tel növelhető, amíg a fájlok teljes száma ki nem másolódik. Ekkor a folyamatjelző sáv teljesen megtelt.

Lásd még

• Minimum
• Value