共用方式為


ProgressBar.Maximum 屬性

定義

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

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。

例外狀況

指定的值小於 0。

範例

下列程式碼範例會使用 ProgressBar 控制項來顯示檔案複製作業的進度。 此範例會使用 MinimumMaximum 屬性,指定要 ProgressBar 複製之 檔案數目的 範圍。 程式碼也會使用 Step 屬性搭配 PerformStep 方法,以複製檔案時遞增 的值 ProgressBar 。 此範例會要求您建立 ProgressBar 名為 pBar1 的控制項,該控制項是在 內 Form 建立,而且有一個稱為 CopyFile (建立的方法,會傳回 Boolean 值,指出檔案複製作業已順利完成,) 執行檔案複製作業。 程式碼也需要建立包含要複製之檔案的字串陣列,並傳遞至 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 上限。 當屬性的值 Maximum 變更時,控制項 ProgressBar 會重新繪製以反映控制項的新範圍。 當 屬性的值 Value 等於 屬性的值 Maximum 時,進度列會完全填滿。

您可以使用這個屬性來指定屬性必須設定 (的值 Value ,方法是設定 Value 屬性,或使用 IncrementPerformStep 方法) 來指出作業已完成。 例如,您可以將 屬性的值 Maximum 設定為檔案複製作業中的檔案總數。 每次複製檔案時, Value 屬性可以增加 1,直到複製檔案總數為止。 此時,進度列會完全填滿。

適用於

另請參閱