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 コントロールを使用して、ファイルコピー操作の進行状況を表示します。 この例では、 プロパティと プロパティを使用して、コピーするファイルの数と同じ の 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 します。 プロパティの値が変更された場合、コントロールの新しい範囲を反映するようにコントロール Maximum ProgressBar が再描画されます。 プロパティの値が Value プロパティの値と等しい場合は Maximum 、進行状況バーが完全に入力されます。

このプロパティを使用して、プロパティを設定する必要がある値を指定できます (プロパティを設定するか、 メソッドまたは メソッドを使用して)、操作が完了した Value Value Increment PerformStep かどうかを示します。 たとえば、 プロパティの値を、ファイルコピー操作のファイルの総数 Maximum に設定できます。 ファイルがコピーされるたび、ファイルの総数がコピーされるまで、 プロパティを Value 1 増やします。 その時点で、進行状況バーが完全に入力されます。

適用対象

こちらもご覧ください