共用方式為


ProgressBar.Minimum 屬性

定義

取得或設定控制項範圍的最小值。

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

屬性值

Int32

範圍的最小值。 預設值是 0。

例外狀況

這個屬性的指定值小於 0。

範例

下列程式碼範例會使用 ProgressBar 控制項來顯示檔案複製作業的進度。 此範例會使用 MinimumMaximum 屬性,指定要 ProgressBar 複製之 檔案數目的 範圍。 程式碼也會使用 Step 屬性搭配 PerformStep 方法,以複製檔案時遞增 的值 ProgressBar 。 此範例會要求您建立 ProgressBar 名為 pBar1Form 控制項,該控制項是在 內建立,而且有一個稱為 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 下限。 當屬性的值 Minimum 變更時,控制項 ProgressBar 會重新繪製以反映控制項的新範圍。 當 屬性的值 Value 等於 屬性的值 Minimum 時,進度列會是空的。 若要變更進度列的值,請使用 Step 屬性搭配 PerformStep 方法、使用 Increment 方法,或直接設定 屬性的值 Value

適用於

另請參閱