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 コントロールを使用して、ファイルコピー操作の進行状況を表示します。 この例では、 プロパティと プロパティを使用して、コピーするファイルの数と同じ の 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 します。 プロパティの値が変更された場合、コントロールの新しい範囲を反映するようにコントロール Minimum ProgressBar が再描画されます。 プロパティの値が Value プロパティの値と等しい場合、 Minimum 進行状況バーは空になります。 進行状況バーの値を変更するには、 メソッドで プロパティを使用するか、 メソッドを使用するか、 プロパティの値 Step PerformStep Increment を直接 Value 設定します。

適用対象

こちらもご覧ください