ProgressBar.Maximum Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Возвращает или задает наибольшее значение диапазона этого элемента управления.

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

Значение свойства

Int32

Наибольшее значение диапазона. Значение по умолчанию — 100.

Исключения

ArgumentException

Заданное значение меньше 0.

Примеры

В следующем примере кода используется ProgressBar элемент управления для отображения хода выполнения операции копирования файлов. В примере используются Minimum свойства и Maximum свойства для указания диапазона, ProgressBar эквивалентного количеству копируемого файла. Код также использует Step свойство с методом PerformStep для увеличения значения ProgressBar файла в виде файла. В этом примере требуется, чтобы в ProgressBar элементе управления был создан вызов pBar1 , созданный методом Form CopyFile (который возвращает логическое значение, указывающее на успешное завершение операции копирования файлов), выполняющего операцию копирования файлов. Код также требует, чтобы массив строк, содержащих файлы для копирования, был создан и передан CopyWithProgress в метод, определенный в примере, и что метод вызывается из другого метода или события в .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

Комментарии

Это свойство задает верхний предел Value свойства. При изменении ProgressBar значения свойства Maximum элемент управления перерисовывается в соответствии с новым диапазоном элемента управления. Если значение Value свойства равно значению Maximum свойства, индикатор выполнения заполняется полностью.

Это свойство можно использовать для указания значения, для которого Value свойство должно быть задано (путем задания Value свойства или методов Increment PerformStep ), чтобы указать, что операция завершена. Например, можно задать для свойства Maximum общее количество файлов в операции копирования файлов. При каждом копировании Value файла свойство может увеличиваться на 1, пока не будет скопировано общее количество файлов. На этом этапе индикатор выполнения будет полностью заполнен.

См. также раздел

• Minimum
• Value