ProgressBar.Minimum Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Pobiera lub ustawia minimalną wartość zakresu kontrolki.

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

public int Minimum { get; set; }

member this.Minimum : int with get, set

Public Property Minimum As Integer

Wartość właściwości

Int32

Minimalna wartość zakresu. Wartość domyślna to 0.

Wyjątki

ArgumentException

Wartość określona dla właściwości 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 Formi ż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 metodzie 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

Uwagi

Ta właściwość określa niższy limit Value właściwości. Gdy wartość Minimum 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 Minimum właściwości, pasek postępu jest pusty. Aby zmienić wartość paska postępu, użyj Step właściwości z PerformStep metodą , użyj Increment metody lub ustaw wartość Value właściwości bezpośrednio.

Zobacz też

• Maximum
• Value